nx_rpgstats.nx

nx_rpgstats.nx -- the SOVEREIGN CHARACTER PROGRESSION PART. nx_gamebench gap-queue rank 1 after save-load landed: rpg-stats-progression was PARTIAL and blocks 8 of 12 benchmarked titles (OpenXcom, Open Diablo II, Cataclysm-DDA, Veloren, NetHack, Crawl, Endless Sky, adventure). Built as a CERTIFIED COMPOSABLE PART (knowledge/registry/game_parts.tsv doctrine: build once to exceed, compose forever). Character state is a flat i64 vector BY DESIGN so it drops straight into gs_save/gs_load from nx_gamesave -- parts composing is the whole point of the recombinator. THE PROPERTIES THAT MAKE IT SAFE TO COMPOSE (each one is a gate tooth): 1. ORDER-INDEPENDENT MODIFIER STACKING. Real RPGs get this wrong constantly: apply +10 then +20% and you get a different number than +20% then +10, so buff/debuff application order silently changes outcomes and desyncs multiplayer. Here additive and multiplicative pools are summed SEPARATELY and applied once -- commutative BY CONSTRUCTION, not by convention. 2. DATA-DRIVEN CURVES (rule 11). The XP curve, HP formula and skill thresholds are PARAMETERS, never literals in code. A game tunes progression without touching the part. 3. MONOTONIC + EXACTLY INVERTIBLE XP. level_for_xp is the true inverse of xp_for_level at every boundary, so a character can never land between levels or oscillate. 4. INTEGER-ONLY, DETERMINISTIC. No float anywhere, so progression replays bit-identically -- the same determinism exceed the renderer and nx_gamesave carry. 5. CLAMPED BY CONSTRUCTION. Extreme inputs saturate instead of overflowing into negative HP / wrapped levels (the classic "damage so high it heals you" bug). LIB ONLY -- no main() by ecosystem convention (cf. nx_swgpu.nx). license_tier: ORIGINAL expect_exit: 0