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.

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. 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.