RPG Attribute System

New features

• Public read API — other mods can now query player progression and combat stats without duplicating RAS formulas.
• CombatSnapshot record — immutable snapshot of final MC attribute values after RAS, gear, and effects.
• RasApi.isAvailable() — check that RAS is loaded.
• RasApi.getLevel(Player) — returns the player's current RPG level (server-side).
• RasApi.getCombatSnapshot(Player) — returns final maxHealth, attackDamage, armor, armorToughness, movementSpeed, and rpgLevel.
• Updated API documentation — docs/API.md expanded to cover read and write endpoints.

API reference

Package: tn.nightbeam.ras.api

Integration notes

• All read/write API calls except isAvailable() must run server-side on ServerPlayer.
• Other mods should call getCombatSnapshot() for balancing — do not reimplement RAS scaling math.
• RPG Mob Leveling System 2.0+ consumes this API via reflection for player-based mob scaling and combat rebalance.

Example

import tn.nightbeam.ras.api.RasApi;
import tn.nightbeam.ras.api.CombatSnapshot;
if (RasApi.isAvailable()) {
    int level = RasApi.getLevel(player);
    CombatSnapshot snap = RasApi.getCombatSnapshot(player);
    // snap.maxHealth(), snap.attackDamage(), etc.
}