Discord Slash Commands
Every slash command LedgerBot registers in your Discord server. Most commands support autocomplete - start typing and Discord will suggest matching values. For how trackers themselves work, see the trackers guide.
Guild Trackers
Shared trackers that everyone in the server can view.| Command | Options | Description |
|---|---|---|
/ledger
|
- | One-time snapshot of all guild trackers, grouped by category, with the current stress score. Does not auto-update — run again for the latest. |
/tracker
|
name
|
Display a single guild tracker as a detailed embed. |
/history
|
tracker
|
Show the last 10 reasons for value changes on a guild tracker. |
/adjust
|
tracker
value
reason
(optional)
|
Set a tracker to an exact numeric value or a threshold label (e.g. "Scarce"). Requires adjust permission. |
/nudge
|
tracker
direction
(up/down)
reason
(optional)
|
Increment or decrement a tracker by one step or tier. Requires adjust permission. |
/morale
|
tracker
morale
(high/low/none)
reason
(optional)
|
Set the morale tag on a tracker. Requires adjust permission. |
/panel
|
category
(optional)
|
Pin a live board in the current channel that auto-updates when trackers change. Admin only. One per channel — replaces any existing board. |
Personal Trackers
Per-user trackers. Responses are ephemeral, so only the invoking user sees them.| Command | Options | Description |
|---|---|---|
/inventory
|
- | View all of your personal trackers, grouped by category. |
/my_tracker
|
name
|
Display one of your personal trackers as a detailed embed. |
/my_nudge
|
tracker
direction
(up/down)
|
Nudge one of your personal trackers up or down by one step or tier. |
Narrative & Setup (Not Yet Implemented)
| Command | Options | Description |
|---|---|---|
/generate
|
type
(optional: need/event/dilemma/twist/all)
|
Generate narrative prompts based on the current guild state. Requires adjust permission. Rate-limited by a cooldown. |
/setup
|
template
(optional)
|
Apply a preset template to initialise the guild. Admin only. Omit the template to list what's available. |
/help
|
- | Show the built-in command reference inside Discord. |
Snapshot vs live board:
Use
/ledger
for a quick, one-time look at current tracker values.
Use
/panel
to pin a message in the channel that stays and refreshes automatically (~30s after changes).
Admins only.
Permissions:
Commands that modify trackers
/adjust
,
/nudge
, and
/morale
require a role with the "Can Adjust" permission configured under Role Permissions. Admin-only commands
/setup
and
/panel
require Discord administrator permissions.