fxgl-rpg

name	fxgl-rpg
description	Build an RPG or JRPG in FXGL — define character stats (ATK, DEF, HP, MP, SPD, XP/level), implement an experience and leveling system with stat growth, create a turn-based battle scene that transitions from overworld exploration, build an equipment system that modifies effective stats, implement status effects (poison, stun, burn) that persist across turns, define abilities with MP cost and target types, trigger encounters on NPC contact or random steps, display a battle menu (Attack/Skill/Item/Run), show loot and XP rewards on victory, and save the full party state with SaveLoadService. Use this skill when building a classic RPG, JRPG, turn-based adventure, or any game with stats, leveling, and structured battle sequences.
triggers	["RPG","JRPG","turn-based battle","stats","ATK DEF HP MP","leveling","XP experience","equipment","status effect","ability","random encounter","battle scene","party system","overworld"]
compatibility	Java 17+, FXGL 21.x
category	fxgl/game-types
tags	["fxgl","java","javafx","game-types","rpg"]
metadata	{"author":"fxgl-skills","version":"1.0","fxgl-version":"21.1"}
allowed-tools	["Read","Write","Edit","Bash"]

FXGL RPG / JRPG

Character Stats Data Class

public class CharacterStats {
    public String name;
    public int level    = 1;
    public int xp       = 0;
    public int xpToNext = 100;

    // Base stats (from level ups + class)
    public int baseHP, maxHP, currentHP;
    public int baseMP, maxMP, currentMP;
    public int baseATK, baseATKBonus;  // bonus from equipment
    public int baseDEF, baseDEFBonus;
    public int baseSPD;

    public int getATK() { return baseATK + baseATKBonus; }
    public int getDEF() { return baseDEF + baseDEFBonus; }

    // Equipment slots
    public Item weapon;
    public Item armor;
    public Item accessory;

    // Active status effects
    public final List<StatusEffect> statusEffects = new ArrayList<>();

       {
        xp += amount;
         (xp >= xpToNext) {
            xp -= xpToNext;
            levelUp();
        }
    }

       {
        level++;
        xpToNext = ()(xpToNext * );
        maxHP    += ;
        maxMP    += ;
        baseATK  += ;
        baseDEF  += ;
        baseSPD  += ;
        currentHP = maxHP;   
        currentMP = maxMP;
    }

       {
         (item == ) ;
         (item.slot) {
             WEAPON -> {
                 (weapon != ) baseATKBonus -= weapon.atkBonus;
                weapon = item;
                baseATKBonus += item.atkBonus;
            }
             ARMOR -> {
                 (armor != ) baseDEFBonus -= armor.defBonus;
                armor = item;
                baseDEFBonus += item.defBonus;
            }
        }
    }
}