azeroth-shell 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+What changed in each release of `azeroth-shell` on npm. Update with `npm install -g azeroth-shell@latest`.
+
+## Unreleased
+
+## 0.4.0 — 2026-11-03
+
+- Bags: `X` destroys several stacks at once, and `Q` destroys every quest item left over from quests you handed in.
+- Dungeons: a 5-man you leave is held for two hours (it was 30 minutes). On the World tab, Enter on a run you
+  left half done takes you straight back in. The tab also lists the zone's dungeons while you are inside one,
+  and a cleared run says so. Picking another dungeon from inside one leaves the current run, which is held.
+- Companions get their own copy of a quest item that comes from an object. If their copy never finished, they
+  drop it when you hand the quest in, so it no longer fills their log. Their quest list offers to drop old ones.
+- Art for what a fight turns into or brings in: boss morphs, totems, wards and adds were invisible before.
+- The title line reads "Azeroth Shell".
+
+## 0.3.0 — 2026-11-03
+
+- HD gear art at 256 px with a palette per body. Shapeshift forms and costumes draw sharp under sixel.
+- The Travel tab has a world map, in half-block and sixel.
+- Tame and quest-item uses on World rows; dungeon entry locks and extra entrances; Hearthstone and ring/trinket
+  picks in Bags. The Character tab gets a stats page, and buffs are cast before a pull.
+- Hunter pets untrain at the trainer's prices and keep their innate abilities.
+- A foe still targeting you keeps the fight going.
+- `azsh --art` downloads the full-size art up front.
+
+## 0.2.0 — 2026-11-02
+
+- Art: creatures, icons and your geared character are drawn as half-block sprites, or as real pixels in a
+  terminal that supports sixel.
+- A fight stage, the Gear tab as a character sheet, talent trees, and a one-page character creation screen.
+- Party fights on the stage, each body at its real distance. Casters no longer stall on immune foes.
+- The autopilot on screen: pre-flight card, run strip, run panel, Run/Quests/Bags panes, end card, and the
+  rotation condition editor.
+- Auction house browsing by category; world search covers the zone you stand in.
+- Warsong Gulch: strip map, your own seat, side calls, and matches that actually end.
+- Faster start: the engine is cached under `~/.azsh/cache`, with a loading line while it imports.
+
+## 0.1.2 — 2026-11-01
+
+- A character open in another terminal cannot be opened a second time.
+- The Travel tab stays open after you depart.
+- A screen refresh setting: game loops repaint at most once per refresh.
+
+## 0.1.1 — 2026-11-01
+
+- Vendor window: `d` destroys a stack from your bags or a companion's.
+- Terminal: Ctrl-L repaints, a full repaint on screen change, and a notice when the window is too small.
+
+## 0.1.0 — 2026-11-01
+
+- First release on npm.

package/README.md

@@ -13,7 +13,7 @@ front end. No graphics, no browser, no build step.
 - [Install](#install)
 - [Keys](#keys)
 - [Playing](#playing): [character](#new-character) · [world and autopilot](#world-and-the-autopilot) ·
-  [fights](#fights) · [rotation](#rotation) · [gear](#gear-and-bags) · [vendors, trainers, talents](#vendors-trainers-talents) ·
+  [fights](#fights) · [rotation](#rotation) · [gear](#character-and-bags) · [vendors, trainers, talents](#vendors-trainers-talents) ·
   [professions](#professions) · [companions](#companions) · [dungeons](#dungeons) · [city services](#city-services)
 - [Art and terminals](#art-and-terminals)
 - [Line mode and saves](#line-mode-and-saves)
@@ -23,11 +23,19 @@ front end. No graphics, no browser, no build step.
 ## Install
 
 ```sh
-npx azeroth-shell             # run it straight from npm
+npx azeroth-shell                  # run it straight from npm
 npm install -g azeroth-shell  # or install it once, then:
-azeroth-shell                 # pick a character or roll one (azsh for short)
+azeroth-shell                         # or just azsh
+azeroth-shell --art                 # optional: fetch the full-size art (179 MB) now instead of when asked
 ```
 
+The package is the whole game. The one extra download is the full-size art, which only terminals
+that draw sixel images use. It never comes down on its own: on such a terminal azsh asks first,
+showing the size and the folder, or you fetch it with `--art` (that also works through
+`npx azeroth-shell --art`). It comes from this repo's `art-1` GitHub release, and every file is
+checked against the sha256 in `src/data/hd-art.json` before it is used. You don't need to know
+beforehand whether your terminal draws sixel, because azsh checks that itself.
+
 From a checkout: `npm install -g .` or `node bin/azsh.mjs`.
 
 Needs Node 22.18 or newer (it strips TypeScript types natively). No dependencies. The tree is
@@ -42,7 +50,7 @@ every screen redraws in place.
 
 | Key | Does |
 | --- | --- |
-| `1`-`9` `0`, `Tab`, `Left` `Right` | World, Quests, Bags, Gear, Spells, Rotation, Talents, Travel, Professions, Companions; Character is the last tab (`Tab`/`Left`) |
+| `1`-`9` `0`, `Tab`, `Left` `Right` | World, Quests, Bags, Character, Spells, Rotation, Talents, Travel, Professions, Companions; Settings is the last tab (`Tab`/`Left`) |
 | `Up` `Down` `j` `k` | move the cursor; the right pane describes the row |
 | `Enter` | act on the row: fight, open a quest, talk to a vendor or trainer, equip, cast, travel |
 | `Esc` | close the window on top; on a tab, back to World |
@@ -156,21 +164,24 @@ conditions hold fires.
 | `D` | target dummy: run the rotation against a dummy |
 | `A` | autopilot settings |
 
-### Gear and Bags
+### Character and Bags
 
-**Gear** shows every slot with what you wear. `Enter` on a slot lists everything in your bags (and
+**Character** shows every slot with what you wear, and your health, power, experience, money,
+attributes and combat ratings under the item tooltip; `s` opens the rest (weapon skills,
+professions, auras, home, pet, honor, reputation). `Enter` on a slot lists everything in your bags (and
 in the bank, in a bank town) that fits it, with the stat, armor and damage difference in the detail
 pane; `Enter` there puts it on. The engine's equipment helper scores your bags against what you
 wear: upgrades are listed at the top of the tab and marked `▲` in Bags. From 160 columns the tab is
 a character sheet: you in your gear in the middle, the worn pieces' icons down both sides, Shift+arrows
 walking the slots.
 
-![The Gear tab as a character sheet: a level 60 shaman in raid gear, the slots' icons on both sides, the cursor walking them](media/gear.gif)
+![The Character tab as a sheet: a level 60 shaman in raid gear, the slots' icons on both sides, the cursor walking them](media/gear.gif)
 
 | Key | Does |
 | --- | --- |
 | `Enter` on a slot | list what fits, then `Enter` to equip |
-| `u` (Gear or Bags) | put on every upgrade at once |
+| `s` | your stats, skills, auras, pet, honor and reputation |
+| `u` (Character or Bags) | put on every upgrade at once |
 | `x` | take a piece off |
 | `b` (Bags) | open the bank, in a bank town |
 | `g` (Bags) | open Send goods (see [Professions](#professions)) |
@@ -294,21 +305,41 @@ terminal's own retro effect (Windows Terminal: `"experimental.retroTerminalEffec
 profile; cool-retro-term elsewhere).
 
 At 90 columns or wider the creature you face is drawn beside the fight frames and under its detail
-on the World tab. Your own character, in the gear you wear, stands on the Character tab, on the
+on the World tab. Your own character, in the gear you wear, stands on the Character tab and its stats page, on the
 character picker, at creation and (from 130 columns) on the other side of the fight, and a
 companion's page shows them the same way. It is truecolour half-block art baked from the game's
 models; a terminal without 24-bit colour shows it in the nearest colours it has.
 
 A terminal that draws sixel images (Windows Terminal 1.22+, WezTerm, foot, iTerm2; VS Code with
-`terminal.integrated.enableImages`) gets every creature, every character in their gear and every
+`terminal.integrated.enableImages`) can draw every creature, every character in their gear and every
 icon in real pixels instead. azsh asks the terminal at start.
 
+The Travel tab has the world map under whatever you point at: both continents, a gold pin where you
+stand, a cyan one on the zone under the cursor and the planned route dotted between them, legs by
+sea and air included; on the road the pin walks its leg. It is the same terrain map the browser game
+pans around, as half-block cells or, on a sixel terminal, as pixels. Both of its packs are small enough
+to ship, so the map needs no download. The pane is short on a short terminal, and so is the map:
+give the window forty rows or more and it grows into them.
+
+The full-size art for that is not in the npm package: it is about 179 MB, too much to ship to every
+terminal that cannot draw it. When azsh finds a sixel terminal without it, it offers to download it
+from the project's GitHub release into `~/.azsh/art/`. Each file is checked against a sha256 the
+package carries. Answer "Not now" and it asks again next run; "Never ask" stops the prompt. `azsh --art` fetches it
+from the shell without starting the game. Until the
+art is there, the half-block art stays.
+
+| Command | Does |
+| --- | --- |
+| `:art` | say whether this terminal draws sixel and whether the full-size art is here |
+| `:art download` | fetch the full-size art now (progress on the hint row, the screen redraws when done) |
+
 ![The same hero on the create screen: half-block art on the left, sixel on the right](media/art-compare.png)
 
 | Variable | Does |
 | --- | --- |
 | `AZSH_SIXEL=0` | keep the half-block art |
 | `AZSH_SIXEL=1` | turn sixel on for a terminal that does not say |
+| `AZSH_ART_DIR` | read the full-size art from (and download it to) this folder instead |
 | `AZSH_HOME` | move the save folder (default `~/.azsh`) |
 
 ## Line mode and saves
@@ -368,6 +399,8 @@ npm run data:pack    # gzip the bake after a data refresh; data:unpack reverses
 npm run art:bake     # rebuild src/data/model-art.bin.gz from phonecraft's creature renders (needs ffmpeg)
 npm run art:gear     # rebuild src/data/gear-art.bin.gz from phonecraft's paperdoll bake (needs Python with Pillow)
 npm run art:icons    # rebuild src/data/icon-art.bin.gz from phonecraft's spell and item icons (needs ffmpeg)
+npm run art:map      # rebuild the Travel tab's world map, src/data/world-map.bin.gz and world-map-sixel.bin.br,
+                     # from phonecraft's combined Azeroth terrain map (needs ffmpeg)
 npm run art:hd       # rebuild the full-size art sixel draws: model-art-hd.bin.br, icon-art-hd.bin.br and
                      # gear-art-hd/<body>.bin.br (needs ffmpeg, and Python with Pillow for the gear)
 ```

package/bin/azsh.mjs

@@ -6,8 +6,22 @@ if (major < 22 || (major === 22 && minor < 18)) {
   console.error(`azsh needs Node 22.18 or newer (found ${process.versions.node}).`);
   process.exit(1);
 }
-await import('../src/cli/register.mjs');
 const argv = process.argv.slice(2);
+if (argv.includes('--art')) {
+  // Fetch the full-size art up front instead of waiting for the in-game offer; says what and from where first.
+  const { hdManifest, missingHdBytes, downloadHdArt, downloadDir } = await import('../src/cli/hdArt.mjs');
+  const m = hdManifest(), bytes = missingHdBytes();
+  if (!m) { console.error('This build has no art manifest.'); process.exit(1); }
+  if (!bytes) { console.log(`The full-size art is all here (${downloadDir()}).`); process.exit(0); }
+  console.log(`Fetching ${Math.round(bytes / 1e6)} MB of full-size art (${m.files.length} files, sha256-checked)\n  from ${m.base}\n  into ${downloadDir()}`);
+  const res = await downloadHdArt((done, total) => {
+    if (process.stdout.isTTY) process.stdout.write(`\r  ${Math.round(done / 1e6)} of ${Math.round(total / 1e6)} MB`);
+  });
+  if (process.stdout.isTTY) process.stdout.write('\n');
+  console.log(res.ok ? 'Done. A sixel terminal now draws creatures, characters and icons in real pixels.' : `Stopped: ${res.reason}`);
+  process.exit(res.ok ? 0 : 1);
+}
+await import('../src/cli/register.mjs');
 const wantRepl = argv.includes('--repl') || (!argv.includes('--tui') && (!process.stdin.isTTY || !process.stdout.isTTY));
 if (wantRepl) {
   const { main } = await import('../src/cli/repl.mjs');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azeroth-shell",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Azeroth shell. A WoW Classic 1.12 text RPG for the terminal, built on CMaNGOS data.",
   "keywords": [
@@ -30,7 +30,10 @@
     "src/",
     "!src/data/*-hd.bin.br",
     "!src/data/gear-art-hd/",
-    "docs/"
+    "!src/data/*.only.bin.br",
+    "!src/data/gear-art-hd.only/",
+    "docs/",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.18"
@@ -41,9 +44,10 @@
     "check": "node --import ./src/cli/register.mjs src/cli/bootCheck.mjs",
     "data:pack": "node scripts/pack-data.mjs",
     "data:unpack": "node scripts/pack-data.mjs --unpack",
-    "art:bake": "node scripts/bake-model-art.mjs",
+    "art:bake": "node scripts/bake-model-art.mjs && node scripts/bake-model-art.mjs --worn",
     "art:gear": "python scripts/bake-gear-art.py",
     "art:icons": "node scripts/bake-icon-art.mjs",
+    "art:map": "node scripts/bake-world-map.mjs && node scripts/bake-world-map.mjs --sixel",
     "art:hd": "node scripts/bake-model-art.mjs --hd && node scripts/bake-icon-art.mjs --hd && python scripts/bake-gear-art.py --hd",
     "art:publish": "node scripts/publish-hd-art.mjs",
     "build:exe": "node scripts/build-exe.mjs",

package/src/cli/hdArt.mjs

@@ -1,5 +1,5 @@
 // The full-size art sixel draws (sixel.mjs, modelArt.mjs): creature sprites, icons and one gear file per body,
-// about 72 MB, too much to ship to every terminal that cannot draw it. The package carries only the manifest
+// about 179 MB, too much to ship to every terminal that cannot draw it. The package carries only the manifest
 // (src/data/hd-art.json: the release tag, and each file's name, size and sha256); the files are assets of that
 // GitHub release, fetched on request into ~/.azsh/art/<tag>/ and checked against the manifest.
 //

package/src/cli/iconArt.mjs

@@ -8,7 +8,7 @@
 import { readFileSync } from 'node:fs';
 import { gunzipSync } from 'node:zlib';
 import { useColor, vis, wrapLines } from './text.mjs';
-import { sixelIconCells } from './sixel.mjs';
+import { sixelIconCells, sixelOn } from './sixel.mjs';
 
 const PACK_URL = new URL('../data/icon-art.bin.gz', import.meta.url);
 const SIZES = [8, 6, 4];
@@ -94,6 +94,16 @@ export function iconArt(name, cols = 4, tone = '') {
   return iconCells(name, cols, tone)?.map((row) => row.join('')) ?? null;
 }
 
+/**
+ * A one-line icon two cells wide and a space, to lead a line of text in a list (what someone wears, a
+ * quest's rewards). Only where the terminal draws sixel: as half-block cells it would be a smudge of colour,
+ * so there it is ''. A name with no art keeps the column with blanks.
+ */
+export function miniIcon(name) {
+  if (!sixelOn()) return '';
+  return `${iconArt(name, 2)?.[0] ?? '  '} `;
+}
+
 /** A blank the size of an icon, for rows in a list that mixes icons and none. */
 export const iconBlank = (cols = 4) => Array.from({ length: cols / 2 }, () => ' '.repeat(cols));
 

package/src/cli/modelArt.mjs

@@ -175,18 +175,21 @@ const gearHd = new Map(); // slug -> { buf, pal, canvas, skins, overlays } or nu
 export function forgetHdArt() { forgetSixelPacks(); gearHd.clear(); cache.clear(); }
 
 /** A body's hd file (scripts/bake-gear-art.py --hd): its palette, then the body section the small pack has
- *  for it. Read the first time the body is drawn; about 11 MB each once unpacked. */
+ *  for it. Version 1 (a release's 128 px bodies) holds the canvas and each x y w h in a byte, version 2 (256 px,
+ *  past a byte) in a u16. Read the first time the body is drawn. */
 function gearBodyHd(slug) {
   if (gearHd.has(slug)) return gearHd.get(slug);
   let body = null;
   try {
     const buf = brotliDecompressSync(readFileSync(hdArtPath(`gear-art-hd/${slug}.bin.br`)));
-    if (buf.toString('ascii', 0, 7) === 'AZGEARB' && buf[7] === 1) {
+    const version = buf[7];
+    if (buf.toString('ascii', 0, 7) === 'AZGEARB' && (version === 1 || version === 2)) {
       let off = 8;
+      const n = version === 2 ? 2 : 1, num = (o) => (n === 2 ? buf.readUInt16LE(o) : buf[o]);
       const palLen = buf[off++];
       const pal = buf.subarray(off, off + palLen * 3); off += palLen * 3;
       off += 1 + buf[off]; // the slug again
-      const canvas = buf[off++];
+      const canvas = num(off); off += n;
       body = { buf, pal, canvas, skins: new Map(), overlays: new Map() };
       const skinCount = buf[off++];
       for (let i = 0; i < skinCount; i++) { body.skins.set(buf[off], off + 1); off += 1 + canvas * canvas; }
@@ -194,7 +197,7 @@ function gearBodyHd(slug) {
       for (let i = 0; i < ovCount; i++) {
         const keyLen = buf[off++];
         const key = buf.toString('ascii', off, off + keyLen); off += keyLen;
-        const x = buf[off], y = buf[off + 1], w = buf[off + 2], h = buf[off + 3]; off += 4;
+        const x = num(off), y = num(off + n), w = num(off + 2 * n), h = num(off + 3 * n); off += 4 * n;
         body.overlays.set(key, { off, x, y, w, h });
         off += w * h;
       }

package/src/cli/oocPrep.mjs

@@ -0,0 +1,32 @@
+// Out-of-combat prep before a pull: the rotation's buffs phase (armours, Intellect, imbues, conjures, the pet)
+// cast standing still, not on the fight's first ticks. phonecraft autopilotController.ts prepOoc (:889) without
+// its fillMana: the mana the buffs cost stays spent, and the autopilot drinks it back before it pulls.
+import { pickOocAction, useOocPrepItem } from '../autopilot/combatRotation.ts';
+import { maxPower } from '../domain/character/character.ts';
+import { powerType } from '../domain/character/characterStats.ts';
+
+const MAX_PREP_ACTIONS = 8; // each pick is a guarded rule cast once; the cap keeps a refused rule from looping
+
+/** Cast what the buffs phase wants up. Returns the names cast and the mana left as a fraction (1 for non-mana). */
+export function prepOoc(g, ds) {
+  const cast = [];
+  for (let i = 0; i < MAX_PREP_ACTIONS; i++) {
+    const action = pickOocAction(g.rotation(), g.state, ds);
+    if (!action) break;
+    if (action.kind === 'spell') {
+      if (!g.castOutOfCombat(action.spellId).ok) break;
+      cast.push(ds.spell(action.spellId)?.name ?? `spell ${action.spellId}`);
+    } else if (action.kind === 'item') {
+      if (!useOocPrepItem(g, action)) break;
+      cast.push(ds.item(action.itemEntry)?.name ?? `item ${action.itemEntry}`);
+    } else break;
+  }
+  const ch = g.state.char;
+  const max = powerType(ch) === 'mana' ? maxPower(ch, ds) : 0;
+  return { cast: [...new Set(cast)], manaPct: max > 0 ? ch.power / max : 1 };
+}
+
+/** The log line for a prep that cast something, or null. */
+export function prepText(prep) {
+  return prep.cast.length ? `Buffed up: ${prep.cast.join(', ')}` : null;
+}

package/src/cli/repl.mjs

@@ -17,6 +17,7 @@ import { planStep, noteQuestDefeat } from '../autopilot/plan.ts';
 
 // Deaths on one quest before world questing gives up on it and moves to the next.
 const QUEST_SKIP_DEFEATS = 2;
+import { prepOoc, prepText } from './oocPrep.mjs';
 import { pullOpts, squadLogNames, squadModeOf, setSquadMode, SQUAD_MODE_LABEL, SQUAD_MODE_WORDS, COMPANION_HINT_LINES } from './squad.mjs';
 
 const useColor = stdout.isTTY && !process.env.NO_COLOR;
@@ -264,6 +265,8 @@ export function createCommands({ g, ds, out, persist, slot, arrive, skipJourney
 
   /** g.fight with the squad when the squad mode says so; the log names the companions. */
   const quickFight = (entry) => {
+    const buffed = prepText(prepOoc(g, ds));
+    if (buffed) out(dim(`  ${buffed}`));
     const opts = pullOpts(g, ds, buffPace, entry, (l) => out(dim(`  ${l}`)));
     const r = g.fight(entry, opts);
     return { r, logNames: opts ? squadLogNames(g, entry, names()) : names() };
@@ -603,6 +606,7 @@ export function createCommands({ g, ds, out, persist, slot, arrive, skipJourney
     let done = false;
     let lastKind = null;
     let lastQuest = null; // the quest the latest step worked on, blamed when the planner gives up
+    let restedForBuffs = false; // the pull's buffs already sent the run to rest once
     let stopReason = null; // why the run ended: the planner's stop step, or 'steps' when the step budget ran out
     const skipped = [];
     const inLog = (entry) => g.state.questlog.quests.some((qs) => qs.entry === entry && qs.status !== 'turnedIn');
@@ -653,6 +657,18 @@ export function createCommands({ g, ds, out, persist, slot, arrive, skipJourney
         switch (step.kind) {
           case 'fight': {
             const c = ds.creature(step.creatureEntry);
+            // Buff before the pull, then drink back what the buffs cost: casting them on the fight's first ticks
+            // sent a mage in at three quarters of its bar. Once per pull, so a buff that falls off while it
+            // drinks is recast without another rest.
+            const prep = prepOoc(g, ds);
+            const buffed = prepText(prep);
+            if (buffed && !restedForBuffs && cfg.restMode === 'eat-then-wait' && prep.manaPct < cfg.recoverToPct) {
+              restedForBuffs = true; prog.recovering = true; lastKind = 'buff';
+              line = `${buffed}  ${dim('rest before the pull')}`;
+              break;
+            }
+            restedForBuffs = false;
+            if (buffed) out(`${dim(String(i).padStart(3) + '.')} ${buffed}`);
             if (liveFight) {
               const started = liveFight(step, (r) => settle(r, step));
               if (!started.ok) { sets.blockedFights.add(step.creatureEntry); line = red(`fight ${c?.name}: ${started.reason}`); }

package/src/cli/sixel.mjs

@@ -9,8 +9,9 @@
 //
 // The pixels come from model-art-hd.bin.br (scripts/bake-model-art.mjs --hd): the same sprites as the
 // half-block pack at the renders' own size, up to 128 px wide; icons from icon-art-hd.bin.br. Neither ships in
-// the package: hdArt.mjs finds them (downloaded, or a checkout's bake). No pack, no sprite, or no sixel: null,
-// and the caller draws the half-block art. AZSH_SIXEL=0 turns it off, AZSH_SIXEL=1 on without asking.
+// the package: hdArt.mjs finds them (downloaded, or a checkout's bake). model-art-worn.bin.br does ship: the
+// forms and costumes a player wears, read for any sprite the hd pack lacks. No pack, no sprite, or no sixel:
+// null, and the caller draws the half-block art. AZSH_SIXEL=0 turns it off, AZSH_SIXEL=1 on without asking.
 import { readFileSync } from 'node:fs';
 import { brotliDecompressSync } from 'node:zlib';
 import { useColor } from './text.mjs';
@@ -36,35 +37,46 @@ export function noteDeviceAttributes(params) {
 export function noteCellSize(h, w) {
   if (h > 0 && w > 0) { cellH = h; cellW = w; }
 }
+/** The cell in pixels, { w, h }: what a caller fitting its own picture to a pane sizes by. */
+export const cellSize = () => ({ w: cellW, h: cellH });
 
 // ---- the source images ------------------------------------------------------------------------------
 
-let index = null; // displayId -> byte offset of the sprite in `pack` (the half-block pack's layout, AZART v1)
-let pack = null;
+const WORN_URL = new URL('../data/model-art-worn.bin.br', import.meta.url);
+let index = null; // displayId -> { pack, off }: the sprite's bytes (the half-block pack's layout, AZART v1)
 
-function load() {
-  if (index) return index;
-  index = new Map();
+/** Index one pack's sprites; an id already indexed keeps the pack it came from. */
+function indexPack(file) {
   try {
-    pack = brotliDecompressSync(readFileSync(hdArtPath('model-art-hd.bin.br')));
-    if (pack.toString('ascii', 0, 5) !== 'AZART' || pack[5] !== 1) return index;
+    const pack = brotliDecompressSync(readFileSync(file));
+    if (pack.toString('ascii', 0, 5) !== 'AZART' || pack[5] !== 1) return;
     const count = pack.readUInt32LE(6);
     let off = 10;
     for (let i = 0; i < count && off + 7 <= pack.length; i++) {
-      index.set(pack.readUInt32LE(off), off);
+      const id = pack.readUInt32LE(off);
+      if (!index.has(id)) index.set(id, { pack, off });
       off += 7 + pack[off + 6] * 3 + pack[off + 4] * pack[off + 5];
     }
-  } catch { pack = null; }
+  } catch { /* no pack: its sprites draw half-block */ }
+}
+
+function load() {
+  if (index) return index;
+  index = new Map();
+  const hd = hdArtPath('model-art-hd.bin.br');
+  if (hd) indexPack(hd);
+  indexPack(WORN_URL);
   return index;
 }
 
 /** Forget the packs (and what was missing) so the next draw reads them again: after a download. */
-export function forgetSixelPacks() { index = pack = iconIndex = iconPack = null; images.clear(); byKey.clear(); }
+export function forgetSixelPacks() { index = iconIndex = iconPack = null; images.clear(); byKey.clear(); }
 
 /** The sprite for a display id as { w, h, rgba } (already cropped to its opaque box), or null. */
 function sourceOf(displayId) {
-  const off = load().get(displayId);
-  if (off == null) return null;
+  const at = load().get(displayId);
+  if (!at) return null;
+  const { pack, off } = at;
   const w = pack[off + 4], h = pack[off + 5], palLen = pack[off + 6], pal = off + 7, idx = pal + palLen * 3;
   const rgba = new Uint8Array(w * h * 4);
   for (let i = 0; i < w * h; i++) {

package/src/cli/text.mjs

@@ -1,6 +1,7 @@
 // Text helpers shared by the line REPL and the windowed TUI: quest text codes, wrapping, fuzzy
 // picking, ANSI colour and visible-width maths. Nothing here touches game state.
 import { className, raceName } from '../domain/core/ids.ts';
+import { coinParts, moneyText } from '../domain/economy/money.ts';
 
 export const useColor = !process.env.NO_COLOR;
 // A reset inside the painted text (a coloured item name in a green sentence) re-opens this paint,
@@ -25,6 +26,21 @@ export function qualityPaint(quality) { return QUALITY_PAINT[quality ?? 1] ?? wh
 /** An item record's name in its quality colour; `fallback` when the record is missing. */
 export function itemText(it, fallback = 'item') { return qualityPaint(it?.quality)(it?.name ?? fallback); }
 
+// The client's coin colours. A count is followed by its coin, as the money frame draws it: 1● 20● 5●.
+const COIN_RGB = { g: [255, 210, 0], s: [205, 205, 215], c: [205, 120, 55] };
+const COIN = Object.fromEntries(Object.entries(COIN_RGB).map(([k, [r, g, b]]) => [k, `\x1b[38;2;${r};${g};${b}m●\x1b[0m`]));
+/** One coin, 'g', 's' or 'c', for a count written by hand; the letter without colour. */
+export const coin = (k) => (useColor ? COIN[k] : k);
+/** Copper as counts and coins (gold, silver, copper in their colours), an empty copper left off after a
+ *  bigger coin as the client does; `zero` stands in for nothing when given ('free'). Without colour the
+ *  letters: 1g 20s 5c. The counts take whatever paint is round them. */
+export function coinText(copper, zero) {
+  if (zero != null && !(copper > 0)) return zero;
+  if (!useColor) return moneyText(copper);
+  const parts = coinParts(copper);
+  return parts.filter((p, i) => p.n || i === 0).map((p) => `${p.n}${COIN[p.k]}`).join(' ');
+}
+
 const GENDER_TOKEN = /\$[Gg]\s*([^:]*):([^;]*);/g;
 /** $N name, $C class, $R race, $B break, $G male:female; (SharedDefines.h:26). Same codes as phonecraft questText. */
 export function questText(raw, ch) {