chore: tie items.md to Epic 3 modules; add combat pillars stub

- items.md: E3.M3 contract summary, Epic 3 module map table, expanded where-next
- overview.md: Combat pillars vision stub with Items row; fix artifact cross-links
- abilities.md: pointer to overview combat pillars stub
pull/18/head
VinPropane 2026-04-03 21:44:49 -04:00
parent 940cc71840
commit f45a5d8c06
3 changed files with 40 additions and 7 deletions

View File

@ -2,7 +2,7 @@
Vision for **what the player triggers** in play: combat **kits**, non-combat **skill interactions**, and **item**-carried actions—and how those map to **gigs**, **`SkillDef`**, and **Seams**. This is **not** a full ability list or data schema; it steers combat design, UX, and implementation boundaries. Vision for **what the player triggers** in play: combat **kits**, non-combat **skill interactions**, and **item**-carried actions—and how those map to **gigs**, **`SkillDef`**, and **Seams**. This is **not** a full ability list or data schema; it steers combat design, UX, and implementation boundaries.
**Framing:** [progression.md](progression.md) (**gig** vs **skill**). **Combat roles:** [gigs.md](gigs.md). **Gear, craft, consumables:** [skills.md](skills.md) **Seams** ([anchor](skills.md#seams-gigs-skills)). **Item buckets & acquisition:** [items.md](items.md). **Framing:** [progression.md](progression.md) (**gig** vs **skill**). **Combat roles:** [gigs.md](gigs.md). **Gear, craft, consumables:** [skills.md](skills.md) **Seams** ([anchor](skills.md#seams-gigs-skills)). **Item buckets & acquisition:** [items.md](items.md). **Combat pillar pointers:** [overview.md — Combat pillars](overview.md#combat-pillars-vision-stub).
## Vocabulary ## Vocabulary

View File

@ -1,6 +1,8 @@
# Items (loot, craft, equip) # Items (loot, craft, equip)
Vision for **what exists in the world as tangible “things”**: how items are **categorized**, **acquired**, **gated** by **gigs** vs **skills**, and how they connect to **combat**, **economy**, and **quests**. Not an `ItemDef` schema—that lives under [Epic 3 — Crafting economy](../decomposition/epics/epic_03_crafting_economy.md) and [`content/`](../../content/README.md) when wired. Vision for **what exists in the world as tangible “things”**: how items are **categorized**, **acquired**, **gated** by **gigs** vs **skills**, and how they connect to **combat**, **economy**, and **quests**.
**Schema ownership:** [E3.M3 — ItemizationAndInventorySchema](../decomposition/modules/E3_M3_ItemizationAndInventorySchema.md) versions **`ItemDef`** (template), **`ItemInstance`** (per-item state: stack, durability hook, binds), and **`InventorySlot`** (containers)—that is where **rarity**, **quality**, **stack rules**, and **equipment metadata** land. Broader loop and slices: [Epic 3](../decomposition/epics/epic_03_crafting_economy.md); authored data under [`content/`](../../content/README.md) when wired.
**Seams (authoritative detail):** [skills.md — Seams (gigs ↔ skills)](skills.md#seams-gigs-skills). **Actions from items:** [abilities.md](abilities.md) **Item-linked actions**. **Hybrid vocabulary:** [progression.md](progression.md). **Seams (authoritative detail):** [skills.md — Seams (gigs ↔ skills)](skills.md#seams-gigs-skills). **Actions from items:** [abilities.md](abilities.md) **Item-linked actions**. **Hybrid vocabulary:** [progression.md](progression.md).
@ -34,6 +36,18 @@ These overlap in data; they are **lenses** for writers and systems.
- **Hub-only** [gig swap](gigs.md#hub-swap): **combat gear** may **invalidate** until the player **re-banks or re-equips**; **cybernetics** stay. - **Hub-only** [gig swap](gigs.md#hub-swap): **combat gear** may **invalidate** until the player **re-banks or re-equips**; **cybernetics** stay.
- **Presets** (per gig pair, per role) vs **manual** fix-up—**open** UX ([gigs.md](gigs.md), [abilities.md](abilities.md)). - **Presets** (per gig pair, per role) vs **manual** fix-up—**open** UX ([gigs.md](gigs.md), [abilities.md](abilities.md)).
## Epic 3 module map
Design **buckets** above are not 1:1 types in data—they inform tags and metadata on **`ItemDef`** / **`ItemInstance`**. Module responsibilities from [Epic 3](../decomposition/epics/epic_03_crafting_economy.md):
| Module | Role | Ties to this doc |
|--------|------|-------------------|
| [E3.M1](../decomposition/modules/E3_M1_ResourceNodeAndGatherLoop.md) | Nodes, gather, yields | **Materials**; feeds refine/craft |
| [E3.M2](../decomposition/modules/E3_M2_RefinementAndRecipeExecution.md) | Recipes, craft execution | **Crafted** acquisition; **skills**-only bench |
| [E3.M3](../decomposition/modules/E3_M3_ItemizationAndInventorySchema.md) | `ItemDef` / `ItemInstance` / slots | **All buckets**; rarity/quality/stack/equip |
| [E3.M4](../decomposition/modules/E3_M4_SinkAndDurabilityLifecycle.md) | Durability, repair, sinks | [Open questions](#open-questions); death doc |
| [E3.M5](../decomposition/modules/E3_M5_EconomyBalancePolicy.md) | Faucets/sinks policy | Drops vs craft **balance**; trade velocity |
## Decisions log ## Decisions log
| Topic | Direction | Status | | Topic | Direction | Status |
@ -57,5 +71,11 @@ These overlap in data; they are **lenses** for writers and systems.
|--------|-------------------| |--------|-------------------|
| Gig ↔ item rules (detail) | [skills.md](skills.md) **Seams** | | Gig ↔ item rules (detail) | [skills.md](skills.md) **Seams** |
| Abilities from items | [abilities.md](abilities.md) | | Abilities from items | [abilities.md](abilities.md) |
| Gathering & recipes (runtime) | [Epic 3](../decomposition/epics/epic_03_crafting_economy.md), [E3.M2](../decomposition/modules/E3_M2_RefinementAndRecipeExecution.md), [E3.M3](../decomposition/modules/E3_M3_ItemizationAndInventorySchema.md) | | Combat pillars (vision stub) | [overview.md — Combat pillars](overview.md#combat-pillars-vision-stub) |
| Epic 3 loop & slices | [Epic 3](../decomposition/epics/epic_03_crafting_economy.md) |
| Gather nodes | [E3.M1](../decomposition/modules/E3_M1_ResourceNodeAndGatherLoop.md) |
| Recipes & craft pipeline | [E3.M2](../decomposition/modules/E3_M2_RefinementAndRecipeExecution.md) |
| Item schema & inventory | [E3.M3](../decomposition/modules/E3_M3_ItemizationAndInventorySchema.md) |
| Sinks & durability | [E3.M4](../decomposition/modules/E3_M4_SinkAndDurabilityLifecycle.md) |
| Economy policy | [E3.M5](../decomposition/modules/E3_M5_EconomyBalancePolicy.md) |
| Encounter loot routing | [E5.M3](../decomposition/modules/E5_M3_EncounterAndRewardTables.md), [E7.M2](../decomposition/modules/E7_M2_RewardAndUnlockRouter.md) | | Encounter loot routing | [E5.M3](../decomposition/modules/E5_M3_EncounterAndRewardTables.md), [E7.M2](../decomposition/modules/E7_M2_RewardAndUnlockRouter.md) |

View File

@ -25,8 +25,8 @@ Neon Sprawls design work here starts from **concrete visions** of progression
| [progression.md](progression.md) | Shared **gig + skill** vision, vocabulary, links | Start here for progression | | [progression.md](progression.md) | Shared **gig + skill** vision, vocabulary, links | Start here for progression |
| [skills.md](skills.md) | Non-combat **skills**; seams; **v0 skill roster** by category | With [gigs.md](gigs.md); roster encodes **Hardshell** / **Softshell** / **Edgesmith** / **Rigging** equip vs **combat-deploy** rules ([Seams](skills.md#seams-gigs-skills)) | | [skills.md](skills.md) | Non-combat **skills**; seams; **v0 skill roster** by category | With [gigs.md](gigs.md); roster encodes **Hardshell** / **Softshell** / **Edgesmith** / **Rigging** equip vs **combat-deploy** rules ([Seams](skills.md#seams-gigs-skills)) |
| [gigs.md](gigs.md) | **9-gig roster** (v1 cyberpunk names); hub, sub-gig, party | Recruitment **deferred**; PvP **open indefinite**; niche LFG **if** tool ships | | [gigs.md](gigs.md) | **9-gig roster** (v1 cyberpunk names); hub, sub-gig, party | Recruitment **deferred**; PvP **open indefinite**; niche LFG **if** tool ships |
| [abilities.md](abilities.md) | **Combat** gig kits vs **skill** interactions vs **item** channels; Seams hooks | With [gigs.md](gigs.md), [skills.md](skills.md); **combat pillars** still stub in this overview | | [abilities.md](abilities.md) | **Combat** gig kits vs **skill** interactions vs **item** channels; Seams hooks | With [gigs.md](gigs.md), [skills.md](skills.md); [Combat pillars (vision stub)](#combat-pillars-vision-stub) |
| [items.md](items.md) | Buckets (gear, chrome, consumables, mats); craft vs drops; rarity/readability | **Seams** in [skills.md](skills.md); **Epic 3** for implementation | | [items.md](items.md) | Buckets (gear, chrome, consumables, mats); craft vs drops; rarity/readability | **Seams** in [skills.md](skills.md); **Epic 3 module map** in [items.md](items.md#epic-3-module-map) |
| [brainstorm/hack-bodyguard-missions.md](brainstorm/hack-bodyguard-missions.md) | Split **skill** (hack) + **gig** (bodyguard) instances—idea capture | Brainstorm | | [brainstorm/hack-bodyguard-missions.md](brainstorm/hack-bodyguard-missions.md) | Split **skill** (hack) + **gig** (bodyguard) instances—idea capture | Brainstorm |
| *(add rows as files land)* | | | | *(add rows as files land)* | | |
@ -39,12 +39,12 @@ Link new files here when they exist; remove or rewrite this subsection once the
- **Travel & connections** — how places link (gates, costs, downtime, danger en route); complements zone identity. - **Travel & connections** — how places link (gates, costs, downtime, danger en route); complements zone identity.
- **Mechanics** — loops, constraints, what the server vs. client must honor. - **Mechanics** — loops, constraints, what the server vs. client must honor.
- **Items** — [items.md](items.md): categories, rarity philosophy, crafting vs. drops; **Seams** for gig/skill gates. - **Items** — [items.md](items.md): categories, rarity philosophy, crafting vs. drops; **Seams** for gig/skill gates.
- **Abilities** — [abilities.md](abilities.md): inputs, timing; combo with items; **gig** vs **skill** gates (see [progression.md](progression.md) vocabulary). **Combat pillars** stub remains below until written. - **Abilities** — [abilities.md](abilities.md): inputs, timing; combo with items; **gig** vs **skill** gates (see [progression.md](progression.md) vocabulary). **Combat context:** [Combat pillars (vision stub)](#combat-pillars-vision-stub).
- **Gathering & resources** — nodes, competition, exhaustion, what “open world” contesting feels like. - **Gathering & resources** — nodes, competition, exhaustion, what “open world” contesting feels like.
- **Crafting & recipes** — depth vs. breadth, failure, specialization; pairs with items but is its own loop. - **Crafting & recipes** — depth vs. breadth, failure, specialization; pairs with items but is its own loop.
- **Economy** — currency velocity, sinks, trade vs. self-sufficiency, how wealth shows up in play. - **Economy** — currency velocity, sinks, trade vs. self-sufficiency, how wealth shows up in play.
- **Factions & reputation** — who remembers you, grudges, access gates; **gig** story arcs: [gigs.md](gigs.md), rep + seams: [skills.md](skills.md). - **Factions & reputation** — who remembers you, grudges, access gates; **gig** story arcs: [gigs.md](gigs.md), rep + seams: [skills.md](skills.md).
- **Combat pillars**PvE vs. PvP stance, readability, time-to-kill, what “fair” means here. - **Combat pillars**[Vision stub below](#combat-pillars-vision-stub): PvE vs. PvP stance, readability, time-to-kill, fairness; **items in combat** in [items.md](items.md).
- **Death, loss & recovery** — stakes on failure, recovery paths, anti-grief boundaries. - **Death, loss & recovery** — stakes on failure, recovery paths, anti-grief boundaries.
- **Risk & security bands** — safe pockets vs. wild space; where optional PvP and theft sit (aligns with security-tier thinking). - **Risk & security bands** — safe pockets vs. wild space; where optional PvP and theft sit (aligns with security-tier thinking).
- **Social play** — squad scale, corps, trust, betrayal affordances, async cooperation. - **Social play** — squad scale, corps, trust, betrayal affordances, async cooperation.
@ -52,6 +52,19 @@ Link new files here when they exist; remove or rewrite this subsection once the
- **Onboarding** — first session hook, clarity vs. mystery, how much systems the new player sees. - **Onboarding** — first session hook, clarity vs. mystery, how much systems the new player sees.
- **Tone & narrative** — how lore shows up (quests, environment, UI), voice of the world. **Presentation / ~teen rating target:** [Presentation and target rating (vision)](#presentation-and-target-rating-vision). - **Tone & narrative** — how lore shows up (quests, environment, UI), voice of the world. **Presentation / ~teen rating target:** [Presentation and target rating (vision)](#presentation-and-target-rating-vision).
## Combat pillars (vision stub)
Combat is still missing a **single** pillar doc. Until then, use this table for **where** vision lives:
| Pillar | Where to read |
|--------|----------------|
| **Gig kits, inputs, skill vs item actions** | [abilities.md](abilities.md) |
| **Combat gear, loadouts, hub swap, consumables** | [items.md](items.md) (with [skills.md](skills.md) **Seams**) |
| **Roster, roles, party, sub-gig** | [gigs.md](gigs.md) |
| **PvE readability, TTK, encounter fairness** | Stub—future dedicated combat doc; implementation direction in [Epic 5 — PvE combat](../decomposition/epics/epic_05_pve_combat.md) |
**Items in fights:** [items.md](items.md) **Combat gear** is **gig**-tagged for equip/deploy; **consumables** baseline is not gig-gated; **chrome** persists across gig swap. Aligns with [abilities.md](abilities.md) **Item-linked actions**.
## Related repo docs ## Related repo docs
| Area | Location | | Area | Location |