No description
  • TypeScript 83%
  • CSS 17%
Find a file
2026-04-16 13:34:10 -06:00
.husky chore: initial repo config 2025-08-12 12:24:49 -06:00
.vscode chore: update dependencies 2026-04-16 12:33:41 -06:00
dist feat: replaceRandom slash command 2026-04-16 13:34:10 -06:00
src feat: replaceRandom slash command 2026-04-16 13:34:10 -06:00
types feat: build system 2025-08-13 12:21:20 -06:00
.gitignore chore: initial repo config 2025-08-12 12:24:49 -06:00
.lintstagedrc.json chore: initial repo config 2025-08-12 12:24:49 -06:00
biome.json chore: update dependencies 2026-04-16 12:33:41 -06:00
bun.lock chore: update dependencies 2026-04-16 12:33:41 -06:00
commitlint.config.ts feat: build system 2025-08-13 12:21:20 -06:00
manifest.json feat: build system 2025-08-13 12:21:20 -06:00
package.json chore: update dependencies 2026-04-16 12:33:41 -06:00
README.md feat: replaceRandom slash command 2026-04-16 13:34:10 -06:00
tsconfig.json feat: build system 2025-08-13 12:21:20 -06:00

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.