Discord commands
All the bot's commands at a glance. Most act on the character linked to your Discord account — start by linking yourself with /token. Commands tagged GM are restricted to the GM role.
Getting started — linking your character
| Command | Effect |
|---|---|
/token hash:<token> character_id:<id> | Link your Discord account to a character, using the token (16 characters) generated on the site. |
/whoami | See which character is linked to your account. |
/unlink | Unlink the currently linked character. |
The campaign and the channel
The GM can link a Discord channel to a campaign on the site: the "party" for collective commands then becomes the campaign — its members, plus the guests of the active quest.
| Command | Effect |
|---|---|
/campaign | See the campaign linked to this channel (summary + party). |
/bind-campaign hash:<token> campaign_id:<id> GM | Link this channel to a campaign, using the token generated from "Manage the party" on the site. |
/unbind-campaign GM | Unlink this channel from its campaign. |
Viewing your sheet
| Command | Effect |
|---|---|
/sheet | Show the linked character's sheet. |
/inventory | Show the inventory (bag, weapons, armor). |
/spells | Show known spells. |
/feats | Show feats. |
Rolling dice
The FOR DEX CON INT SAG CHA tokens use the linked character's ability scores.
| Command | Effect |
|---|---|
/roll expression:<expr> | Roll a dice expression (e.g. 1d20+3, 2d6+FOR). |
/check stat:<ability> | Ability check: 1d20 + modifier. |
/save stat:<ability> | Saving throw: 1d20 + modifier. |
Managing your gear
| Command | Effect |
|---|---|
/equip add|remove item:<item> | Add or remove an item from the bag. |
/weapon add|remove|equip|unequip item:<weapon> | Manage weapons and their equipped state (several weapons possible). |
/armor add|remove|equip|unequip item:<armor> | Manage armor — only one equipped at a time (the others get unequipped). |
Playing your character
| Command | Effect |
|---|---|
/spend amount:<gold> | Spend gold. Refused if the balance is insufficient (nothing is deducted). |
/drop item:<item> [quantity:<n>] | Drop an item from the bag. Without a quantity: the whole stack. |
/use item:<consumable> | Use a consumable (−1 to the quantity). |
/short-rest [hit_dice:<n>] | Request a short rest — subject to GM approval. If approved: Hit Dice healing. |
/rest | Request a long rest — subject to GM approval. If approved: HP restored to maximum. |
/cast heal target:<player> dice_expr:<expr> | Heal a player (dice rolled with your own stats). |
/cast heal-party dice_expr:<expr> | Heal the whole party (linked campaign, otherwise PCs in the initiative). |
Fighting
During combat, targets are the combatants in the initiative (started by the GM with /init or /pop). Each combatant has a stable handle, e.g. loup, loup-2 — the target field's autocompletion suggests them.
| Command | Effect |
|---|---|
/attack weapon:<weapon> target:<target> [mode] | Attack with a weapon you own. Attack roll (appropriate ability + proficiency) against AC, with advantage/disadvantage as applicable; a natural 20 is a critical hit (dice doubled), a 1 a miss. Damage is applied automatically to NPCs. |
/cast spell:<prepared spell> target:<target> [level] [mode] | Cast a prepared spell. Depending on the spell: attack roll, saving throw (the GM adjudicates success/failure), healing or automatic effect. Consumes a spell slot (cantrips are free); a concentration spell replaces the current concentration. |
/ability use feature:<feature> [target] [amount] [mode] | Use a class feature (Second Wind, Action Surge, Channel Divinity, rage, ki…). Spends the associated resource — restored on rest — then resolves the effect (attack, healing, save or automatic effect). /ability list shows your features and remaining resources. |
Spell slots, class resources and concentration are tracked and restored on rest. Against a PC, the roll is announced and the GM adjudicates (their AC is not stored for player attacks). When the last monster falls, the bot announces victory (🎉) — and if the whole party is down, defeat (💀) — whoever lands the final blow.
Hit Points. A player cannot directly modify their own HP. It only changes through a GM command, a healer's /cast heal, or an approved rest — and always stays within [0, max HP].
GM tools GM
| Command | Effect |
|---|---|
/hp player:<player> delta:<±n> | Adjust a player's HP (clamped to [0, max HP]). |
/xp player:<player> delta:<±n> | Adjust XP. |
/gold player:<player> delta:<±n> | Adjust gold (never negative). |
/damage player:<player> amount:<n> | Deal damage (subtracted from HP). |
/gm-heal player:<player> amount:<n> | Heal a player by a fixed amount. |
/gm-heal-party amount:<n> | Heal the whole party (linked campaign, otherwise PCs in the initiative). |
/xp-party amount:<n> | Give XP to the whole party. |
/gold-party amount:<n> | Give gold to the whole party. |
/title player:<player> titre:<text> | Award an honorific title to a character ("-" or "aucun" to remove it). |
/init start|add|next|end | Start, populate, advance or end an initiative tracker. /init next pings the player whose turn it is (or the GM for an NPC). |
/init mobs | Throw every pending monster (revealed by /pop but not yet in play) into the initiative at once. |
/init remove token:<combatant> | Remove a combatant from the initiative (fled, vanished…). |
/npc [name] [hp] [bonus] [ac] [monstre] [perso] | Quickly add an NPC to the initiative (targeting handle assigned automatically). With monstre: links a catalog stat block — name, HP, AC and initiative bonus pre-filled, and /mob attack becomes available. With perso: fields an already-created character (one of yours or a public character) as an opponent — HP and AC taken from their sheet, damage tracked on the initiative without ever modifying the sheet. Accepts duplicates ("Gobelin #2"). |
/mob attack attacker:<opponent> attack:<attack> target:<target> | Make a monster or an opposing character from the initiative attack: stat-block attacks for a monster, weapons and attack cantrips for a character (autocompleted, with their real stats). Against a PC, their AC is computed from their equipped armor and the damage applies automatically. Multiple attacks are announced ×N — rerun the command for each swing. |
/condition add|remove|clear|list | Apply or remove a condition (prone, restrained, poisoned…) on a combatant — it automatically feeds the advantage/disadvantage of /attack and /cast spell. |
Quests & encounters GM
These commands rely on the quests prepared on the site (NPCs, bestiary, guests) and require a channel linked to a campaign.
| Command | Effect |
|---|---|
/quest quete:<quest> | Choose the campaign's active quest (autocompletion over the prepared quests). |
/meet personnage:<NPC> | Introduce an NPC to the players. Autocompletion suggests the active quest's prepared NPCs; a free-form name works too. |
/pop | Spawn a monster suited to the party's average level, drawn from the active quest's bestiary (otherwise the catalog). Private proposal to the GM with ✅ Present, 🔁 Reroll, ❌ Dismiss buttons — the public presentation offers "Add to initiative". |
Quest guests. A public character can be invited to a single quest without joining the campaign. While that quest is active, they count as part of the party: collective rewards and /pop's level calculation include them.