Command Reference · Player Manual
Player command manual
The full reference for dice, checks, character sheets and Keeper commands. Commands start with . (also 。 or /) and come in two dialects — the alias column in the cheat sheet lists both the English and the Chinese aliases.
Not at a table yet? Start with the deploy & play guide. 中文读者:玩家指令手册(中文)。
1Dice & checks
Two ways to type the same commands, one dice engine: the English Avrae / d20 style and the Chinese SealDice style.
Dice expressions
.r 3d6+2 | roll three d6, add 2 |
.r 4d6kh3 | roll 4d6, keep the highest 3 (kl keeps the lowest) |
.r d20 adv | advantage (dis for disadvantage) |
[[1d20+5]] | inline roll — embed it right inside a sentence |
Skill / attribute checks (the soul of CoC: .ra)
.check Spot Hidden # regular difficulty
.check Spot Hidden hard # hard (half skill)
.check Spot Hidden extreme # extreme (one-fifth skill)
Success levels, best to worst: critical → extreme success → hard success → success → failure → fumble. The Keeper narrates consequences by level. .check / .ra / .rc are the same command (the D&D side adds .save / .attack / .cast).
Other checks
.sc 1d6/1d10 | sanity check (lose the first on success, the second on failure) |
.init / .ri | initiative |
.opposed / .rav | opposed check (two sides contest) |
.growth / .en | improvement check (skill growth) |
.rh | hidden roll (only you and the Keeper see the result) |
.jrrp | daily luck (just for fun) |
2Character-sheet commands
.st | show the current sheet |
.st STR60 "Spot Hidden"70 | set attributes/skills (values outside the legal range are pulled back in) |
.st finalize | snap current HP/MP/SAN to the final stats (finishing touch after creation) |
.coc / .dnd | create a new CoC7 / D&D5e character |
.rule | view or set the room's house-rule ladder (the ladders are declared by the rulepack, so the options differ per system); .rule 0 returns to the default |
.nn Name | rename the current character |
.avatar | set/clear your avatar, shown on the party panel; characters imported from a Tavern card use the card art automatically |
3Keeper commandsKEEPER
These are available only when connected with a Keeper key (the terminal UI has screens for all of them too).
| Rule-system / KP-skill / module admin screens | Describe the rule system, play style, or module you want in one sentence on the matching terminal screen — the Keeper authors it, validates it with the real loaders, and installs it live. No restart. |
.module <path> | Import a module file and analyze it into Keeper/player knowledge pools. Big modules take minutes, with a live progress bar (read → embed → analyze → build → done). |
.skill enable/disable <id> | Toggle KP skills per room, e.g. romance-relationships. Bare .skill lists what's installed and enabled. |
.model set <provider> [model] | Hot-switch the LLM provider/model, no restart. .model key <key> swaps the API key (private channel only); bare .model shows the current config and is open to everyone — only changes need the Keeper. |
.room | Open / join / leave cross-platform shared rooms; issue room invites. |
.import <tavern card> | Import a SillyTavern character card (PNG / JSON). |
.lore | Worldbook: .lore list is open to everyone; add / query / import touch Keeper-only lore, so they're Keeper-gated and the reply goes only to you. |
.panels enable/disable <packId> | admit an installed pack's UI panels to this room (install is not enable). .panels lists the packs that ship panels. The same switch turns on that pack's presentation kit |
.var | curate which imported-card variables reach the party panel: .var list / expose <prefix|*> / hide <prefix>. An imported variable tree is hidden from players until you expose it |
.chronicle | the campaign chronicle: list / summary / threads (open loops) / fold (fold now) / edit <text> / note <text>. Players see .recap; replies come back to you alone because they can carry keeper annotations |
.preset | imported SillyTavern presets as a room style layer: list / import <server file> / enable <id> / disable / show <id>. One per room; sampling parameters are reported, not applied |
.botlist | Maintain the anti-loop bot ignore list (prevents bot-to-bot loops when several bots share a room). |
.bot | Toggle dice replies. |
.reset [chars|all] | Staged campaign reset, armed by .reset confirm: bare .reset clears only story progress (characters, module, lore and media survive); chars also rerolls the party (module survives); all erases everything. Room settings, keys and bindings always survive. There is no automatic backup — be sure. |
.bgm / .ambience / .sfx | The room's three audio layers: background music loops, ambience beds, sound effects fire once; .audio lists and manages the library. Files play locally on each client. |
.language <en|zh> | Set the room-wide display language (affects every member, which is why changing it takes the Keeper). |
Issuing invites / managing keys / room backups happen on the terminal's "Rooms & invites" screen (role-gated, Keeper-only); sensitive replies (masked keys, room keys) go only to you, never broadcast to the room.
4Cheat sheet
Any prefix works: . / 。 / /. KEEPER = Keeper only.
| Command | Aliases | Does |
|---|---|---|
.roll | .r .rd | dice expression |
.check | .ra .rc .save .attack .cast | skill/attribute check (CoC: .ra 侦查) |
.sc | .sanity | sanity check |
.opposed | .rav .rcv | opposed check |
.growth | .en | improvement check |
.init | .ri .initiative | initiative |
.rh | .hroll | hidden roll (only you/the Keeper see it) |
.jrrp | .luck | daily luck |
.draw | .抽牌 | draw a card |
.coc | .coc7 | create a CoC7 character |
.dnd | .dnd5e | create a D&D5e character |
.genchar | .生卡 .生成角色 | describe → AI drafts a character |
.import KEEPER | .导入 | import a Tavern character card |
.sheet | .st | view/edit the sheet |
.rule | .rule | house-rule ladder |
.rename | .nn | rename |
.avatar | .头像 | set/clear your avatar |
.panel | .面板 | refresh the table panel |
.report | .团报 .跑团记录 | export a session report |
.help | .h .帮助 | command help |
.module KEEPER | .模组 | import a module |
.skill | — | list/inspect room KP skills (toggling is Keeper-only) |
.model | .模型 | viewing is open to all; set/key swap is Keeper-only |
.room KEEPER | .房间 | rooms/invites |
.party | .队伍 | AI companions (add, act, automate) |
.lore | .设定 | worldbook (list is open; authoring/query is Keeper-only, replies private) |
.botlist KEEPER | .机器人名单 | anti-loop ignore list |
.bot | — | toggle dice replies |
.audio KEEPER | .音频 .bgm .ambience .sfx | room audio library & playback (bgm/ambience/sfx) |
.language KEEPER | — | room language en/zh |
.recap | .recap | spoiler-free campaign recap |
.pc | .roster | the module's pre-generated cast: list / claim / release |
.chronicle KEEPER | — | campaign chronicle (open loops, manual fold); replies are private |
.panels KEEPER | — | admit an installed pack's panels / presentation to the room |
.var KEEPER | .vars | imported-card variable visibility for players |
.preset KEEPER | — | SillyTavern presets as a room style layer |
.reset KEEPER | .重置 .重开 | staged reset (story / party / all, needs confirm) |