Bring The Wandering Clerk to your channel

` +\n `

Click below and log in as the broadcaster of the channel you want the Clerk to serve. ` +\n `This only grants permission for the bot to read and post in your chat — nothing else.

` +\n `

Authorize The Wandering Clerk

`,\n );\n }\n\n // Step 2: Twitch redirects back here with a code once they authorize.\n if (url.pathname === \"/oauth/callback\") {\n const error = url.searchParams.get(\"error\");\n if (error) {\n return page(`

Authorization cancelled

${error}

`, 400);\n }\n const code = url.searchParams.get(\"code\");\n if (!code) {\n return page(\n `

Missing authorization code

Try the onboarding link again.

`,\n 400,\n );\n }\n const token = await exchangeCodeForToken(code, redirectUriFor(req));\n if (!token) {\n return page(\n `

Something went wrong

Couldn't complete authorization with Twitch. Try again in a moment.

`,\n 500,\n );\n }\n const user = await getAuthorizingUser(token.access_token);\n if (!user) {\n return page(\n `

Something went wrong

Couldn't identify your Twitch account.

`,\n 500,\n );\n }\n const ok = await onboardChannel(user.login, user.login);\n if (ok) {\n return page(\n `

You're all set, ${user.display_name}!

` +\n `

The Wandering Clerk now has a desk open in your channel. Try typing !help in your chat.

`,\n );\n }\n return page(\n `

Almost there, ${user.display_name}

` +\n `

Permission was granted, but the Clerk is still warming up. Give it a minute, then check your chat for !help. ` +\n `If nothing shows up after a few minutes, let the bot owner know.

`,\n );\n }\n\n return new Response(\"GuildBreak: Hunt & Hoard bot is running.\", {\n status: 200,\n headers: { \"content-type\": \"text/plain\" },\n });\n}","huntandhoardbot",[173],"8d245d5e-9d14-4a57-81f2-726b54dbf680","helix.ts","ef32123e-aa1d-11f1-940f-1607ee4eb77e",5,["D",1788718187647],"// =============================================================================\n// helix.ts — small Helix API client. This bot uses the modern chat stack\n// (EventSub for reading, Helix REST for sending) instead of legacy IRC.\n// =============================================================================\n\nconst CLIENT_ID = Deno.env.get(\"TWITCH_CLIENT_ID\") || \"\";\nconst CLIENT_SECRET = Deno.env.get(\"TWITCH_CLIENT_SECRET\") || \"\";\nconst BOT_TOKEN = Deno.env.get(\"TWITCH_BOT_ACCESS_TOKEN\") || \"\";\n\nif (!CLIENT_ID || !BOT_TOKEN) {\n console.error(\n \"Missing TWITCH_CLIENT_ID or TWITCH_BOT_ACCESS_TOKEN env vars.\",\n );\n}\n\nconst BASE = \"https://api.twitch.tv/helix\";\n\nfunction authHeaders(): HeadersInit {\n return {\n \"Client-Id\": CLIENT_ID,\n \"Authorization\": `Bearer ${BOT_TOKEN}`,\n \"Content-Type\": \"application/json\",\n };\n}\n\nexport interface HelixUser {\n id: string;\n login: string;\n display_name: string;\n}\n\nconst userCache = new Map();\n\nexport async function getUser(login: string): Promise {\n const key = login.toLowerCase();\n if (userCache.has(key)) return userCache.get(key)!;\n const res = await fetch(`${BASE}/users?login=${encodeURIComponent(key)}`, {\n headers: authHeaders(),\n });\n if (!res.ok) {\n console.error(\"getUser failed:\", res.status, await res.text());\n return null;\n }\n const json = await res.json();\n const user = json.data?.[0] as HelixUser | undefined;\n if (!user) return null;\n userCache.set(key, user);\n return user;\n}\n\n// Subscribes the bot (user_id) to chat messages in a given channel\n// (broadcaster_user_id) over the already-open EventSub WebSocket session.\n// This call fails with 403 if that broadcaster hasn't granted this\n// Client ID the channel:bot permission (see setup steps).\nexport async function createChatMessageSubscription(\n broadcasterId: string,\n botId: string,\n sessionId: string,\n): Promise {\n const res = await fetch(`${BASE}/eventsub/subscriptions`, {\n method: \"POST\",\n headers: authHeaders(),\n body: JSON.stringify({\n type: \"channel.chat.message\",\n version: \"1\",\n condition: { broadcaster_user_id: broadcasterId, user_id: botId },\n transport: { method: \"websocket\", session_id: sessionId },\n }),\n });\n if (!res.ok) {\n console.error(\n \"createChatMessageSubscription failed:\",\n res.status,\n await res.text(),\n );\n return false;\n }\n return true;\n}\n\nexport async function sendChatMessage(\n broadcasterId: string,\n senderId: string,\n text: string,\n): Promise {\n const res = await fetch(`${BASE}/chat/messages`, {\n method: \"POST\",\n headers: authHeaders(),\n body: JSON.stringify({\n broadcaster_id: broadcasterId,\n sender_id: senderId,\n message: text,\n }),\n });\n if (!res.ok) {\n console.error(\"sendChatMessage failed:\", res.status, await res.text());\n }\n}\n\n// -----------------------------------------------------------------------\n// One-click broadcaster onboarding (Authorization Code flow). A broadcaster\n// clicking the /onboard link authorizes just the channel:bot scope; we\n// exchange the resulting code for a short-lived token, use it only to\n// identify who authorized (their user id/login), then discard it — the\n// bot keeps running on its own long-lived TWITCH_BOT_ACCESS_TOKEN.\n// -----------------------------------------------------------------------\nexport async function exchangeCodeForToken(\n code: string,\n redirectUri: string,\n): Promise<{ access_token: string } | null> {\n const params = new URLSearchParams({\n client_id: CLIENT_ID,\n client_secret: CLIENT_SECRET,\n code,\n grant_type: \"authorization_code\",\n redirect_uri: redirectUri,\n });\n const res = await fetch(\n `https://id.twitch.tv/oauth2/token?${params.toString()}`,\n { method: \"POST\" },\n );\n if (!res.ok) {\n console.error(\"exchangeCodeForToken failed:\", res.status, await res.text());\n return null;\n }\n return await res.json();\n}\n\nexport async function getAuthorizingUser(\n accessToken: string,\n): Promise {\n const res = await fetch(`${BASE}/users`, {\n headers: {\n \"Client-Id\": CLIENT_ID,\n \"Authorization\": `Bearer ${accessToken}`,\n },\n });\n if (!res.ok) {\n console.error(\"getAuthorizingUser failed:\", res.status, await res.text());\n return null;\n }\n const json = await res.json();\n return (json.data?.[0] as HelixUser) ?? null;\n}",[180],"fe1f55a2-4c64-4efe-b107-e81e10dc9de2","game.ts","6bc49524-aa1e-11f1-88d3-1607ee4eb77e",20,["D",1788718318779],"// =============================================================================\n// game.ts — all the stateless game math and rules. Nothing in here talks\n// to Twitch or SQLite; it only operates on the plain objects below.\n// =============================================================================\nimport {\n ClassDef,\n classes,\n ItemDef,\n items,\n merchantNames,\n MonsterDef,\n monsters,\n nameEpithet,\n nameFirst,\n RaceDef,\n races,\n xpThresholds,\n} from \"./data.ts\";\n\nexport type { MonsterDef } from \"./data.ts\";\n\nexport interface InventoryItem extends ItemDef {\n qty: number;\n}\n\nexport interface Character {\n username: string;\n name: string;\n race: RaceDef;\n cls: ClassDef;\n hitDie: number;\n conMod: number;\n level: number;\n xp: number;\n gold: number;\n ac: number;\n hp: number;\n hpMax: number;\n inventory: InventoryItem[];\n equipped: { weapon: InventoryItem | null; armor: InventoryItem | null };\n createdAt: number;\n questProgress: Record; // quest id -> kills logged toward it\n}\n\nexport interface MerchantOffer {\n merchant: string;\n item: ItemDef;\n postedAt: number;\n}\n\n// -----------------------------------------------------------------------\n// Util\n// -----------------------------------------------------------------------\nexport const Util = {\n pick(arr: T[]): T {\n return arr[Math.floor(Math.random() * arr.length)];\n },\n rollDie(sides: number): number {\n return 1 + Math.floor(Math.random() * sides);\n },\n rollDice(count: number, sides: number): number {\n let total = 0;\n for (let i = 0; i < count; i++) total += Util.rollDie(sides);\n return total;\n },\n clamp(n: number, min: number, max: number): number {\n return Math.max(min, Math.min(max, n));\n },\n modifier(score: number): number {\n return Math.floor((score - 10) / 2);\n },\n sampleUnique(arr: T[], count: number): T[] {\n if (arr.length <= count) return arr.slice();\n const pool = arr.slice();\n const out: T[] = [];\n for (let i = 0; i < count; i++) {\n const idx = Math.floor(Math.random() * pool.length);\n out.push(pool[idx]);\n pool.splice(idx, 1);\n }\n return out;\n },\n};\n\n// -----------------------------------------------------------------------\n// Rules — character math\n// -----------------------------------------------------------------------\nexport const Rules = {\n rollRandomName(): string {\n return Util.pick(nameFirst) + \" \" + Util.pick(nameEpithet);\n },\n\n levelForXp(xp: number): number {\n let level = 1;\n for (let i = xpThresholds.length - 1; i >= 0; i--) {\n if (xp >= xpThresholds[i]) {\n level = i + 1;\n break;\n }\n }\n return Util.clamp(level, 1, 20);\n },\n\n maxHpForLevel(\n character: Pick,\n ): number {\n const perLevel = Math.max(\n 1,\n Math.floor(character.hitDie / 2) + 1 + character.conMod,\n );\n const base = Math.max(1, character.hitDie + character.conMod);\n return base + (character.level - 1) * perLevel +\n character.race.hpBonus * character.level;\n },\n\n createCharacter(username: string, name: string): Character {\n const race = Util.pick(races);\n const cls = Util.pick(classes);\n const conMod = Util.modifier(Util.rollDice(3, 6) + 5); // biased toward positive CON\n const character: Character = {\n username: username.trim().toLowerCase(),\n name,\n race,\n cls,\n hitDie: cls.hitDie,\n conMod,\n level: 1,\n xp: 0,\n gold: 10,\n ac: 10 + Math.max(0, conMod),\n inventory: [],\n equipped: { weapon: null, armor: null },\n createdAt: Date.now(),\n questProgress: {},\n hp: 0,\n hpMax: 0,\n };\n character.hpMax = Rules.maxHpForLevel(character);\n character.hp = character.hpMax;\n return character;\n },\n\n attackBonusFor(character: Character): number {\n const base = character.cls.atkBonus + Math.floor(character.level / 3);\n const weaponBonus = character.equipped.weapon\n ? (character.equipped.weapon.atkBonus ?? 0)\n : 0;\n return base + weaponBonus;\n },\n\n armorClassFor(character: Character): number {\n const armorBonus = character.equipped.armor\n ? (character.equipped.armor.acBonus ?? 0)\n : 0;\n return character.ac + armorBonus;\n },\n\n sheetLine(character: Character): string {\n const hpBar = character.hp + \"/\" + character.hpMax + \" HP\";\n const weapon = character.equipped.weapon\n ? character.equipped.weapon.name\n : \"bare fists\";\n const armor = character.equipped.armor\n ? character.equipped.armor.name\n : \"no armor\";\n return character.name + \" — Level \" + character.level + \" \" +\n character.race.name + \" \" + character.cls.name +\n \" | \" + hpBar + \" | AC \" + Rules.armorClassFor(character) + \" | XP \" +\n character.xp + \" | Gold \" + character.gold +\n \" | Wielding: \" + weapon + \" | Wearing: \" + armor;\n },\n};\n\n// -----------------------------------------------------------------------\n// Combat\n// -----------------------------------------------------------------------\nexport interface HuntResult {\n monster: MonsterDef;\n won: boolean;\n log: string[];\n xpGained: number;\n goldGained: number;\n leveledTo: number | null;\n hpLeft: number;\n hpMax: number;\n}\n\nexport const Combat = {\n pickMonsterForLevel(level: number): MonsterDef {\n const targetCr = Util.clamp((level + 1) / 4, 0.125, 20);\n const hardCeiling = Util.clamp(targetCr * 2 + 0.5, 1, 24);\n const pool = monsters.filter((m) => m.cr <= hardCeiling);\n const weights = pool.map((m) => {\n if (m.cr <= targetCr) return 3;\n if (m.cr <= targetCr * 1.15) return 1.2;\n return 0.4;\n });\n const total = weights.reduce((a, b) => a + b, 0);\n let roll = Math.random() * total;\n for (let i = 0; i < pool.length; i++) {\n roll -= weights[i];\n if (roll <= 0) return pool[i];\n }\n return pool[pool.length - 1];\n },\n\n huntMonster(character: Character, forcedMonster?: MonsterDef): HuntResult {\n const monster = forcedMonster ??\n Combat.pickMonsterForLevel(character.level);\n let monsterHp = monster.hp;\n let playerHp = character.hp;\n const atkBonus = Rules.attackBonusFor(character);\n const ac = Rules.armorClassFor(character);\n const log: string[] = [];\n let swings = 0;\n\n while (playerHp > 0 && monsterHp > 0 && swings < 40) {\n swings++;\n const pRoll = Util.rollDie(20);\n const pHit = pRoll === 20 ||\n (pRoll !== 1 && pRoll + atkBonus >= monster.ac);\n if (pHit) {\n const dmg =\n Math.max(1, Util.rollDice(1, 8) + Math.floor(character.level / 2)) *\n (pRoll === 20 ? 2 : 1);\n monsterHp = Math.max(0, monsterHp - dmg);\n log.push(\"you hit for \" + dmg);\n } else {\n log.push(\"you miss\");\n }\n if (monsterHp <= 0) break;\n\n const mRoll = Util.rollDie(20);\n const mHit = mRoll === 20 || (mRoll !== 1 && mRoll + monster.atk >= ac);\n if (mHit) {\n const dmg = Math.max(\n 1,\n Util.rollDice(monster.dmgDice, monster.dmgSides) + monster.dmgBonus,\n );\n playerHp = Math.max(0, playerHp - dmg);\n log.push(monster.name + \" hits you for \" + dmg);\n } else {\n log.push(monster.name + \" misses\");\n }\n }\n\n const won = monsterHp <= 0 && playerHp > 0;\n character.hp = Math.max(1, playerHp); // never actually die — worst case, stagger away at 1 HP\n\n let xpGained = 0;\n let goldGained = 0;\n let leveledTo: number | null = null;\n\n if (won) {\n xpGained = monster.xp;\n goldGained = monster.goldMin +\n Math.floor(Math.random() * (monster.goldMax - monster.goldMin + 1));\n character.xp += xpGained;\n character.gold += goldGained;\n const newLevel = Rules.levelForXp(character.xp);\n if (newLevel > character.level) {\n character.level = newLevel;\n const oldMax = character.hpMax;\n character.hpMax = Rules.maxHpForLevel(character);\n character.hp = Util.clamp(\n character.hp + (character.hpMax - oldMax),\n 1,\n character.hpMax,\n );\n leveledTo = newLevel;\n }\n } else {\n xpGained = 5 + character.level * 3;\n character.xp += xpGained;\n }\n\n return {\n monster,\n won,\n log,\n xpGained,\n goldGained,\n leveledTo,\n hpLeft: character.hp,\n hpMax: character.hpMax,\n };\n },\n};\n\n// -----------------------------------------------------------------------\n// MonsterLookup — used by !hunt to target a specific\n// monster instead of a random level-appropriate encounter.\n// -----------------------------------------------------------------------\nexport const MonsterLookup = {\n find(needle: string): MonsterDef | undefined {\n const n = needle.trim().toLowerCase();\n return monsters.find((m) => m.name.toLowerCase() === n) ||\n monsters.find((m) => m.name.toLowerCase().indexOf(n) !== -1);\n },\n};\n\n// -----------------------------------------------------------------------\n// Inventory\n// -----------------------------------------------------------------------\nexport const Inventory = {\n find(character: Character, needle: string): InventoryItem | undefined {\n const n = needle.trim().toLowerCase();\n return character.inventory.find((it) =>\n it.key.toLowerCase() === n || it.name.toLowerCase().indexOf(n) !== -1\n );\n },\n add(character: Character, itemDef: ItemDef): void {\n const existing = character.inventory.find((it) => it.key === itemDef.key);\n if (existing) {\n existing.qty += 1;\n } else {\n character.inventory.push({ ...itemDef, qty: 1 });\n }\n },\n removeOne(character: Character, invItem: InventoryItem): void {\n invItem.qty -= 1;\n if (invItem.qty <= 0) {\n character.inventory = character.inventory.filter((it) => it !== invItem);\n }\n },\n};\n\n// -----------------------------------------------------------------------\n// Merchant\n// -----------------------------------------------------------------------\nexport const Merchant = {\n SLOT_COUNT: 3,\n AD_INTERVAL_MS: 8 * 60 * 1000, // 8 minutes\n AD_JITTER_MS: 4 * 60 * 1000, // up to +4 minutes extra\n\n rollOffer(): MerchantOffer {\n return {\n merchant: Util.pick(merchantNames),\n item: Util.pick(items),\n postedAt: Date.now(),\n };\n },\n\n rollOffers(): MerchantOffer[] {\n const picked = Util.sampleUnique(items, Merchant.SLOT_COUNT);\n return picked.map((item) => ({\n merchant: Util.pick(merchantNames),\n item,\n postedAt: Date.now(),\n }));\n },\n\n pickAdOffer(currentOffers: MerchantOffer[] | null): MerchantOffer {\n if (currentOffers && currentOffers.length) return Util.pick(currentOffers);\n return Merchant.rollOffer();\n },\n\n formatAd(offer: MerchantOffer): string {\n return \"🛒 \" + offer.merchant + \" is hawking \" + offer.item.name + \" (\" +\n offer.item.desc + \") for \" +\n offer.item.price +\n \" gold! Say !merchant to see the full stall, or !buy to grab it.\";\n },\n\n findOffer(\n offers: MerchantOffer[],\n needle: string,\n ): { offer: MerchantOffer; index: number } | null {\n const trimmed = needle.trim();\n const asNumber = parseInt(trimmed, 10);\n if (\n !isNaN(asNumber) && String(asNumber) === trimmed && asNumber >= 1 &&\n asNumber <= offers.length\n ) {\n return { offer: offers[asNumber - 1], index: asNumber - 1 };\n }\n const n = trimmed.toLowerCase();\n for (let i = 0; i < offers.length; i++) {\n if (offers[i].item.name.toLowerCase().indexOf(n) !== -1) {\n return { offer: offers[i], index: i };\n }\n }\n return null;\n },\n\n cheapestAffordable(\n offers: MerchantOffer[],\n gold: number,\n ): MerchantOffer | null {\n let best: MerchantOffer | null = null;\n offers.forEach((offer) => {\n if (\n offer.item.price <= gold &&\n (!best || offer.item.price < best.item.price)\n ) best = offer;\n });\n return best;\n },\n\n describeOffers(offers: MerchantOffer[]): string {\n return offers\n .map((offer, i) =>\n \"#\" + (i + 1) + \" \" + offer.item.name + \" (\" + offer.item.desc +\n \") — \" + offer.item.price + \" gold [\" + offer.merchant + \"]\"\n )\n .join(\" | \");\n },\n};\n\n// -----------------------------------------------------------------------\n// Advisor — the \"what should I do next\" hint shared by nearly every command\n// -----------------------------------------------------------------------\nexport const Advisor = {\n LOW_HP_FRACTION: 0.3,\n\n isLowHp(character: Character): boolean {\n return character.hp <=\n Math.max(1, Math.ceil(character.hpMax * Advisor.LOW_HP_FRACTION));\n },\n\n recommendNextAction(\n character: Character | null,\n offers: MerchantOffer[] | null,\n ): string {\n if (!character) {\n return \"Next: !enlist (or !enlist random) to roll up a hero.\";\n }\n if (character.hp <= 1) return \"Next: !rest — you are barely standing.\";\n if (Advisor.isLowHp(character)) {\n return \"Next: !rest to patch up before your next fight.\";\n }\n\n const unequippedWeapon = character.inventory.find((it) =>\n it.type === \"weapon\" &&\n (!character.equipped.weapon ||\n (it.atkBonus ?? 0) > (character.equipped.weapon.atkBonus ?? 0))\n );\n if (unequippedWeapon) {\n return \"Next: !use \" + unequippedWeapon.name +\n \" — it beats what you have equipped.\";\n }\n\n const unequippedArmor = character.inventory.find((it) =>\n it.type === \"armor\" &&\n (!character.equipped.armor ||\n (it.acBonus ?? 0) > (character.equipped.armor.acBonus ?? 0))\n );\n if (unequippedArmor) {\n return \"Next: !use \" + unequippedArmor.name +\n \" — it beats what you have equipped.\";\n }\n\n const affordable = offers &&\n Merchant.cheapestAffordable(offers, character.gold);\n if (affordable) {\n return \"Next: !buy \" + affordable.item.name + \" — you can afford it (\" +\n affordable.item.price + \" gold) from \" + affordable.merchant + \".\";\n }\n return \"Next: !hunt for more XP and gold, or !autohunt to chain fights automatically.\";\n },\n};",[187],"14513117-b592-4ee5-805d-dba7397a03b3","commands.ts","4aa4c512-aa1e-11f1-a291-1607ee4eb77e",14,["D",1788718275879],"// =============================================================================\n// commands.ts — one async function per player-facing command. Each takes\n// (username, display, args) and returns the reply string.\n// To add a new command: write the function here, then add one line to\n// COMMAND_DEFS at the bottom of twitch.ts.\n// =============================================================================\nimport {\n Advisor,\n Character,\n Combat,\n Inventory,\n Merchant,\n MonsterLookup,\n Rules,\n Util,\n} from \"./game.ts\";\nimport { QuestBoard } from \"./quests.ts\";\nimport * as Store from \"./store.ts\";\n\n// Checks the current quest board for a bounty on `monsterName`, logs\n// `kills` toward it for this character, and auto turns it in (grants\n// reward, rerolls that board slot) the moment it's met. Returns a message\n// fragment to tack onto the hunt reply, or \"\" if no quest was touched.\nasync function applyQuestProgress(\n c: Character,\n monsterName: string,\n kills: number,\n): Promise {\n if (kills <= 0) return \"\";\n const board = await Store.getQuestBoard();\n const found = QuestBoard.findByMonsterName(board, monsterName);\n if (!found) return \"\";\n\n const { quest, index } = found;\n const updated = (c.questProgress[quest.id] || 0) + kills;\n\n if (updated >= quest.targetCount) {\n c.gold += quest.goldReward;\n let rewardMsg = \"+\" + quest.goldReward + \" gold\";\n if (quest.itemReward) {\n Inventory.add(c, quest.itemReward);\n rewardMsg += \" and a \" + quest.itemReward.name;\n }\n delete c.questProgress[quest.id];\n board[index] = QuestBoard.rollQuest();\n await Store.saveQuestBoard(board);\n return \" 📜 Quest complete! The Clerk pays out for the \" +\n quest.monsterName + \" bounty — \" + rewardMsg +\n \". A new posting goes up on the board.\";\n }\n\n c.questProgress[quest.id] = updated;\n return \" 📜 Quest progress: \" + quest.monsterName + \" \" + updated + \"/\" +\n quest.targetCount + \".\";\n}\n\nconst HELP_TEXT =\n \"the Clerk's ledger lists: !start quick status + what to do next | !enlist to begin | \" +\n '!chars (!ledger) sheet | !hunt [monster name] to fight for XP & gold (name one to target it, e.g. \"!hunt wolf\") | ' +\n \"!autohunt (!auto) chain fights until you level up or need rest | !rest to heal | \" +\n \"!quests (!board) see the bounty board and your progress | \" +\n \"!merchant (!shop) see the stall (multiple offers!) | !coinpurse (!purse) check your gold | \" +\n \"!buy <#|item name> purchase an offer | !inventory (!inv) see your items | \" +\n \"!use | !drop | !discharge confirm to start over\";\n\nexport async function help(\n _username: string,\n display: string,\n): Promise {\n return \"@\" + display + \" \" + HELP_TEXT;\n}\n\nexport async function start(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" Ah, a new face at the desk. The Clerk hasn't got you on the rolls yet — !enlist \" +\n \"or !enlist random to have your name entered, then !hunt (or !autohunt) to begin building a record worth reading. !help for the full ledger.\";\n }\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" \" + Rules.sheetLine(c) + \" \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function createchar(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const existing = await Store.getCharacter(username);\n if (existing) {\n return \"@\" + display + \" you already have a character (\" + existing.name +\n \", Level \" + existing.level +\n \"). Only one character is allowed — use !discharge confirm to release them and roll a new one.\";\n }\n const raw = args.join(\" \").trim();\n let name: string;\n if (!raw || raw.toLowerCase() === \"random\") {\n name = Rules.rollRandomName();\n } else if (raw.length > 24) {\n return \"@\" + display +\n ' that name is too long (24 characters max). Try again, or use \"!enlist random\".';\n } else if (!/^[a-zA-Z' -]+$/.test(raw)) {\n return \"@\" + display +\n ' names can only use letters, spaces, apostrophes, and hyphens. Try again, or use \"!enlist random\".';\n } else {\n name = raw;\n }\n const character = Rules.createCharacter(username, name);\n await Store.saveCharacter(character);\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" the Clerk enters \" + character.name +\n \" into the rolls — Level 1 \" + character.race.name + \" \" +\n character.cls.name + \". \" + Rules.sheetLine(character) + \". \" +\n Advisor.recommendNextAction(character, offers);\n}\n\nexport async function character(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" you don't have a character yet. Start with !enlist or !enlist random.\";\n }\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" \" + Rules.sheetLine(c) + \" \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function hunt(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" you need a character first — !enlist or !enlist random.\";\n }\n if (c.hp <= 1) {\n return \"@\" + display + \" \" + c.name + \" is barely standing (\" + c.hp + \"/\" +\n c.hpMax + \" HP) — !rest before hunting again.\";\n }\n\n const targetName = args.join(\" \").trim();\n let targetMonster = undefined as ReturnType;\n if (targetName) {\n targetMonster = MonsterLookup.find(targetName);\n if (!targetMonster) {\n return \"@\" + display + ' no monster matches \"' + targetName +\n '\". Check !quests for the board, or !hunt with no name for a random encounter.';\n }\n }\n\n const result = Combat.huntMonster(c, targetMonster);\n const questMsg = result.won\n ? await applyQuestProgress(c, result.monster.name, 1)\n : \"\";\n await Store.saveCharacter(c);\n const offers = await Store.getMerchantOffers();\n const highlight = result.log.slice(-3).join(\", \");\n const rec = Advisor.recommendNextAction(c, offers);\n if (result.won) {\n const levelMsg = result.leveledTo\n ? \" 🎉 Leveled up to \" + result.leveledTo + \"!\"\n : \"\";\n return \"@\" + display + \" \" + c.name + \" took on a \" + result.monster.name +\n \" (\" + highlight + \") and won! +\" +\n result.xpGained + \" XP, +\" + result.goldGained + \" gold. HP \" +\n result.hpLeft + \"/\" + result.hpMax + \".\" + levelMsg + questMsg + \" \" +\n rec;\n }\n return \"@\" + display + \" \" + c.name + \" was overwhelmed by a \" +\n result.monster.name + \" (\" + highlight +\n \") and had to retreat. +\" + result.xpGained + \" XP for the effort. HP \" +\n result.hpLeft + \"/\" + result.hpMax + \" — \" + rec;\n}\n\nexport async function autohunt(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" you need a character first — !enlist or !enlist random.\";\n }\n if (c.hp <= 1) {\n return \"@\" + display + \" \" + c.name + \" is barely standing (\" + c.hp + \"/\" +\n c.hpMax + \" HP) — !rest before hunting again.\";\n }\n\n const MAX_HUNTS = 10;\n const startLevel = c.level;\n let hunts = 0, wins = 0, losses = 0, totalXp = 0, totalGold = 0;\n let stopReason = \"hit the \" + MAX_HUNTS + \"-fight safety cap\";\n const winsByMonster = new Map();\n\n while (hunts < MAX_HUNTS) {\n const result = Combat.huntMonster(c);\n hunts++;\n totalXp += result.xpGained;\n totalGold += result.goldGained;\n if (result.won) {\n wins++;\n winsByMonster.set(\n result.monster.name,\n (winsByMonster.get(result.monster.name) || 0) + 1,\n );\n } else {\n losses++;\n }\n\n if (result.leveledTo) {\n stopReason = \"leveled up to \" + result.leveledTo;\n break;\n }\n if (c.hp <= 1) {\n stopReason = \"HP hit critical\";\n break;\n }\n if (Advisor.isLowHp(c)) {\n stopReason = \"HP getting low\";\n break;\n }\n }\n\n let questMsg = \"\";\n for (const [monsterName, kills] of winsByMonster) {\n questMsg += await applyQuestProgress(c, monsterName, kills);\n }\n\n await Store.saveCharacter(c);\n const offers = await Store.getMerchantOffers();\n const leveledUp = c.level > startLevel;\n const emoji = leveledUp ? \" 🎉\" : \"\";\n const summary = \"@\" + display + \" auto-hunted \" + hunts + \" fight\" +\n (hunts === 1 ? \"\" : \"s\") + \" (\" + wins +\n \"W/\" + losses + \"L): +\" + totalXp + \" XP, +\" + totalGold + \" gold. HP \" +\n c.hp + \"/\" + c.hpMax + \". Stopped: \" +\n stopReason + \".\" + emoji + questMsg;\n return summary + \" \" + Advisor.recommendNextAction(c, offers);\n}\n\nexport async function rest(username: string, display: string): Promise {\n const c = await Store.getCharacter(username);\n if (!c) return \"@\" + display + \" you don't have a character yet.\";\n const offers = await Store.getMerchantOffers();\n if (c.hp >= c.hpMax) {\n return \"@\" + display + \" \" + c.name + \" is already at full health (\" +\n c.hp + \"/\" + c.hpMax + \"). \" +\n Advisor.recommendNextAction(c, offers);\n }\n c.hp = c.hpMax;\n await Store.saveCharacter(c);\n return \"@\" + display + \" \" + c.name + \" rests and recovers to \" + c.hp + \"/\" +\n c.hpMax + \" HP. \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function quests(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n const board = await Store.getQuestBoard();\n const desc = QuestBoard.describeBoard(\n board,\n (q) => (c ? c.questProgress[q.id] || 0 : 0),\n );\n const hint = c\n ? ' Say !hunt to work one, e.g. \"!hunt ' +\n board[0].monsterName + '\".'\n : \" Create a character with !enlist to start logging progress.\";\n return \"@\" + display + \" 📜 the Clerk's quest board: \" + desc + \".\" + hint;\n}\n\nexport async function merchant(\n _username: string,\n display: string,\n): Promise {\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" 🛒 today's stall: \" +\n Merchant.describeOffers(offers) +\n '. Say !buy <#|item name> to purchase, e.g. \"!buy 1\".';\n}\n\nexport async function coinpurse(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" you don't have a character yet, so no purse to check.\";\n }\n const offers = await Store.getMerchantOffers();\n const affordable = Merchant.cheapestAffordable(offers, c.gold);\n const purseLine = \"@\" + display + \" \" + c.name + \"'s coinpurse: \" + c.gold +\n \" gold.\";\n if (affordable) {\n return purseLine + \" Enough for \" + affordable.item.name + \" (\" +\n affordable.item.price + \" gold) at !merchant — !buy it.\";\n }\n if (offers.length) {\n const cheapest = offers.reduce((\n a,\n b,\n ) => (a.item.price <= b.item.price ? a : b));\n const short = cheapest.item.price - c.gold;\n return purseLine + \" Need \" + short +\n \" more gold for the cheapest stall item (\" + cheapest.item.name + \"). \" +\n Advisor.recommendNextAction(c, offers);\n }\n return purseLine + \" \" + Advisor.recommendNextAction(c, offers);\n}\n\nexport async function buy(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" you need a character first — !enlist or !enlist random.\";\n }\n const offers = await Store.getMerchantOffers();\n const needle = args.join(\" \").trim();\n if (!needle) {\n return \"@\" + display + \" buy which one? \" +\n Merchant.describeOffers(offers) +\n ' — try \"!buy 1\" or \"!buy \".';\n }\n const found = Merchant.findOffer(offers, needle);\n if (!found) {\n return \"@\" + display + ' no stall offer matches \"' + needle +\n '\". Current stall: ' + Merchant.describeOffers(offers);\n }\n const offer = found.offer;\n if (c.gold < offer.item.price) {\n return \"@\" + display + \" you need \" + offer.item.price + \" gold for \" +\n offer.item.name + \" but only have \" +\n c.gold + \". Go !hunt for more.\";\n }\n c.gold -= offer.item.price;\n Inventory.add(c, offer.item);\n offers[found.index] = Merchant.rollOffer(); // only the purchased slot restocks\n await Store.saveCharacter(c);\n await Store.saveMerchantOffers(offers);\n return \"@\" + display + \" bought \" + offer.item.name + \" from \" +\n offer.merchant + \" for \" + offer.item.price +\n \" gold. Check !inventory, and !use it when ready. That slot has a new offer. \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function inventory(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) return \"@\" + display + \" you don't have a character yet.\";\n if (!c.inventory.length) {\n return \"@\" + display + \" \" + c.name +\n \"'s inventory is empty. Try !merchant and !buy.\";\n }\n const offers = await Store.getMerchantOffers();\n const list = c.inventory.map((it) =>\n it.name + (it.qty > 1 ? \" x\" + it.qty : \"\")\n ).join(\", \");\n return \"@\" + display + \" \" + c.name + \"'s inventory: \" + list + \". \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function use(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) return \"@\" + display + \" you don't have a character yet.\";\n const needle = args.join(\" \").trim();\n if (!needle) {\n return \"@\" + display + \" use what? Try !use , e.g. !use potion.\";\n }\n const invItem = Inventory.find(c, needle);\n if (!invItem) {\n const have = c.inventory.length\n ? c.inventory.map((it) => it.name).join(\", \")\n : \"(nothing)\";\n return \"@\" + display + ' no item matching \"' + needle +\n '\" in your inventory. You have: ' + have;\n }\n\n let msg: string;\n if (invItem.type === \"potion\") {\n const heal = invItem.heal!;\n const healed = Util.rollDice(heal[0], heal[1]) + heal[2];\n c.hp = Util.clamp(c.hp + healed, 0, c.hpMax);\n Inventory.removeOne(c, invItem);\n msg = \"@\" + display + \" \" + c.name + \" drinks the \" + invItem.name +\n \" and recovers \" + healed + \" HP (\" + c.hp + \"/\" + c.hpMax + \").\";\n } else if (invItem.type === \"weapon\") {\n const previous = c.equipped.weapon;\n c.equipped.weapon = invItem;\n Inventory.removeOne(c, invItem);\n if (previous) Inventory.add(c, previous);\n msg = \"@\" + display + \" \" + c.name + \" equips the \" + invItem.name + \".\";\n } else if (invItem.type === \"armor\") {\n const previous = c.equipped.armor;\n c.equipped.armor = invItem;\n Inventory.removeOne(c, invItem);\n if (previous) Inventory.add(c, previous);\n msg = \"@\" + display + \" \" + c.name + \" puts on the \" + invItem.name + \".\";\n } else {\n msg = \"@\" + display + \" the \" + invItem.name +\n \" is just a trinket — neat, but nothing happens when you use it.\";\n }\n await Store.saveCharacter(c);\n const offers = await Store.getMerchantOffers();\n return msg + \" \" + Advisor.recommendNextAction(c, offers);\n}\n\nexport async function drop(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) return \"@\" + display + \" you don't have a character yet.\";\n const needle = args.join(\" \").trim();\n if (!needle) return \"@\" + display + \" drop what? Try !drop .\";\n const invItem = Inventory.find(c, needle);\n if (!invItem) {\n const have = c.inventory.length\n ? c.inventory.map((it) => it.name).join(\", \")\n : \"(nothing)\";\n return \"@\" + display + ' no item matching \"' + needle +\n '\" in your inventory. You have: ' + have;\n }\n Inventory.removeOne(c, invItem);\n await Store.saveCharacter(c);\n return \"@\" + display + \" dropped \" + invItem.name + \".\";\n}\n\nexport async function resetchar(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) return \"@\" + display + \" you don't have a character to reset.\";\n if ((args[0] || \"\").toLowerCase() !== \"confirm\") {\n return \"@\" + display + \" the Clerk will strike \" + c.name +\n ' from the rolls for good if you\\'re sure — say \"!discharge confirm\".';\n }\n await Store.deleteCharacter(username);\n return \"@\" + display + \" the Clerk closes \" + c.name +\n \"'s file. Use !enlist when you're ready to open a new one.\";\n}\n\nexport const Commands: Record<\n string,\n (username: string, display: string, args: string[]) => Promise\n> = {\n help,\n start,\n createchar,\n character,\n hunt,\n autohunt,\n rest,\n merchant,\n coinpurse,\n buy,\n inventory,\n use,\n drop,\n resetchar,\n quests,\n};",[194],"pulls","branches","forks","envVars",{"_207":182,"_209":61},"connections",{"_207":61,"_208":61},"count","unfilledCount","emptyCount",{"_42":193,"_32":194,"_30":195,"_140":-5,"_40":41,"_39":196,"_142":24,"_37":244,"_13":144,"_33":34,"_35":198,"_23":24,"_146":-5,"_220":245,"_26":246},{"_42":186,"_32":187,"_30":188,"_140":-5,"_40":41,"_39":189,"_142":24,"_37":241,"_13":144,"_33":34,"_35":191,"_23":24,"_146":-5,"_220":242,"_26":243},{"_42":179,"_32":180,"_30":181,"_140":-5,"_40":41,"_39":182,"_142":24,"_37":238,"_13":144,"_33":34,"_35":184,"_23":24,"_146":-5,"_220":239,"_26":240},{"_42":172,"_32":173,"_30":55,"_140":-5,"_40":41,"_39":144,"_142":24,"_37":235,"_13":175,"_33":34,"_35":176,"_23":24,"_146":177,"_220":236,"_26":237},{"_42":169,"_32":27,"_30":31,"_140":-5,"_40":41,"_39":14,"_142":24,"_37":232,"_13":61,"_33":34,"_35":36,"_23":24,"_146":-5,"_220":233,"_26":234},{"_42":162,"_32":163,"_30":164,"_140":-5,"_40":41,"_39":165,"_142":24,"_37":229,"_13":144,"_33":34,"_35":167,"_23":24,"_146":-5,"_220":230,"_26":231},{"_42":155,"_32":156,"_30":157,"_140":-5,"_40":41,"_39":158,"_142":57,"_37":226,"_13":144,"_33":34,"_35":160,"_23":24,"_146":-5,"_220":227,"_26":228},{"_42":148,"_32":149,"_30":150,"_140":-5,"_40":41,"_39":151,"_142":24,"_37":223,"_13":144,"_33":34,"_35":153,"_23":24,"_146":-5,"_220":224,"_26":225},{"_42":137,"_32":138,"_30":139,"_140":-5,"_40":41,"_39":141,"_142":24,"_37":219,"_13":144,"_33":34,"_35":145,"_23":24,"_146":-5,"_220":221,"_26":222},["D",1788718207634],"children",[],[138],["D",1788718335883],[],[149],["D",1788718301227],[],[156],["D",1788718243636],[],[163],["D",1788718340583],[],[27],["D",1788718047650],[],[173],["D",1788718187647],[],[180],["D",1788718318779],[],[187],["D",1788718275879],[],[194],["D",1788715747973],["D",1789587683564],{"_98":97,"_106":102},{"_98":97,"_99":100,"_101":102,"_18":53,"_103":104,"_105":24},{"_13":87,"_32":88,"_42":41,"_89":43,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":44,"_96":97},"ctx",{"_80":-5,"_125":285,"_286":287,"_288":289,"_290":24,"_291":24,"_292":24,"_293":57,"_294":-5,"_295":-7,"_296":-7,"_297":61,"_298":24,"_299":24,"_300":-5,"_301":24,"_302":24,"_303":24,"_304":-5},"ENV",{"_256":257,"_258":259,"_260":88,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270,"_271":272,"_273":274,"_275":276,"_277":278,"_279":280,"_281":282,"_283":284},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","811aa22498c9b0b5a47e8d778de579cdb990f332","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v24