Explore JSON-defined stories, fight personal encounters, claim shared discoveries, earn XP, and build one character across IRC and Discord.
%rpg enable
%rpg start
%rpg go north
%rpg explore
%rpg attack
Note: enabling or disabling the RPG requires a channel moderator. Once enabled, anyone in the channel can play. %mud is an alias for %rpg.
The Crossroads · The Crossroads
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
Level-up choice waiting: strength +4 / defense +1 / accuracy +4 / dodge +3
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
No world position yet · Not exploring
0 gold · 0 victories
0 attacks made · 0 enemy turns · 0 deaths · 0 revives
Live availability for The Crossroads. Refresh the page to update cooldowns.
| Find | Room | Reward | Status |
|---|---|---|---|
| a hunter's cache | The Whispering Woods | 2-6 gold, 0.5 XP | Available |
| the sealed coffer | The Buried Vault | 10-20 gold, 3 XP | Available |
| a forgotten satchel | The Fallen Ruins | 4-9 gold, 1 XP | Available |
| the shrine's blue flame | The Hilltop Shrine | 0.5 XP, 8 health | Available |
%rpg start prints the active story introduction and describes your current room. It does not erase or restart your character.
%rpg look or %rpg l — describe the room, exits, current enemy, and shared finds.%rpg map — show the story's compact map.%rpg who — list other players currently in your room.Use %rpg go <direction>, a full direction, or its one-letter abbreviation.
%rpg north / %rpg n
%rpg south / %rpg s
%rpg east / %rpg e
%rpg west / %rpg w
%rpg up / %rpg u
%rpg down / %rpg d
You cannot move normally while an enemy blocks the way. Defeat it or flee first.
%rpg explore — start a random encounter from the room's encounter table.%rpg attack or %rpg fight — attack, then receive the enemy's retaliation if it survives.%rpg defend or %rpg guard — reduce incoming damage while holding your ground.%rpg flee [direction] or %rpg run [direction] — try to escape, choosing an exit or letting the bot choose.Victories award XP and gold. Defeat returns you to the story entrance at full health and costs half your gold. Encounters and enemy health belong to your character; another player cannot kill or strand your enemy.
%rpg search looks for story-defined chests, caches, lockers, shrines, and similar finds. Rewards may include gold, XP, or healing.
Discoveries are genuinely multiplayer: once one person claims a find, it is unavailable to everyone until its cooldown expires. %rpg look shows who used it and when it returns. Searching is unavailable during combat.
%rpg stats — health, level, XP, combat stats, room, gold, and victories.%rpg status — a plain-language health description.%rpg gold — current gold and victory count.%rpg rest — fully heal in a safe room; resting has a one-minute cooldown.A public announcement lists the offered gains. Choose exactly one before you can level again:
%rpg strength
%rpg defense
%rpg accuracy
%rpg dodge
%rpg activity to ask the bot for its current activity-XP settings.
Linked identities share permissions, RPG progress, activity XP, and Internet Points. The authenticated IRC/NickServ account becomes the canonical identity.
%claim. The bot publicly returns a seven-character code valid for ten minutes.%claim <code>.If separate RPG records already exist, the link keeps the highest progression values, combines gold and counters, and removes the duplicate Discord record. An admin can directly link an identity with %linkdiscord <discord-user-id> <nickserv-account>.
| Command | Aliases | What it does | Access |
|---|---|---|---|
%rpg / state | %mud | Report whether RPG is enabled in this channel. | Anyone |
%rpg enable|disable | Enable or disable RPG commands and activity XP for this channel. | Channel Moderator | |
%rpg start | Print the story introduction and look at your current room. | Anyone | |
%rpg look | l | Describe the current room, exits, enemy, and shared discoveries. | Anyone |
%rpg go <direction> | n s e w u d | Move through a listed exit. | Anyone |
%rpg explore | Start a personal random encounter. | Anyone | |
%rpg search | Claim an available shared discovery. | Anyone | |
%rpg attack | fight | Attack the current enemy. | Anyone |
%rpg defend | guard | Brace against the enemy's next attack. | Anyone |
%rpg flee [direction] | run | Try to escape combat. | Anyone |
%rpg rest | sleep | Fully heal in a safe room, subject to cooldown. | Anyone |
%rpg who | Show other players in your room. | Anyone | |
%rpg map | Print the active story's compact map. | Anyone | |
%rpg stats|status|gold | Inspect character progression, health, and wealth. | Anyone | |
%rpg activity | Show passive channel-activity XP settings. | Anyone | |
%rpg strength|defense|accuracy|dodge | Apply one pending stat gain after leveling. | Anyone | |
%rpg story | Show the active and available story packs. | Anyone | |
%rpg story <id> | Switch the active story for everybody. | Admin | |
%rpg reloadstory | Reload edited JSON for the active story. | Admin | |
%rpg givexp <user> <amount> | Grant character XP and announce a resulting level-up. | Admin |
The active story is crossroads. Switching stories moves players to the new entrance on their next RPG command while preserving character progression, gold, and victories.
clockwork_cellar The town clock has begun striking thirteen. Its retired maker swears the trouble is coming from the workshop cellar, where no machine should still be running.
crossroads activeTravelers whisper that something beneath the old country roads is waking. Begin at the crossroads, follow the signs, and see what the buried vault has forgotten.
Story packs live in resources/rpg/stories/. Copy an existing pack, then make the filename and top-level id match. Use %rpg reloadstory after editing the active pack.
| Object | Required fields | Optional fields and references |
|---|---|---|
| Story | id, title, intro, startRoom, mapText, rooms, enemies | discoveries; startRoom must name an existing room. |
| Room | name, description, exits | safe, encounters, discoveries. Every exit and referenced ID must exist. |
| Enemy | name, level, health, attack, defense, accuracy, dodge, die, xp, gold: [min, max] | encounterText, victoryText |
| Discovery | name, foundText, cooldownSeconds | gold: [min, max], xp, heal |
Room, enemy, discovery, and story IDs may contain lowercase letters, numbers, underscores, and hyphens. The loader rejects broken exits, missing references, invalid reward ranges, and malformed packs with a useful error.