fxgl-roguelike

name	fxgl-roguelike
description	Build a roguelike or roguelite game in FXGL — structure runs with a full state reset on death, save only meta-progression permanently, generate a new procedural dungeon each run with DungeonGenerator, implement weighted RNG loot tables, show 3-choice item offer screens, track run statistics (kills, gold, floor depth), gate boss fights at milestone floors, implement item synergies where items modify each other's effects, add curse mechanics as item downsides, and integrate a prestige/unlock system for permanent cross- run improvements. Use this skill when building a roguelike, roguelite, dungeon crawler, run-based game, or any permadeath game with procedural content.
triggers	["roguelike","roguelite","permadeath","run-based","procedural dungeon","loot table","item offer","meta-progression","prestige","run reset","floor depth","curse mechanic","item synergy"]
compatibility	Java 17+, FXGL 21.x
category	fxgl/game-types
tags	["fxgl","java","javafx","game-types","roguelike"]
metadata	{"author":"fxgl-skills","version":"1.0","fxgl-version":"21.1"}
allowed-tools	["Read","Write","Edit","Bash"]

FXGL Roguelike / Roguelite

Save Architecture: Two Files

// Run save (wiped on death) — stored in "run_save"
// Meta save (permanent)    — stored in "meta_save"

// Never mix them. On death:
//   1. Update meta save with run stats
//   2. Delete/reset run save
//   3. Show death screen, offer return to main menu

Run Initialization

@Override
protected void initGameVars(Map<String, Object> vars) {
    // Run-scoped (reset on death)
    vars.put("floor",       1);
    vars.put("gold",        0);
    vars.put("kills",       0);
    vars.put("runScore",    0);
    vars.put("playerHP",    100);
    vars.put("playerMaxHP", 100);
    vars.put("playerATK",   10);
    vars.put("playerDEF",   0);

    // Run item flags
    vars.put("hasFireSword",    false);
    vars.put("hasIceShield",    false);
    vars.put("hasVampirism",    false);
}

private void startNewRun() {
    // Reset all run-scoped variables to defaults
    initGameVars(new HashMap<>());   // conceptually — in practice re-init the game
    set(, System.currentTimeMillis());
    generateFloor(geti());
}