A4 Weapon, tool and item models #44

Closed
opened 2026-11-09 05:28:35 +00:00 by claude · 1 comment
Owner

Depends on: A1, B7

Generate models with scripted Blender for every weapon, tool, consumable and pickup, each with a distinct silhouette and a tier treatment.

Acceptance

  • Every item definition has a model and an icon, enforced by a test.
  • First-person hand and third-person attachment points line up in captures.
**Depends on:** A1, B7 Generate models with scripted Blender for every weapon, tool, consumable and pickup, each with a distinct silhouette and a tier treatment. **Acceptance** - Every item definition has a model and an icon, enforced by a test. - First-person hand and third-person attachment points line up in captures.
claude added this to the v0.6 Art, Audio and UI milestone 2026-11-09 05:28:35 +00:00
claude added the type/featurepriority/high labels 2026-11-09 05:28:35 +00:00
claude added this to the Tidewall v1.0 project 2026-11-09 15:00:08 +00:00
eric referenced this issue from a commit 2026-11-13 19:46:45 +00:00
eric closed this issue 2026-11-13 19:46:45 +00:00
Author
Owner

Done in 0991f27.

What changed

  • tools/models/items.py (headless Blender, CPU only) builds all 18 items from primitives: the boathook, eight weapons and the powder keg, four consumables and five kinds of ammo. Each has its own outline: the fowling piece's bell mouth, the repeater's rivet drum, the longgun's spotting glass, the line thrower's canister, the harpoon standing out of its gun, and so on. Outputs:
    • assets/models/items/<id>.obj + .json: the grip at the origin, the working end toward +Z, and a support point for the left hand on long weapons.
    • assets/icons/items/<id>.png: 128 px, rendered with Cycles on the CPU.
  • OBJ rather than glTF, because the Debian Blender's glTF exporter needs numpy, which isn't installed.
  • Colours stay in Palette. Materials are named after palette colours and ItemModels paints them by tier: tier 0 faded, rope whipping from tier 2, brass bands from tier 3. Consumables and ammo have no tiers.
  • EntityView puts the held item in each figure's right hand and turns it with the player's pitch. It's put away aboard the barge, falling, gliding or swimming. Remote players use the snapshot's held code. Items lying in the world use their models, resting on the ground.
  • The hotbar shows each slot's icon. Slots are taller, and the round counts no longer touch the tier pips.

Tests: make check passes: 587 tests and smoke. New test_item_models (9 tests):

  • every item has a model, an icon and grip data; its grip is on the model and it's item-sized
  • weapons point forward and long ones have a support point
  • every outline differs, and every surface is a Palette colour
  • tier trims are added at the right tiers
  • figures hold the right item, point it up when looking up, and put it away to glide
  • remote held codes and lying pickups are drawn, every model resting on the ground
  • the hotbar carries icon IDs

Captures, from make item-captures, all opened and looked at (software rendering):

  • items_held: ten players in a row, each holding a different item, seen from their right. Grips are in the right hand at chest height.
  • items_shoulder: the game's aiming camera over the shoulder of a player with the longgun. The barrel and sight are in view past the shoulder. The first version had the stock poking out of the coat, so the hand moved forward and in.
  • items_tiers: the carbine at tiers 0 to 3, side by side.
  • items_ground: every item lying on the grass. The first layout overlapped, so it was spread out.
  • hud_720 was re-rendered with icons in the hotbar.

Not covered: there are no hand animations or left-hand IK yet. The support point is in the data for A2's figure to use. The figures are still A2's stand-ins.

Done in 0991f27. **What changed** - `tools/models/items.py` (headless Blender, CPU only) builds all 18 items from primitives: the boathook, eight weapons and the powder keg, four consumables and five kinds of ammo. Each has its own outline: the fowling piece's bell mouth, the repeater's rivet drum, the longgun's spotting glass, the line thrower's canister, the harpoon standing out of its gun, and so on. Outputs: - `assets/models/items/<id>.obj` + `.json`: the grip at the origin, the working end toward +Z, and a support point for the left hand on long weapons. - `assets/icons/items/<id>.png`: 128 px, rendered with Cycles on the CPU. - OBJ rather than glTF, because the Debian Blender's glTF exporter needs numpy, which isn't installed. - Colours stay in `Palette`. Materials are named after palette colours and `ItemModels` paints them by tier: tier 0 faded, rope whipping from tier 2, brass bands from tier 3. Consumables and ammo have no tiers. - `EntityView` puts the held item in each figure's right hand and turns it with the player's pitch. It's put away aboard the barge, falling, gliding or swimming. Remote players use the snapshot's held code. Items lying in the world use their models, resting on the ground. - The hotbar shows each slot's icon. Slots are taller, and the round counts no longer touch the tier pips. **Tests:** `make check` passes: 587 tests and smoke. New `test_item_models` (9 tests): - every item has a model, an icon and grip data; its grip is on the model and it's item-sized - weapons point forward and long ones have a support point - every outline differs, and every surface is a Palette colour - tier trims are added at the right tiers - figures hold the right item, point it up when looking up, and put it away to glide - remote held codes and lying pickups are drawn, every model resting on the ground - the hotbar carries icon IDs **Captures**, from `make item-captures`, all opened and looked at (software rendering): - `items_held`: ten players in a row, each holding a different item, seen from their right. Grips are in the right hand at chest height. - `items_shoulder`: the game's aiming camera over the shoulder of a player with the longgun. The barrel and sight are in view past the shoulder. The first version had the stock poking out of the coat, so the hand moved forward and in. - `items_tiers`: the carbine at tiers 0 to 3, side by side. - `items_ground`: every item lying on the grass. The first layout overlapped, so it was spread out. - `hud_720` was re-rendered with icons in the hotbar. **Not covered:** there are no hand animations or left-hand IK yet. The support point is in the data for A2's figure to use. The figures are still A2's stand-ins.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: claude/tidewall#44