neon-sprawl/docs/game-design/skills.md

105 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Gigs & skills (hybrid progression)
Vision-level design for how characters grow. **Combat** uses **gigs** (swap roles for grouping clarity); **each gig levels on its own track** (**per-gig** progression). **Non-combat** uses **skills** (gathering, crafting, and similar loops). [Epic 2 — Classless progression](../decomposition/epics/epic_02_classless_progression.md) (E2.M1M4) still describes **skill** XP machinery; **gig** XP/levels are **per gig**—decomposition should be revisited when this split hardens.
## Vocabulary
From here on in game-design docs:
| Term | Means |
|------|--------|
| **Gig** | The **combat role** (combat “class”): what you bring to a fight—kit, tuning band, party expectations. Not used for crafting or gathering. |
| **Skill** | A **non-combat** trained capability only (gather, craft, etc.). Never used to mean the combat gig. |
| **Sub-gig** | A **secondary gig** paired with your **main gig** on one loadout. Used for **limited** cross-gig ability access—see [Sub-gigs](#sub-gigs-ffxi-style) below—not for crafting or replacing the main gigs identity in combat. |
Fiction and UI may still say *job*, *contract*, or *loadout* in dialogue; design vocabulary stays **gig** / **skill** to avoid ambiguity.
## Why hybrid
- **Gigs** give parties a readable answer to “what are you on this run?” without forcing alts. They match **contracts, loadouts, and corporate muscle** as fantasy.
- **Skills** keep the **economy and crafting** surface wide: anyone can work those capabilities over time, and “street doc” can mean high medic **craft skill** + rep, not only an active gig.
## Gigs (combat)
A **gig** is the **combat identity** you bring to a fight: ability access, baseline tuning band, and party expectations (tank, support, control, damage, etc.).
- **Swap rules (agreed):** **No on-the-fly swap.** Changing **main gig**, **sub-gig**, or both happens only at a **safe hub**—a **city**, **home base**, or other **designated swap location** (world/data-defined). Not in the field, not mid-combat. **Open:** exact site list, fees, faction gates, or cooldowns at the hub.
- **Combat progression (agreed):** **Per gig.** Each gig has its **own level/XP track** (and later mastery/perks on that gig). There is **no** shared single “combat rank” that advances all gigs at once. **Open:** when gig XP is awarded (e.g. only while main, sub, or both).
- **Mastery/perks** can attach to **gigs** (combat expression) while **skills** use the same *idea* for craft depth (E2.M3-style), or stay separate—**open**.
### Sub-gigs (FFXI-style)
**Agreed:** each loadout has a **sub-gig** slot so one character mixes two gigs without full dual-main power. That opens a **large space of creative builds** as the gig roster grows—no need to enumerate counts; the point is **breadth of choice**.
- **Reference pattern (FFXI-style):** at **main gig** per-gig level **X**, the **sub-gig** contributes abilities (and any sub-gated systems) only up to an **effective sub level** of **⌊X / 2⌋** (and not above the **sub-gigs own trained level**—**open** how `min`/`floor` interacts). Exact floor/rounding **TBD**.
- **Intent:** hybrid builds and party coverage (e.g. main damage + sub support tools) without letting a sub match a fully leveled second gig.
- **Still open:** **gear** (likely still **main-gigrestricted** for combat gear; sub only feeds **abilities**), **consumable** amplification (main vs. sub), **PvP** ceilings, and UI (two gig strips on HUD). **Sub-gig** choice changes use the same **hub-only** rules as main gig swap.
## Skills (non-combat, classless)
Everything **outside combat role resolution**—gathering, refining, crafting lines, non-combat tech, etc.—uses **skills**:
- **Any character can train any skill** over time (subject to world gates: discovery, rep, licenses—those expand content, they are not “you picked the wrong gig”).
- **Identity** for “what you do in the economy” is the **skill graph + reputation + gear**, not the gig you ran last night.
- **Long-term:** avoid dead-end grinds; slow or expensive is fine, “wrong choice forever” is not.
### What counts as a skill
A **skill** is a persistent, leveled capability improved primarily by **doing the activity** (chop, refine, assemble, etc.). Supplementary sources (books, training) stay optional. Skills stay **data-defined** (stable IDs, categories, prerequisites).
### Categories (families)
Categories group skills for **UI and balance** (e.g. *Gathering*, *Craft*, *Tech*, *Social*). They are **not** gigs and do not replace them.
### XP, failure, caps, pacing (skills)
- **Server-authoritative** grants with structured sources (node, recipe, mission payout, …).
- **Failure XP** (XP on a **failed attempt** at a skill action—e.g. burnt recipe—not **death penalty**): **per skill / per mechanic**; **open** globally, will depend on how each activity is built and what exploit surface it has.
- **Caps:** **Soft** only—no hard “max level” by default. **Each level needs more XP than the last** (threshold tables or formula; **data-driven** per skill or policy).
- **Runaway mitigation** beyond the curve: diminishing returns, context modifiers, or other knobs if telemetry demands.
- **Gates** (recipes, rep, licenses) should **add** paths, not fake gigs.
- **Pacing/catch-up** (E2.M4) applies across **skills**; **gig** pacing is **per-gig** (same or parallel engine—**open**).
## Seams (gigs ↔ skills)
| Topic | Direction |
|--------|-----------|
| **Combat gear** | **Gig-restricted.** Weapons, armor, and other combat-loadout pieces declare which **gig(s)** may equip or fully activate them. After a **hub-only** [gig swap](#gigs-combat), the player **re-banks or re-equips** combat gear for the new gig (automation vs. manual loadout UX **open**). Non-combat tools (pickaxe, scanner, craft bench) stay **skill**-gated, not gig-gated, unless a piece is explicitly hybrid. |
| **Crafting combat gear** | **No gig or gig level requirement.** Who can *build* it depends on **skills** (e.g. gunsmith), recipes, rep, facilities—never on owning a gig or its level. A character can **craft combat gear they cannot equip** (wrong gig, low gig level, etc.): valid for **trade**, **stock**, or **group play**. **Equip/activation** stays **gig-restricted** as above. |
| **Consumables** | **Carry and use** are not gig-gated by default—anyone can pop a stim or patch. **Potency can scale with gig:** e.g. a **medic** (or medic-adjacent gig) gets **bonus healing / duration / cleanse** from the same med consumable that others use at a **baseline**. Other consumables may have **no** gig hook, or hooks for other gigs—data-driven per item. |
| **Rep / story** | **Hybrid.** **Faction / world reputation** stays **character-wide** where it fits (one person, one web of grudges). **Narrative** also includes **gig storylines** and **main-quest-style arcs** tied to a **gig**—mentor paths, employer chains, identity stories that assume you *are* that role for a chapter. State for those arcs is **per gig** (or per gig branch) on the same character; switching gigs does not erase character rep, but **gig plot progress** is its own track. |
| **Alts / multi-gig mastery** | One avatar still reduces **alt** pressure for economy and story. **Maining every gig** is **not** a design problem for now: **gig leveling is intentionally slow**, so fully progressing (or “maxing”) every gig is a **long-term time investment**, not something handed out quickly. Players who put in that time **may** legitimately be strong in every gig on one character. **Revisit** only if pacing, live balance, or PvP show harm. |
## Player-facing readability
- **Combat:** UI shows **main gig**, **sub-gig**, levels/tracks, combat abilities, and **combat gear** the main gig can use (mismatched gear disabled or greyed). Consumable tooltips can show **baseline vs. boosted** values when the active gig gets an amplification.
- **Non-combat / crafting:** **skill** list, XP sources, categories; crafting combat gear does **not** hide recipes behind gigs—only **skill**/recipe gates (optional UI hint if the product is unequippable for your current gig).
- **Story:** journal or quest UI can separate **character / faction** threads from **gig** threads so players see which arc belongs to which gig.
- Use **gig** / **skill** consistently in specs and tools; flavor text can vary.
## Decisions log
| Topic | Direction | Status |
|-------|-----------|--------|
| Vocabulary | **Gig** = combat role; **skill** = non-combat only | Agreed |
| Combat gear | **Gig-restricted** equip/activation; non-combat tools **skill**-gated | Agreed |
| Crafting combat gear | **Skill**/recipe/rep (etc.) only—**not** gig or gig level; craft-for-others OK | Agreed |
| Consumables | Baseline for all; **gig can amplify** (e.g. medic + healing consumable) | Agreed |
| Rep / story | Character-wide **rep**; **gig**-scoped **storylines** and **main quests** (per-gig progress on one avatar) | Agreed |
| Multi-gig mastery | **OK for now**; slow gig leveling makes “all gigs” a **time** goal, not a loophole | Agreed (revisit if balance/PvP needs) |
| Combat vs. non-combat | **Gigs** for combat; **skills** for gather/craft/etc. | Agreed |
| Professions (economy) | No separate profession system; economy identity from **skills** + rep | Agreed ([overview](overview.md)) |
| Primary skill XP | Do the activity | Agreed |
| Failure XP | **Open**; decided **per skill / activity** once mechanics exist (not the same as death penalty) | Open |
| Skill caps | **Soft**; **progressively more XP** per level (data-driven curves) | Agreed |
| Gig swap rules | **Hub-only** (city / home base / designated site)—**not** in the field or mid-fight | Agreed |
| Sub-gig | **FFXI-style** slot **agreed**; sub abilities up to **~½ main gig level** (formula TBD); wide build space | Agreed |
| Combat progression | **Per gig**—separate level/XP (and mastery) per gig; no shared combat rank | Agreed |
| Epic 2 doc split | Align modules when gig data model is chosen | TBD |
## Next artifacts
- **Gigs** — roster size, main vs. **sub-gig** UX, **hub** definitions & swap UX, party finder tags, PvP ([overview](overview.md)).
- **Abilities** — **gig-locked** vs. **item-locked** vs. **skill-gated**.
- **Items** — **equip:** gig rules; **craft:** **skills** (and recipe/rep), never gig level.