v0.57.3 - Sysop Editor + Mod Support
Long-time BBS players will remember the original Usurper shipped with USEDIT.EXE - a companion tool that let sysops edit players, add equipment, tweak NPCs, and generally tinker with their world. v0.57.3 brings that same spirit back, plus a full modding system layered on top.
The Game Editor
A brand new in-game menu option: press G from the main menu (local / Steam only - online multiplayer players can't edit their save while the world is running). You can also launch it directly with the --editor command-line flag.
Arrow keys or number keys work - pick whichever feels natural. Multi-digit numbers auto-commit when they can't be a prefix of anything else (type "2" to commit item 2; type "1" and it waits since 10-19 could follow). Backspace edits the number buffer. Escape or Q backs out.
What You Can Edit
Player Saves - 16 nested categories covering almost every editable field on your character:
- Character info (name, class, race, alignment, fame, knighthood)
- Stats and progression (level, XP, 9 core attributes, HP/Mana, resurrections, training points)
- Gold and economy (gold on hand, bank, loans, interest)
- Inventory and equipment (add items from the database, remove, equip in any slot, uncurse gear)
- Spells and abilities (grant individual or learn-all for your class)
- Companions (revive fallen, set loyalty/trust/romance, recruit or dismiss)
- Quests (mark complete, cancel, clear)
- Achievements (grant one or grant all)
- Old Gods and story (per-god status, grant all 7 seals, grant artifact, edit NG+ cycle)
- Relationships and family (per-NPC relationship scores, kid count, clear divine wrath)
- Status cleanup (cure diseases, clear poison, reset daily counters, release from prison, clear wanted level)
- Appearance and flavor (height, weight, eyes/hair/skin, combat phrases, character description)
- Skills and training (proficiencies, stat training counts, crafting materials)
- Team, guild, factions
- Settings and preferences (auto-heal, combat speed, language, color theme)
- World state (current king, bank interest, town pot, game day)
Every edit is non-destructive until you hit Save. Every save automatically creates a .bak backup. Nothing you do in the editor can corrupt a save you can't recover.
The Modding System
Seven data files in a GameData/ folder next to the executable control most of the game's content. Drop in JSON files to override built-in data:
- equipment.json - NEW in this release. Add custom weapons, armor, shields, accessories. Built-in items stay read-only for save compatibility; your mods live in a reserved ID range (200,000+).
- npcs.json - the 60 built-in town NPCs (classes, stats, personality, story role)
- monster_families.json - 16 families, 5 tiers each, full stat curves and ability lists
- dreams.json - 50 narrative dreams with unlock conditions
- achievements.json - 75 achievements with tiered rewards
- dialogue.json - about 500 NPC dialogue lines keyed by personality, emotion, context
- balance.json - 30+ tuning constants (crit rates, boss scaling, daily limits)
Run UsurperReborn --export-data once and it writes the current built-in content to GameData/ as a starting template. Edit what you want, leave the rest. Restart the game and your changes are live.
The editor has an interactive UI for all seven data files. List, add, edit, delete, filter - whichever of the three styles you prefer (arrow keys, number shortcuts, or hand-editing the JSON in a text editor) all produce the same result. Add a custom NPC in the editor: the file it writes is readable JSON you can also hand-craft.
Save Compatibility and Safety
- Built-in equipment IDs never change. A save referencing item #1023 will always find the same item.
- Mod items that get deleted are silently dropped from existing saves on load. No corruption, no crashes.
- Malformed JSON logs an error and falls back to built-in defaults. The game never crashes on a bad mod.
- Every player-save edit makes a .bak copy first. One-level undo is always available.
- The "Save File Management" menu has explicit clone / delete / restore-from-backup tools if you want to manage saves more directly.
Quality-of-Life UI
Every "type the exact ID" prompt from the initial pass is now an arrow-key picker backed by the actual vocabulary the game uses. Pick NPC personality from the 58 built-in labels. Pick monster attack type from the 10 standard types. Pick a companion by name, not by integer. Pick an artifact by name, not by enum index. Everything you can configure with a known vocabulary is a selection, not a guess.
What's Not Moddable Yet
Planned for future releases, not in this one:
- Spell and class-ability definitions (still hardcoded)
- Quest template generation (per-save quest editing works; generating new template types doesn't)
- Location descriptions
- Online multiplayer shared world state (SQLite)
- Localization JSON (hand-edit it for now)
Each of those is just more of the same pattern - a file in GameData/ plus a menu in the editor. They'll come.
Documentation
New file: DOCS/MODDING.md covers the full modding guide - what's moddable, how to start a mod, the equipment schema with examples, save compatibility rules, and concurrency warnings.
Upgrade Notes
Existing characters work as-is; no save migration required. The new [G] Game Editor main-menu entry only appears in single-player / Steam builds - BBS and online sessions keep the existing menu unchanged. Existing mods in GameData/ continue to work; the new equipment.json is additive-only so dropping it in never disturbs the other six data files.
As always - bug reports, feature requests, and mod showcases welcome on Discord or GitHub Issues.
