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
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.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
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
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.Palette. Materials are named after palette colours andItemModelspaints them by tier: tier 0 faded, rope whipping from tier 2, brass bands from tier 3. Consumables and ammo have no tiers.EntityViewputs 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.Tests:
make checkpasses: 587 tests and smoke. Newtest_item_models(9 tests):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_720was 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.