diff --git a/planning/SYSTEMS-ROADMAP.md b/planning/SYSTEMS-ROADMAP.md index b86b068..aefb633 100644 --- a/planning/SYSTEMS-ROADMAP.md +++ b/planning/SYSTEMS-ROADMAP.md @@ -41,6 +41,7 @@ has its own identity, position, health, and state. | Control editor | What administrators configure | | --- | --- | | Assets | Models, equipment attachments, animation sets, sound cues, visual effects | +| Cosmetics | Appearance definitions, compatible player/item/furniture targets, account unlock references | | Resources | Gathering profession, level requirement, yields, interaction, respawn, model | | Biomes | Terrain appearance, resource distribution, mob populations, spawn rules | | Mobs | Stats, level/scaling, behaviors, attacks, model/animations, loot references | @@ -228,6 +229,48 @@ For layered menus, close the topmost focused menu first and return focus to its parent or the game. One press must not close every menu or trigger an underlying gameplay binding. Closing a menu alone does not cancel an already submitted action. +### Account cosmetics and placed furniture + +Confirmed: cosmetic ownership belongs to the **account**, not a character or an +item. Cosmetics cannot be traded or lost. Death, replacement characters, world +destruction, item loss, and house deletion do not remove the account's unlocks. +Cosmetics change player appearance, the appearance of worn/held items, and items +in houses. They are appearance changes, not an extra source of item stats. + +Separate permanent account entitlement from the cosmetic currently applied to an +object. Removing an object's applied appearance never removes the account unlock. +An account may display furniture placed by someone else without acquiring the +right to apply that cosmetic to new objects. + +| Action | Applied cosmetic result | Account entitlement result | +| --- | --- | --- | +| Drop a cosmetically altered item as ordinary loot | Remove the cosmetic; retain the underlying item | Unchanged | +| Another player picks up an ordinarily transferred/looted item | Remove any previous applied cosmetic | No unlock transferred; an entitled recipient can apply their own cosmetic | +| Place furniture with a cosmetic in another player's house | Preserve its cosmetic on the placed furniture | Neither the host nor guests gain the unlock | +| Push/pull placed furniture without inventory pickup | Preserve the cosmetic, even if the mover lacks it | Unchanged | +| Pick up placed furniture into an account's inventory without owning that cosmetic | Remove the cosmetic | No unlock transferred | +| Pick up placed furniture into an account's inventory while owning that cosmetic | Preserve the cosmetic under the furniture exception | Existing entitlement remains unchanged | + +**Placement is distinct from dropping.** Furniture placement in a house must not +silently use the ordinary drop rule. Likewise pushing/pulling must not temporarily +route through inventory, or it would incorrectly clear the cosmetic. The furniture +pickup rule is the explicit exception to the general other-player pickup rule. +Check the receiving account's entitlement at pickup, not the house owner's or +original decorator's. House keys confer house rights, never cosmetic unlocks. + +Recommended model: an account entitlement ledger; cosmetic definitions with target +compatibility; per-character appearance choices; and applied cosmetic IDs on item/ +furniture instances. Persist a placed object's appearance across reload, hub-instance +switching, and house recovery without inventing an inventory-pickup event. Resolve +inventory transitions and appearance removal together in the authoritative save. +Do not clear a placed cosmetic merely because the decorator leaves the house. + +Control should author compatible skins/variants and preview them on supported rigs, +equipment, and furniture. Acquisition/grant policy is not yet specified. Still to +scope: layering/dyes, bulk moves into containers, death/corpse appearance before +looting, automatic versus manual reapplication, and house placement permissions. +These details must preserve the confirmed drop/pickup/push/pull distinctions. + ## 7. Combat, effects, spells, and weapon abilities Agree a shared combat contract before authoring many attacks. It should cover melee, @@ -477,7 +520,7 @@ content library. These are dependency-based phases, not time or capacity estimat | 4. Crafting and building | Hidden recipes, nine professions, difficulty/failure curves, random stats/provenance, persistent structures | Valid-recipe feedback; no rerolls on retries; items conserved; structures survive restart | | 5. Spells and abilities | Spell books/ranks/unlocks, weapon proficiency, effects, rebinding/controller support | Use-to-progress and targeting work; unlock cycles and XP exploits covered | | 6. Live operations | Spawn/swarm/event tools, announcements, Harbinger scheduling, expanded healing | Audited retry-safe commands; event resumes/cancels correctly after restart | -| 7. Presentation completion | Simple creator, broader animation/sound library, visible gear and camera polish | Equipment/rig compatibility and keyboard/controller UI checked | +| 7. Presentation completion | Simple creator, account cosmetics, animation/sound library, visible gear and camera polish | Rig compatibility, cosmetic entitlement/transfer rules, and input UI checked | | 8. Survivor expansion | Hub instances/travel, escape items/victory portals, key-owned housing, portal dungeons | No hub/housing XP; travel, timed deletion/recovery, and instance lifecycles preserve ownership | Asset conventions and basic action bindings begin in phase 1, even though their @@ -486,6 +529,9 @@ navigation. Phase 3 provides structure-aware navigation hooks; phase 4 completes them with real buildings. Phase 3 tests AoE using simple effects before the full spell progression UI exists. Phase 6 depends on the mob/effect foundation and can move ahead of phases 4/5 if live admin tools are the higher priority. +Cosmetic definitions and account entitlement boundaries belong in the phase 1 +design. Player/equipment cosmetics can land in phase 7; the placed-furniture +exception needs phase 8 housing and its distinct placement/movement/pickup actions. Resurrection gets a separate implementation gate after its detailed lifecycle is specified; the agreed corpse/item/spell rules do not turn ordinary healing into @@ -548,6 +594,12 @@ New design examples to turn into acceptance tests when implemented: and hub-instance-switch retries preserve one character and its original inventory. - Esc closes only the focused menu, restores focus correctly, and does not invoke an underlying gameplay action or close unrelated menus. +- Cosmetic unlocks survive character death/replacement and item/house loss. Ordinary + drop and other-player pickup clear applied cosmetics without changing item stats. +- Account A decorates furniture in B's house. B can push/pull it without losing its + appearance or gaining the unlock. B picking it into inventory clears the cosmetic + if B lacks it; an entitled account picking it up retains it. Reload/recovery does + not itself count as pickup or grant cosmetic ownership. This draft changes documentation only. No new game rules, assets, admin commands, schema migrations, or deployment settings are implemented by writing it. diff --git a/planning/VISION.md b/planning/VISION.md index 38519cf..4ce1b98 100644 --- a/planning/VISION.md +++ b/planning/VISION.md @@ -104,6 +104,21 @@ Tracked across: - Weight and carrying capacity are displayed; encumbrance penalties and hard capacity enforcement remain undecided. +## Cosmetics (planned) +- Cosmetics are permanently **account-bound**, not character-bound. They cannot + be traded or lost; an item's applied appearance is separate from the unlock. +- Cosmetics change the player, worn/held items, and items in houses. +- Ordinary item drops and pickup by another player remove the applied cosmetic. + The underlying item remains; the original account retains the cosmetic unlock. +- Furniture placed with a cosmetic in someone else's house keeps its appearance. + Pushing/pulling it without entering inventory preserves that appearance, even + when the mover does not own the cosmetic. +- Placed furniture entering a player's inventory loses its cosmetic if the + receiving account does not own it; an entitled receiver may retain it. This is + the explicit furniture exception to the ordinary pickup rule. +- Placing furniture is different from dropping loot. Displaying decorated furniture + or owning its house does not grant the cosmetic to another account. + ## Confirmed expansion decisions (planned) - Terrain begins with hills, valleys, and forests. Caves, mountains, and stacked spaces follow later.