Tools, weapons & armour (tiered tool system)

[MichaelFisher1997]

Depends on #1 (crafting) for shaped recipes, #2 (ores) for tier materials, and #3 (smelting) to turn ores into usable ingots. Build last of the four interlocking survival systems.

Context

src/game/Items.ts:7-8 explicitly defers tools: the comment notes "Item ids are strings so the registry can grow to tools/materials later" — but ItemDef.icon (line 27) currently only supports "block" | "food". There are no pickaxe/axe/shovel/sword/hoe items and no tool-tier mining logic.

Scope

• src/game/Items.ts — extend ItemDef to support tools:
  • category: "tool" | "weapon" | "armour" added to the icon/union
  • tier: "wood" | "stone" | "copper" | "iron" | "gold" | "diamond"
  • toolType: "pickaxe" | "axe" | "shovel" | "sword" | "hoe"
  • durability: number, miningSpeed: number, damage: number
  • Mining-tier requirements per block (e.g. diamond ore needs iron-tier+)
• Tool textures — either a new item atlas or reuse the block atlas tiles (coordinate with Textures.ts; atlas has spare tiles).
• src/game/Recipes.ts (from Voxel lighting + day/night cycle (sun, moon, two-channel shading) #1) — shaped recipes for each tool across all tiers (pickaxe = 3 head + 2 sticks, etc.).
• Mining speed + durability — wire into the mining code path (in Game.ts around the right-click/mining handler ~Game.ts:723, and PlayerState.ts). Each block mined decrements durability; speed scales by tier vs. block hardness.
• Weapons — sword damage + knockback + i-frames in the combat path (combat itself is Phase 3, but the item/damage plumbing lands here).
• Armour — helmet/chestplate/leggings/boots slots in inventory; damage-soak hook in PlayerState.ts damage handling.
• src/ui/InventoryUI.ts + ui.css — durability bar overlay on hotbar/inventory slots; armour slot panel.

Acceptance criteria

• Craft a wooden pickaxe; mining stone is visibly faster than hand-mining and consumes durability.
• Iron-tier pickaxe required to mine diamond ore (tier gating from Add survival/creative modes, inventory, and robust mouse input #2).
• Sword deals more damage than bare hand; armour reduces incoming damage.
• Tools show a durability overlay and break at 0 durability.
• All tools craftable from Voxel lighting + day/night cycle (sun, moon, two-channel shading) #1's recipe system and tier materials from Add survival/creative modes, inventory, and robust mouse input #2/Graphics & performance pass: presets, perf overlay, water, debug tooling #3.

Roadmap reference

Phase 2 — "Tools, weapons & armour".