From f198041530d7e5c4343e9d16767945e3f40805af Mon Sep 17 00:00:00 2001 From: prosolis <5590409+prosolis@users.noreply.github.com> Date: Fri, 15 May 2026 07:11:40 -0700 Subject: [PATCH] Phase B1: jargon-free !help blurbs in adventure Commands() Strip 'Adv 2.0', dice formulas, DCs, and ability-mod math from the 21 player-facing Description strings in AdventurePlugin.Commands(). Rewrite harvest verbs (forage/mine/scavenge/essence/commune/fish) into outcome language. !roll keeps its dice syntax since that's a format spec, not gameplay jargon. No runtime changes; build + vet clean. --- internal/plugin/adventure.go | 44 ++++++++++++++++++------------------ 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/internal/plugin/adventure.go b/internal/plugin/adventure.go index 89b8f29..55177c1 100644 --- a/internal/plugin/adventure.go +++ b/internal/plugin/adventure.go @@ -149,31 +149,31 @@ func (p *AdventurePlugin) Commands() []CommandDef { {Name: "adventure", Description: "Town services menu (expeditions: see !expedition)", Usage: "!adventure", Category: "Games"}, {Name: "arena", Description: "Arena combat — fight through 5 tiers of increasingly deadly monsters", Usage: "!arena", Category: "Games"}, {Name: "thom", Description: "Visit Thom Krooke — housing and loans", Usage: "!thom", Category: "Games"}, - {Name: "setup", Description: "Create or continue your Adv 2.0 character (race, class, stats)", Usage: "!setup", Category: "Games"}, - {Name: "sheet", Description: "View your Adv 2.0 character sheet", Usage: "!sheet", Category: "Games"}, - {Name: "abilities", Description: "List your Adv 2.0 class and race abilities", Usage: "!abilities", Category: "Games"}, - {Name: "respec", Description: "Wipe and rebuild your Adv 2.0 character (5000 euros, 7-day cooldown)", Usage: "!respec", Category: "Games"}, - {Name: "subclass", Description: "View or choose your Adv 2.0 subclass (unlocks at L5; change costs 500 euros, 30-day cooldown)", Usage: "!subclass [name|number]", Category: "Games"}, - {Name: "check", Description: "Roll an Adv 2.0 skill check (d20 + ability modifier vs DC)", Usage: "!check [dc]", Category: "Games"}, - {Name: "rest", Description: "Take an Adv 2.0 rest (`short`: 1h cooldown, partial heal — `long`: 24h, full heal, requires housing or inn)", Usage: "!rest short|long", Category: "Games"}, - {Name: "arm", Description: "Pre-arm an active Adv 2.0 ability for next combat (consumes resource)", Usage: "!arm ", Category: "Games"}, + {Name: "setup", Description: "Create or continue your character (race, class, stats)", Usage: "!setup", Category: "Games"}, + {Name: "sheet", Description: "View your character sheet", Usage: "!sheet", Category: "Games"}, + {Name: "abilities", Description: "List your class and race abilities", Usage: "!abilities", Category: "Games"}, + {Name: "respec", Description: "Wipe and rebuild your character (5000 euros, 7-day cooldown)", Usage: "!respec", Category: "Games"}, + {Name: "subclass", Description: "View or choose your subclass (unlocks at level 5; change costs 500 euros, 30-day cooldown)", Usage: "!subclass [name|number]", Category: "Games"}, + {Name: "check", Description: "Try a skill — see if you pull it off", Usage: "!check [difficulty]", Category: "Games"}, + {Name: "rest", Description: "Rest up (`short`: quick breather, 1h cooldown — `long`: full night, 24h, needs housing or inn)", Usage: "!rest short|long", Category: "Games"}, + {Name: "arm", Description: "Ready an ability so it fires the moment your next fight starts", Usage: "!arm ", Category: "Games"}, {Name: "roll", Description: "Roll dice (NdN+M format, e.g. 2d6+3, d20, 4d6-1)", Usage: "!roll ", Category: "Games"}, - {Name: "stats", Description: "Show your Adv 2.0 ability scores and modifiers", Usage: "!stats", Category: "Games"}, - {Name: "level", Description: "Show your Adv 2.0 level and XP progress", Usage: "!level", Category: "Games"}, - {Name: "cast", Description: "Cast an Adv 2.0 spell (queues for next combat, or resolves out-of-combat)", Usage: "!cast [--upcast N] [--target @user]", Category: "Games"}, - {Name: "spells", Description: "List your known spells, prepared spells, and spell slots", Usage: "!spells [learn ]", Category: "Games"}, - {Name: "prepare", Description: "Cleric: prepare a spell for the day (cap = WIS mod + level)", Usage: "!prepare | !prepare clear ", Category: "Games"}, - {Name: "forage", Description: "Forage in your current expedition region (WIS / Survival)", Usage: "!forage", Category: "Games"}, - {Name: "mine", Description: "Mine or salvage in your current expedition region (STR / Athletics)", Usage: "!mine", Category: "Games"}, - {Name: "scavenge", Description: "Scavenge in your current expedition region (INT / Investigation)", Usage: "!scavenge", Category: "Games"}, - {Name: "essence", Description: "Harvest magical essence in your current expedition region (INT / Arcana)", Usage: "!essence", Category: "Games"}, - {Name: "commune", Description: "Commune with spiritual energy in your current expedition region (Cleric primary)", Usage: "!commune", Category: "Games"}, - {Name: "fish", Description: "Fish in your current expedition region (DEX / Sleight of Hand; water zones only)", Usage: "!fish", Category: "Games"}, - {Name: "resources", Description: "List harvestable resources in your current expedition region", Usage: "!resources", Category: "Games"}, + {Name: "stats", Description: "Show your ability scores", Usage: "!stats", Category: "Games"}, + {Name: "level", Description: "Show your level and XP progress", Usage: "!level", Category: "Games"}, + {Name: "cast", Description: "Cast a spell (queues for next combat, or resolves now if out of combat)", Usage: "!cast [--upcast N] [--target @user]", Category: "Games"}, + {Name: "spells", Description: "List your known spells, prepared spells, and remaining casts", Usage: "!spells [learn ]", Category: "Games"}, + {Name: "prepare", Description: "Cleric: prepare a spell for the day", Usage: "!prepare | !prepare clear ", Category: "Games"}, + {Name: "forage", Description: "Search your expedition region for plants, herbs, and tracks", Usage: "!forage", Category: "Games"}, + {Name: "mine", Description: "Dig or salvage stone, ore, and scrap in your expedition region", Usage: "!mine", Category: "Games"}, + {Name: "scavenge", Description: "Pick through your expedition region for left-behind valuables", Usage: "!scavenge", Category: "Games"}, + {Name: "essence", Description: "Pull magical essence from your expedition region", Usage: "!essence", Category: "Games"}, + {Name: "commune", Description: "Reach out to the spirits of your expedition region (Cleric specialty)", Usage: "!commune", Category: "Games"}, + {Name: "fish", Description: "Fish in your expedition region (water zones only)", Usage: "!fish", Category: "Games"}, + {Name: "resources", Description: "List what's harvestable in your current expedition region", Usage: "!resources", Category: "Games"}, {Name: "explore", Description: "Autopilot: walk through expedition rooms until something needs your attention (fork, elite/boss, low HP/supplies)", Usage: "!explore", Category: "Games"}, - {Name: "sell", Description: "Sell harvested materials/fish/items to Thom Krooke (post-expedition; CHA Persuasion DC 17 = +15%)", Usage: "!sell [list|all|]", Category: "Games"}, + {Name: "sell", Description: "Sell your hauled materials, fish, and items to Thom Krooke after an expedition (a smooth pitch can land a better price)", Usage: "!sell [list|all|]", Category: "Games"}, {Name: "craft", Description: "Craft a discovered recipe at Thom Krooke (consumes ingredients)", Usage: "!craft [list|]", Category: "Games"}, - {Name: "lore", Description: "Dig through Thom Krooke's lore stacks for an undiscovered recipe (INT/Arcana DC 15)", Usage: "!lore", Category: "Games"}, + {Name: "lore", Description: "Dig through Thom Krooke's lore stacks for a new recipe (sharp minds turn up more)", Usage: "!lore", Category: "Games"}, } }