${title}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_371":372,"_373":374},"routes/_app.x.$handle.$name",{"_98":97,"_32":45,"_107":88,"_27":53,"_13":14,"_108":-5,"_11":109,"_110":111,"_112":113,"_114":115,"_116":117,"_20":-5,"_118":-5,"_119":-5,"_120":25,"_121":122,"_123":124,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",238,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","maps.ts","latestPath","fileId","a4656b02-a743-11f1-b2a7-1607ee4eb77e","name","fileType","script","content","// GuildScribe — battle maps\n//\n// Chat commands create/edit maps and place character tokens on them; a\n// public, read-only web page (see pages.ts / main.ts route \"/map\") renders\n// the grid visually. Editing (creating a map, painting terrain, deleting a\n// map, and moving someone else's token) stays behind Twitch chat identity\n// (chatterId, verified by EventSub) rather than an open web form — that\n// matches how every other piece of shared channel state in this bot\n// (parties, duels, the initiative tracker) is only ever mutated through an\n// authenticated chat command, never through an unauthenticated web request.\n\nimport { sendChatMessage } from \"./twitch.ts\";\nimport {\n createMap,\n deleteMap,\n fillMap,\n findTokenAt,\n getCharacter,\n getMap,\n getMapCells,\n getMapToken,\n getMapTokens,\n listMaps,\n removeMapToken,\n setMapCell,\n upsertMapToken,\n} from \"./db.ts\";\n\nexport const TERRAINS: Record = {\n grass: { label: \"Grass\", color: \"#4a7c3c\" },\n forest: { label: \"Forest\", color: \"#22492b\" },\n water: { label: \"Water\", color: \"#2b6f97\", blocksMovement: true },\n sand: { label: \"Sand\", color: \"#c9a86a\" },\n mountain: { label: \"Mountain\", color: \"#7a7266\", blocksMovement: true },\n road: { label: \"Road\", color: \"#a08a68\" },\n floor: { label: \"Floor\", color: \"#3a352f\" },\n wall: { label: \"Wall\", color: \"#5c5347\", blocksMovement: true },\n door: { label: \"Door\", color: \"#b97545\" },\n trap: { label: \"Trap\", color: \"#8b2f2f\" },\n lava: { label: \"Lava\", color: \"#c1440e\", blocksMovement: true },\n void: { label: \"Void\", color: \"#0d0c0b\", blocksMovement: true },\n};\n\nconst MIN_SIZE = 3;\nconst MAX_SIZE = 20;\nconst DEFAULT_WIDTH = 10;\nconst DEFAULT_HEIGHT = 8;\n\n// Deterministic per-user color so a token always looks the same across maps.\nconst TOKEN_PALETTE = [\n \"#e6a56e\", \"#7ec9e0\", \"#c98be0\", \"#8be0a0\", \"#e0d18b\",\n \"#e08b8b\", \"#8ba9e0\", \"#d68be0\", \"#a0e08b\", \"#e0a08b\",\n];\n\nexport function tokenColor(username: string): string {\n let hash = 0;\n for (let i = 0; i < username.length; i++) hash = (hash * 31 + username.charCodeAt(i)) >>> 0;\n return TOKEN_PALETTE[hash % TOKEN_PALETTE.length];\n}\n\nexport function sanitizeMapName(raw: string): string {\n return (raw ?? \"\").toLowerCase().replace(/[^a-z0-9_-]/g, \"\").slice(0, 24);\n}\n\nexport function terrainAt(cells: Record, defaultTerrain: string, x: number, y: number): string {\n return cells[`${x},${y}`] ?? defaultTerrain;\n}\n\nfunction parseSize(raw: string | undefined): { width: number; height: number } | null {\n if (!raw) return { width: DEFAULT_WIDTH, height: DEFAULT_HEIGHT };\n const m = raw.match(/^(\\d+)x(\\d+)$/i);\n if (!m) return null;\n const width = Number.parseInt(m[1], 10);\n const height = Number.parseInt(m[2], 10);\n if (width < MIN_SIZE || width > MAX_SIZE || height < MIN_SIZE || height > MAX_SIZE) return null;\n return { width, height };\n}\n\nasync function firstFreeCell(broadcasterId: string, mapName: string, width: number, height: number) {\n const tokens = await getMapTokens(broadcasterId, mapName);\n const occupied = new Set(tokens.map((t) => `${t.x},${t.y}`));\n for (let y = 1; y <= height; y++) {\n for (let x = 1; x <= width; x++) {\n if (!occupied.has(`${x},${y}`)) return { x, y };\n }\n }\n return null;\n}\n\nfunction usage(display: string) {\n return `@${display} Usage: !map create [WxH] (mod) | !map list | !map view | !map delete / !map remove (mod) | !map terrains | !map fill (mod) | !map paint (mod) | !map addchar [x y] | !map move | !map removechar `;\n}\n\nexport async function handleMapCommand(\n chatMessage: string,\n username: string,\n display: string,\n broadcasterId: string,\n isModerator: boolean,\n baseUrl: string,\n): Promise {\n if (!/^!map(?:\\s|$)/i.test(chatMessage)) return false;\n const me = username.toLowerCase();\n const parts = chatMessage.trim().split(/\\s+/);\n const action = (parts[1] ?? \"\").toLowerCase();\n const mapUrl = (name: string) => `${baseUrl}/map?channel=${broadcasterId}&map=${encodeURIComponent(name)}`;\n\n if (action === \"create\") {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can create a map.`, broadcasterId);\n return true;\n }\n const name = sanitizeMapName(parts[2] ?? \"\");\n if (!name) {\n await sendChatMessage(`@${display} usage: !map create [WxH], e.g. !map create dungeon1 12x10`, broadcasterId);\n return true;\n }\n if (await getMap(broadcasterId, name)) {\n await sendChatMessage(`@${display} a map named \"${name}\" already exists. Try !map view ${name}.`, broadcasterId);\n return true;\n }\n const size = parseSize(parts[3]);\n if (!size) {\n await sendChatMessage(`@${display} map size must be WxH between ${MIN_SIZE}x${MIN_SIZE} and ${MAX_SIZE}x${MAX_SIZE}, e.g. 12x10.`, broadcasterId);\n return true;\n }\n try {\n await createMap(broadcasterId, name, size.width, size.height, me);\n } catch (e) {\n await sendChatMessage(`@${display} ${String((e as Error).message ?? e)}`, broadcasterId);\n return true;\n }\n await sendChatMessage(\n `@${display} map \"${name}\" created (${size.width}x${size.height} grass). Paint it with !map paint/!map fill, then view it: ${mapUrl(name)}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"delete\" || action === \"remove\") {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can delete a map.`, broadcasterId);\n return true;\n }\n const name = sanitizeMapName(parts[2] ?? \"\");\n if (!name || !(await getMap(broadcasterId, name))) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found.`, broadcasterId);\n return true;\n }\n await deleteMap(broadcasterId, name);\n await sendChatMessage(`@${display} map \"${name}\" deleted, along with its terrain and character tokens.`, broadcasterId);\n return true;\n }\n\n if (action === \"list\" || action === \"\") {\n const maps = await listMaps(broadcasterId);\n await sendChatMessage(\n maps.length\n ? `@${display} Maps in this channel: ${maps.map((m) => `${m.map_name} (${m.width}x${m.height})`).join(\", \")}. View one with !map view .`\n : `@${display} no maps yet. A moderator can start one with !map create [WxH].`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"view\") {\n const name = sanitizeMapName(parts[2] ?? \"\");\n const map = name ? await getMap(broadcasterId, name) : null;\n if (!map) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found. Try !map list.`, broadcasterId);\n return true;\n }\n await sendChatMessage(`@${display} 🗺️ ${map.map_name}: ${mapUrl(map.map_name)}`, broadcasterId);\n return true;\n }\n\n if (action === \"terrains\") {\n await sendChatMessage(\n `@${display} Terrain types: ${Object.entries(TERRAINS).map(([k, v]) => `${k} (${v.label}${v.blocksMovement ? \", blocks tokens\" : \"\"})`).join(\", \")}`,\n broadcasterId,\n );\n return true;\n }\n\n if (action === \"fill\") {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can edit a map.`, broadcasterId);\n return true;\n }\n const name = sanitizeMapName(parts[2] ?? \"\");\n const terrain = (parts[3] ?? \"\").toLowerCase();\n const map = name ? await getMap(broadcasterId, name) : null;\n if (!map) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found.`, broadcasterId);\n return true;\n }\n if (!TERRAINS[terrain]) {\n await sendChatMessage(`@${display} unknown terrain \"${terrain}\". See !map terrains.`, broadcasterId);\n return true;\n }\n await fillMap(broadcasterId, name, terrain);\n await sendChatMessage(`@${display} map \"${name}\" filled with ${TERRAINS[terrain].label}. ${mapUrl(name)}`, broadcasterId);\n return true;\n }\n\n if (action === \"paint\") {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can edit a map.`, broadcasterId);\n return true;\n }\n const name = sanitizeMapName(parts[2] ?? \"\");\n const x = Number.parseInt(parts[3] ?? \"\", 10);\n const y = Number.parseInt(parts[4] ?? \"\", 10);\n const terrain = (parts[5] ?? \"\").toLowerCase();\n const map = name ? await getMap(broadcasterId, name) : null;\n if (!map) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found.`, broadcasterId);\n return true;\n }\n if (!Number.isInteger(x) || !Number.isInteger(y) || x < 1 || x > map.width || y < 1 || y > map.height) {\n await sendChatMessage(`@${display} coordinates must be within 1..${map.width} by 1..${map.height}. Usage: !map paint `, broadcasterId);\n return true;\n }\n if (!TERRAINS[terrain]) {\n await sendChatMessage(`@${display} unknown terrain \"${terrain}\". See !map terrains.`, broadcasterId);\n return true;\n }\n await setMapCell(broadcasterId, name, x, y, terrain);\n await sendChatMessage(`@${display} painted (${x},${y}) on \"${name}\" as ${TERRAINS[terrain].label}.`, broadcasterId);\n return true;\n }\n\n if (action === \"addchar\" || action === \"place\") {\n const name = sanitizeMapName(parts[2] ?? \"\");\n const map = name ? await getMap(broadcasterId, name) : null;\n if (!map) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found. Try !map list.`, broadcasterId);\n return true;\n }\n let rest = parts.slice(3);\n let targetUser = me;\n let targetDisplay = display;\n if (rest[0]?.startsWith(\"@\")) {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can place someone else's character.`, broadcasterId);\n return true;\n }\n targetDisplay = rest[0].slice(1);\n targetUser = targetDisplay.toLowerCase();\n rest = rest.slice(1);\n }\n const character = await getCharacter(targetUser, broadcasterId);\n if (!character) {\n await sendChatMessage(`@${display} ${targetUser === me ? \"you don't\" : `${targetDisplay} doesn't`} have a character yet — try !createchar first.`, broadcasterId);\n return true;\n }\n if (await getMapToken(broadcasterId, name, targetUser)) {\n await sendChatMessage(`@${display} ${targetUser === me ? \"you're\" : `${targetDisplay} is`} already on \"${name}\" — use !map move ${name} .`, broadcasterId);\n return true;\n }\n let x: number, y: number;\n if (rest.length >= 2 && Number.isInteger(Number(rest[0])) && Number.isInteger(Number(rest[1]))) {\n x = Number.parseInt(rest[0], 10);\n y = Number.parseInt(rest[1], 10);\n if (x < 1 || x > map.width || y < 1 || y > map.height) {\n await sendChatMessage(`@${display} coordinates must be within 1..${map.width} by 1..${map.height}.`, broadcasterId);\n return true;\n }\n const cells = await getMapCells(broadcasterId, name);\n const terrain = terrainAt(cells, map.default_terrain, x, y);\n if (TERRAINS[terrain]?.blocksMovement) {\n await sendChatMessage(`@${display} (${x},${y}) is ${TERRAINS[terrain].label} and blocks tokens.`, broadcasterId);\n return true;\n }\n if (await findTokenAt(broadcasterId, name, x, y)) {\n await sendChatMessage(`@${display} (${x},${y}) is already occupied.`, broadcasterId);\n return true;\n }\n } else {\n const free = await firstFreeCell(broadcasterId, name, map.width, map.height);\n if (!free) {\n await sendChatMessage(`@${display} map \"${name}\" has no free cells left.`, broadcasterId);\n return true;\n }\n x = free.x;\n y = free.y;\n }\n await upsertMapToken(broadcasterId, name, targetUser, targetDisplay, x, y);\n await sendChatMessage(`@${display} placed ${targetDisplay}'s character on \"${name}\" at (${x},${y}). ${mapUrl(name)}`, broadcasterId);\n return true;\n }\n\n if (action === \"move\") {\n const name = sanitizeMapName(parts[2] ?? \"\");\n const map = name ? await getMap(broadcasterId, name) : null;\n if (!map) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found.`, broadcasterId);\n return true;\n }\n let rest = parts.slice(3);\n let targetUser = me;\n let targetDisplay = display;\n if (rest[0]?.startsWith(\"@\")) {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can move someone else's token.`, broadcasterId);\n return true;\n }\n targetDisplay = rest[0].slice(1);\n targetUser = targetDisplay.toLowerCase();\n rest = rest.slice(1);\n }\n const x = Number.parseInt(rest[0] ?? \"\", 10);\n const y = Number.parseInt(rest[1] ?? \"\", 10);\n if (!Number.isInteger(x) || !Number.isInteger(y) || x < 1 || x > map.width || y < 1 || y > map.height) {\n await sendChatMessage(`@${display} usage: !map move , within 1..${map.width} by 1..${map.height}.`, broadcasterId);\n return true;\n }\n const token = await getMapToken(broadcasterId, name, targetUser);\n if (!token) {\n await sendChatMessage(`@${display} ${targetUser === me ? \"you're\" : `${targetDisplay} is`} not on \"${name}\" yet — use !map addchar ${name}.`, broadcasterId);\n return true;\n }\n const cells = await getMapCells(broadcasterId, name);\n const terrain = terrainAt(cells, map.default_terrain, x, y);\n if (TERRAINS[terrain]?.blocksMovement) {\n await sendChatMessage(`@${display} (${x},${y}) is ${TERRAINS[terrain].label} and blocks tokens.`, broadcasterId);\n return true;\n }\n const occupant = await findTokenAt(broadcasterId, name, x, y);\n if (occupant && occupant.username !== targetUser) {\n await sendChatMessage(`@${display} (${x},${y}) is already occupied.`, broadcasterId);\n return true;\n }\n await upsertMapToken(broadcasterId, name, targetUser, targetDisplay, x, y);\n await sendChatMessage(`@${display} moved ${targetDisplay}'s character on \"${name}\" to (${x},${y}).`, broadcasterId);\n return true;\n }\n\n if (action === \"removechar\") {\n const name = sanitizeMapName(parts[2] ?? \"\");\n if (!name || !(await getMap(broadcasterId, name))) {\n await sendChatMessage(`@${display} map \"${name || \"?\"}\" was not found.`, broadcasterId);\n return true;\n }\n let targetUser = me;\n let targetDisplay = display;\n if (parts[3]?.startsWith(\"@\")) {\n if (!isModerator) {\n await sendChatMessage(`@${display} only the broadcaster or a moderator can remove someone else's token.`, broadcasterId);\n return true;\n }\n targetDisplay = parts[3].slice(1);\n targetUser = targetDisplay.toLowerCase();\n }\n if (!(await getMapToken(broadcasterId, name, targetUser))) {\n await sendChatMessage(`@${display} ${targetUser === me ? \"you're\" : `${targetDisplay} is`} not on \"${name}\".`, broadcasterId);\n return true;\n }\n await removeMapToken(broadcasterId, name, targetUser);\n await sendChatMessage(`@${display} removed ${targetDisplay}'s character from \"${name}\".`, broadcasterId);\n return true;\n }\n\n await sendChatMessage(usage(display), broadcasterId);\n return true;\n}\n","// GuildScribe — battle maps\n//\n// Chat commands create/edit maps and place character tokens on them; a\n// public, read-only web page (see pages.ts / main.ts route \"/map\") renders\n// the grid visually. Editing (creating a map, painting terrain, deleting a\n// map, and moving someone else's token) stays behind Twitch chat identity\n// (chatterId, verified by EventSub) rather than an open web form — that\n// matches how every other piece of shared channel state in this bot\n// (parties, duels, the initiative tracker) is only ever mutated through an\n// authenticated chat command, never through an unauthenticated web request.\n\nimport { sendChatMessage } from \"./twitch.ts\";\nimport {\n createMap,\n deleteMap,\n fillMap,\n findTokenAt,\n getCharacter,\n getMap,\n getMapCells,\n getMapToken,\n getMapTokens,\n listMaps,\n removeMapToken,\n setMapCell,\n upsertMapToken,\n} from \"./db.ts\";\n\n// ── Map templates ──\n//\n// Publicly listable (!map templates), publicly usable (!map create \n// [WxH]

${escapeHtml(c.username)}

GuildScribe Activity Logs

GuildScribe Codex

Adventurer’s parchment

Create and view

Manage progress

Save and restore

Fate’s dice

Baldur's Gate 3

Roll a character (saved)

Roll a character (flavor only)

Companion & origin

Loot & camp

Knowledgebase

Guild archives

Spells, classes & rules

Equipment and abilities

Races

Arena, wilds & the company

Parties

Player duels & hunts

Battle maps

Create & view

Templates

Edit the terrain

Place & move characters

Onboarding and support

In chat

Connect and support

Guild stewards (mod/broadcaster)

🗺️ ${escapeHtml(map.map_name)}

Characters on this map

🗺️ Maps in this channel

GuildScribe Privacy Policy

How it is used

Retention

Deletion

GuildScribe Terms of Service

GuildScribe Codex

Support the Guild

Ethereum (ETH)

Bitcoin (BTC)

Connection cancelled

The Guild renews your banner

The Guild accepts your banner

Connection failed

GuildScribe

Hi

Diff · v238