st-randomness-helpers

st-randomness-helpers is a extension for SillyTavern.

Features

WordLists

WordList are plaintext files containing one or more words per line. The name of the file is the name of the WordList.

Macros

Register macros that are usually replaced with a value at save time.

Placeholders

Placeholders are strings that are replaced with a value at generation time.

Slash Commands

Register slash commands that are used for scripting.

/replaceRandom (alias: /randomReplace)

Replace placeholders in the provided text with random values. This command processes all supported placeholder types in a single operation. Example: /replaceRandom I have a %%RandomWord:PetSpecies%% myself

Services

RandomWord

Get a random word from a WordList. can be used as a Macro or a Placeholder. Macro format: {{RandomWord::WordListName}}. Placeholder format: %%RandomWord:WordListName%%.

Shuffle

Shuffle a list of values. can be used as Placeholder only. Macro format: {{Shuffle::Value1::Value2::Value3;;separator}}. Placeholder format: %%Shuffle::Value1::Value2::Value3;;separator%%. Example: %%Shuffle::Value1::Value2::Value3;;, %% will return Value3, Value1, Value2.

Pick

Pick a random value from a list of values. can be used as Placeholder only. Placeholder format: %%Pick::Value1::Value2::Value3%%. Example: %%Pick::Red::Blue::Green%% will return one of Red, Blue, or Green randomly.