ВЕРСИИ (349)

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 5.0.0 — The Ascendant Update ## A new Level Up screen The stats menu (**K**) is rebuilt as a soulslike Level Up screen with three columns: your attributes, the stats they drive, and a detail card for the selected attribute, in the style of soulslike RPG menus. - **Stage, preview, then confirm.** Use **←/→** or the chevrons to stage points; right-click a row to remove one. Every attribute, stat and configured total shows `current → after`. Increases are blue and the remaining points are red. **Enter** or **Confirm** commits the batch. **Reset** returns the staged points. - **Atomic, server-validated commits.** The server checks the whole request first: every attribute must be configured and unlocked, and the total cost must fit your available points. Only then does it spend points one at a time, with the same rules, caps, per-point `on_level_event` commands and attribute commands as before. A rejected request changes nothing. - **Server-measured stats.** Base Stats come from the server's live attribute values, so they include equipment, effects and other mods' modifiers. Each value is shown after your configured `display_modifer`. Previews use the real modifier formula and range clamp. This also fixes values the client never receives: vanilla does not sync `attack_damage`, so the old combat viewer showed the client's default value. - **See what a point changes.** Stats and totals affected by the selected attribute are marked with a gold diamond. - **Readable small changes.** Rows add decimals only when a change would otherwise be invisible, for example Agility `0.1 → 0.1025`. Tooltips keep exact values. - **Status and Records pages.** **Tab** switches pages. Status shows your live character model, measured stats and attribute values. Records shows experience earned, points invested and bonuses per attribute, and your configured totals. - **Keyboard first.** **↑/↓** or **W/S** select, **←/→** or **A/D** adjust, **Shift** adjusts by 5, **Enter** confirms, **Backspace/R** resets, **Tab** changes page, and **K** or **Esc** closes. If you have unconfirmed points, the first **Esc** asks before discarding them. - **Responsive layout.** Three columns on wide screens, two at GUI scale 4 on 1080p, and one on very small windows. Long attribute and stat lists scroll. Text is never fractionally scaled, and every control is at least 20 GUI pixels. ## Presentation - **Bundled serif typography** (EB Garamond and Cinzel, SIL Open Font License), rasterized to match your GUI scale for crisp text. Set `"font": "minecraft"` to keep the vanilla pixel font. - **Animations:** staggered column entrance, a selection highlight that glides between rows, eased hover states, a pulse on changed values, a golden sweep on Confirm, a tab underline that slides between pages, and slow golden motes behind the menu. All motion can be turned off. - **Cinematic level-up banner:** when your RAS level rises, a gold banner fades in with expanding rules, a shimmer and a bell, and shows your new level and points gained. - **Soulslike HUD:** a slim level, experience and unspent-points overlay that matches the menu. The previous pixel-art bar is still available with `"hud_style": "classic"`. Existing `overlay.json` anchors, offsets and JEI/REI/EMI avoidance apply to both styles. ## New client settings `config/ras/display/ui.json` (client only; missing keys use these defaults): | Key | Default | Effect | | --- | --- | --- | | `font` | `serif` | `serif` or `minecraft` | | `animations` | `true` | All menu, banner and HUD motion | | `animation_speed` | `1.0` | 0.25–4 | | `ambient_particles` | `true` | Golden motes behind the menu | | `background_blur` | `true` | Blur the world behind the menu where the version supports it | | `menu_sounds` | `true` | Navigation, staging and confirm sounds | | `hud_style` | `soulslike` | `soulslike` or `classic` | | `hud_scale` | `1.0` | Soulslike HUD scale, 0.5–2 | | `level_up_banner` | `true` | Show the level-up banner | | `level_up_sound` | `true` | Play the banner sound | ## Fixes - NeoForge: the HUD overlay was drawn once for every vanilla HUD layer, every frame. It is now registered as its own GUI layer and draws once. ## Compatibility - **Clients and servers must both run 5.0.0.** This release adds two network messages and changes the stats menu protocol. - Existing configuration, player data and server allocation rules are unchanged. `ui.json` is created only if it is missing, and imported files are not rewritten. - The previous one-click allocation message and the `modifier` server state still exist for compatibility, but the new screen no longer uses them. - The public API is unchanged.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System 4.3.0 ## Per-mob VP and configuration safety - Optional server-authoritative `config/ras/mob_xp.json` adds exact entity and entity-type tag rules, base VP overrides, and multipliers. Exact entity rules take precedence over tag rules; priority and file order resolve ties within each tier. Only one rule contributes to an award. - Optional victim-world difficulty and effective armor weighting, including fractional armor modifiers. - Rules are cached. Administrators can use `/ras reload mob_xp` to reload this file; malformed, unsupported, or unreadable replacements retain the last good rules. Diagnostics identify skipped individual rules and failed whole-file reloads. - Invalid or nonfinite XP input and overflowing awards/player totals are rejected. The generated per-mob file and both weighting options are disabled by default. Updating does not enable them, change existing dimension/global rates or shared-XP behavior, or rewrite imported configuration. Existing loader-specific boss item-drop behavior is unchanged. The new file requires RAS 4.3.0; 4.2.6 does not read it. ## Stats menu - Responsive native-size text, larger labeled controls, dynamic paging, full tooltips, and keyboard-focus feedback. - Precise current/next-value tooltips reveal small upgrades such as Agility `0.1` → `0.1025`, while visible rows keep compact values. - Fresh stats-summary defaults correctly label attribute 3 as Attack Speed. Imported labels and custom settings retain their existing values. - Point allocation remains server-authoritative, with loaded attribute IDs and configured locks checked on the server. ## Standalone configuration studio The local-only editor source is included under `tools/config-studio/`, separately from the Minecraft JARs. Its 4.3.0 target supports the versioned per-mob contract and corrected fresh stats labels. The editor preserves untouched imported files, unknown fields, and intentional custom labels, with validation and ZIP-safety checks before export. Shared tests compare real exports and previews with the production Java rules in all five version roots. Serve the editor locally and export before closing or reloading. Hosting and rendered-browser acceptance are separate from source/formula verification. ## Verification scope Representative gameplay QA uses programmatic Skeleton damage through real loader death hooks on a Fabric integrated server, alongside physical menu input and server/client state checks. It does not prove physical combat, multiplayer, dedicated-server or other-loader runtime, exhaustive death-event cancellation/deduplication, Forge boss drops, or live datapack/admin-command reloads. See the [commit-bound verification record](https://github.com/MeherBenSalem/RPG-Attribute-System/blob/main/docs/verification/4.3.0.md) for exact results and release gates.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) · Minecraft 26.3 (Fabric, NeoForge) ## Platforms - **Minecraft 26.3** — Fabric and NeoForge jars for this line. Gameplay matches the 4.2.6 26.2 port. ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) · Minecraft 26.3 (Fabric, NeoForge) ## Platforms - **Minecraft 26.3** — Fabric and NeoForge jars for this line. Gameplay matches the 4.2.6 26.2 port. ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.6 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **HUD respects Hide GUI (F1)** — the RAS level/VP overlay now hides with the vanilla HUD when Hide GUI is on. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.6**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.5 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **Admin command OP gate** — `/ras add attributes`, `xp`, `set xp`, `reset`, `unlock`, and `lock` now require OP level 4 (same as `/ras add level`). Non-ops no longer tab-complete those subcommands. - **Admin-on-other-player** — `/ras add attributes … <player>` and `/ras reset <player>` no longer re-run the command as the target. - **Attribute IDs 11–15** — lock/unlock/add-attributes accept 1–15; add-points no longer remaps 11+ onto attribute 10. - **Icons 11+** — missing `icon_path` reuses `att_1`–`att_10` instead of a broken `att_11.png`. ## Documentation - Operator restrictions (OP 4; no extra config key; Fabric LuckPerms only for respec/template). - NeoForge vs Forge jar selection; jauml required on every loader; not Paper/Folia. - Attribute 11+ lock/icon behaviour and `gui_shadow_color` (no text-shadow boolean). See `docs/listing-notes.md` for paste-ready CurseForge/Modrinth reply text. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.5**. Server and clients should run the same RAS version.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System — 4.2.4 Patch Notes **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ## Bug fixes - **`/ras add level` permission** — command now requires OP level 4 as documented. Non-operators can no longer add levels to other players. - **Stats-display sync protocol (4.2.3 regression)** — `gui_shadow_color` is appended after totals instead of before the entry count. Mixed client/server versions can join again; 4.2.4 decoders also accept the short-lived 4.2.3 wire layout. ## Upgrade Replace the loader jar for your Minecraft version with **4.2.4**. Servers on 4.2.4 can host players still on **4.2.2**; everyone should move off **4.2.3** when possible.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.3 — Patch Notes **Release date:** August 28, 2026 ## New Features - **`/ras level [player]` (ticket-0019):** Shows a player's RPG level. Defaults to self; viewing another player requires OP (permission level 2) or the `rpg_attribute_system.level.other` permission node. - **`/ras rewards [level]` (ticket-0019):** Lists deterministic level-up rewards from `config/ras/levelup_rewards.json`. Omit `level` to list all configured rewards, or pass a level to show that entry only. ## Configuration - **`gui_shadow_color` in `stats_display.json` (ticket-0044):** Book-style GUI text underlay colour is now configurable (default `#80F3E1B5`). Supports 6-digit (`#RRGGBB`) and 8-digit (`#AARRGGBB`) hex. Synced from server to clients on join via the existing stats-display sync packet. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. - **Networking:** The stats-display sync packet adds one `int` field (`gui_shadow_color`). Update clients and servers together. ## Upgrade Notes - Update all loader JARs to **4.2.3** together on clients and servers. - After changing `stats_display.json` on a server, players must **re-join** to pick up new colours on clients.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System 4.2.2 — Patch Notes **Release date:** August 21, 2026 ## New Features - **Server → client stats display sync:** `config/ras/stats_display.json` colours and totals are now sent to players when they join a server (mirrors the existing items-lock sync pattern). ## Bug Fixes - **GUI text readability (ticket-0044):** Book-style stat screens now draw a soft cream underlay behind text and use shadowed foreground rendering for improved contrast on parchment backgrounds. XP bar label text uses the cream palette instead of dark ink. - **Stats display colours & sync (ticket-0164):** Header, bonus-positive, and bonus-neutral colours from `stats_display.json` are applied on the Statistics overview. Server configuration syncs to clients on join. - **Tolerant totals parser:** `totals` entries that mistakenly use `[labelEnd]` instead of `[idsEnd]` after the `[ids]` block (as shown in older docs) are now parsed correctly. ## Configuration - **`stats_display.json`** — `header_color`, `bonus_positive_color`, `bonus_neutral_color`, and `totals` affect the **Statistics** tab only. - After changing the server file, players must **re-join** to pick up new colours or totals on clients. ## Compatibility - Minecraft **1.20.1** (Fabric + Forge), **1.21.1** (Fabric + NeoForge), **26.1.2** (Fabric + NeoForge), **26.2** (Fabric + NeoForge). - No world or player-data migration required. ## Upgrade Notes - Update all loader JARs to **4.2.2** together on clients and servers. - Single-player and client-local configs are unchanged; multiplayer servers should edit `config/ras/stats_display.json` on the host and have clients re-join after changes.

# RPG Attribute System — Patch Notes ## 4.2.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **NeoForge 26.1.2 startup crash (BlockEvent.BreakEvent missing)** — NeoForge block-break handler now uses `BreakBlockEvent` on 26.1.2 so the mod loads correctly. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact. ## 4.2.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Configuration - Fresh installations now generate only the first eight built-in attribute files (`attribute_1.json` through `attribute_8.json`). - Additional attributes must be created manually and can use the existing configurable display and command settings. - The default maximum level for generated attributes is now **500**. - Existing attribute files are preserved during upgrades; this change does not delete or rewrite custom attributes 9–15. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.0**. Existing configuration files remain intact; the new eight-attribute default applies to files created after the upgrade. --- ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.2.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **NeoForge 26.1.2 startup crash (BlockEvent.BreakEvent missing)** — NeoForge block-break handler now uses `BreakBlockEvent` on 26.1.2 so the mod loads correctly. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact. ## 4.2.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Configuration - Fresh installations now generate only the first eight built-in attribute files (`attribute_1.json` through `attribute_8.json`). - Additional attributes must be created manually and can use the existing configurable display and command settings. - The default maximum level for generated attributes is now **500**. - Existing attribute files are preserved during upgrades; this change does not delete or rewrite custom attributes 9–15. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.0**. Existing configuration files remain intact; the new eight-attribute default applies to files created after the upgrade. --- ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.2.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **NeoForge 26.1.2 startup crash (BlockEvent.BreakEvent missing)** — NeoForge block-break handler now uses `BreakBlockEvent` on 26.1.2 so the mod loads correctly. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact. ## 4.2.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Configuration - Fresh installations now generate only the first eight built-in attribute files (`attribute_1.json` through `attribute_8.json`). - Additional attributes must be created manually and can use the existing configurable display and command settings. - The default maximum level for generated attributes is now **500**. - Existing attribute files are preserved during upgrades; this change does not delete or rewrite custom attributes 9–15. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.0**. Existing configuration files remain intact; the new eight-attribute default applies to files created after the upgrade. --- ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.2.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **NeoForge 26.1.2 startup crash (BlockEvent.BreakEvent missing)** — NeoForge block-break handler now uses `BreakBlockEvent` on 26.1.2 so the mod loads correctly. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact. ## 4.2.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Configuration - Fresh installations now generate only the first eight built-in attribute files (`attribute_1.json` through `attribute_8.json`). - Additional attributes must be created manually and can use the existing configurable display and command settings. - The default maximum level for generated attributes is now **500**. - Existing attribute files are preserved during upgrades; this change does not delete or rewrite custom attributes 9–15. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.0**. Existing configuration files remain intact; the new eight-attribute default applies to files created after the upgrade. --- ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.2.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **NeoForge 26.1.2 startup crash (BlockEvent.BreakEvent missing)** — NeoForge block-break handler now uses `BreakBlockEvent` on 26.1.2 so the mod loads correctly. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact. ## 4.2.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.1.2 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Configuration - Fresh installations now generate only the first eight built-in attribute files (`attribute_1.json` through `attribute_8.json`). - Additional attributes must be created manually and can use the existing configurable display and command settings. - The default maximum level for generated attributes is now **500**. - Existing attribute files are preserved during upgrades; this change does not delete or rewrite custom attributes 9–15. ### Upgrade Replace the loader jar for your Minecraft version with **4.2.0**. Existing configuration files remain intact; the new eight-attribute default applies to files created after the upgrade. --- ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System 4.2.1 ## Bug fixes - **NeoForge 26.1.2 crash on startup** — update block-break event handler to use `BreakBlockEvent` (fixes missing `BlockEvent.BreakEvent` class). ## Supported loaders - Minecraft 1.20.1 (Fabric, Forge) - Minecraft 1.21.1 (Fabric, NeoForge) - Minecraft 26.1.2 (Fabric, NeoForge) - Minecraft 26.2 (Fabric, NeoForge) ## Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact.

# RPG Attribute System 4.2.1 ## Bug fixes - **NeoForge 26.1.2 crash on startup** — update block-break event handler to use `BreakBlockEvent` (fixes missing `BlockEvent.BreakEvent` class). ## Supported loaders - Minecraft 1.20.1 (Fabric, Forge) - Minecraft 1.21.1 (Fabric, NeoForge) - Minecraft 26.1.2 (Fabric, NeoForge) - Minecraft 26.2 (Fabric, NeoForge) ## Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact.

# RPG Attribute System 4.2.1 ## Bug fixes - **NeoForge 26.1.2 crash on startup** — update block-break event handler to use `BreakBlockEvent` (fixes missing `BlockEvent.BreakEvent` class). ## Supported loaders - Minecraft 1.20.1 (Fabric, Forge) - Minecraft 1.21.1 (Fabric, NeoForge) - Minecraft 26.1.2 (Fabric, NeoForge) - Minecraft 26.2 (Fabric, NeoForge) ## Upgrade Replace the loader jar for your Minecraft version with **4.2.1**. Existing configuration files remain intact.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.1.2: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.1.2: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System 4.2.0 ## Configuration defaults - New installations create the eight built-in attributes only: `attribute_1.json` through `attribute_8.json`. - Further attributes are opt-in and must be created manually in `ras/attributes` and enabled in the display configuration when desired. - The generated default maximum level is 500 for each built-in attribute. - The initializer only fills missing files and keys, so existing configurations and custom attributes are preserved. ## Supported loaders - Minecraft 1.20.1: Fabric and Forge - Minecraft 1.21.1: Fabric and NeoForge - Minecraft 26.2: Fabric and NeoForge ## Upgrade Replace the loader jar with the 4.2.0 build for the target Minecraft version. No configuration reset is required.

# RPG Attribute System — Patch Notes ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System — Patch Notes ## 4.1.4 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **26.2 blank menu / HUD text** — text colors updated to opaque ARGB for MC 26.2 `GuiGraphics` rendering (Attributes menu, Combat Stats tab, level overlay). - **Combat Stats all zeros** — vanilla attributes resolved via `Attributes.*` holders so Health, Damage, Armor, etc. show real values on all loaders. ### Upgrade Replace all RAS jars with **4.1.4** (remove any `*(1).jar` duplicates). Restart fully. See also: `RPG-Attribute-System-4.1.4-PatchNotes.md`. --- ## 4.1.3 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Fabric 26.2 launch crash** — removed duplicate `PayloadTypeRegistry` registration of `sync_items_lock` that threw `Packet type … is already registered!` during Fabric `main` entrypoint. ### Upgrade Replace all RAS jars with **4.1.3** (remove any `*(1).jar` duplicates). Restart fully. Other MC lines are version-synced only. See also: `RPG-Attribute-System-4.1.3-PatchNotes.md`. --- ## 4.1.2 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **`cmd_to_exc` no longer appended on update (#36)** — scaffolding only sets missing keys; existing command arrays (even empty) are preserved. - **`[param(X)]` scaling in tooltips/cache (#37, #39)** — `baseIncrement` resolved from commands so next-value previews match real per-point growth. - **Attributes 9–15 scaffolding + 1.20.1 sync (#38)** — missing attribute/display files created safely; 1.20.1 clients receive synced display names and tips. ### Upgrade Update server and clients together. Trim any duplicate `cmd_to_exc` lines if a prior build appended defaults. See also: `RPG-Attribute-System-4.1.2-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.1 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### Bug fixes - **Item-lock tooltips for modded / server-only entries** — syncs `items_lock` (`enabled`, `show_tooltip`, `items_list`) from server to client on join so WeaponExpanded and other modded locks show requirement tooltips. - **`show_tooltip` honored on 1.21.1 / 26.2** — previously ignored on those lines. ### Upgrade No config migration. Update server and clients together; re-join after editing server `items_lock.json`. See also: `RPG-Attribute-System-4.1.1-PatchNotes.md`, `docs/changelog.md`. --- ## 4.1.0 **Supported platforms:** Minecraft 1.20.1 (Fabric, Forge) · Minecraft 1.21.1 (Fabric, NeoForge) · Minecraft 26.2 (Fabric, NeoForge) ### 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` | Method | Description | |--------|-------------| | `isAvailable()` | Returns `true` when RAS classes are on the classpath | | `getLevel(Player)` | Player RPG level after migration (server-side) | | `getCombatSnapshot(Player)` | Final combat attribute values from MC attribute instances | | `respec(Player)` / `respec(Player, RespecOptions)` | Reset allocated points (unchanged) | | `applyTemplate(Player, String)` | Apply a build template (unchanged) | `CombatSnapshot` fields: | Field | Source | |-------|--------| | `rpgLevel` | `rpg_attribute_system:rpg_level` synced attribute | | `maxHealth` | `Attributes.MAX_HEALTH` final value | | `attackDamage` | `Attributes.ATTACK_DAMAGE` final value | | `armor` | `Attributes.ARMOR` final value | | `armorToughness` | `Attributes.ARMOR_TOUGHNESS` final value | | `movementSpeed` | `Attributes.MOVEMENT_SPEED` final value | ### 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 ```java 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. } ``` ### Breaking changes None. This is an additive release — all existing respec and template API behavior is unchanged. --- ## 4.0.0 - MultiLoader support across 1.20.1, 1.21.1, and 26.2. - Player XP curve, attribute point allocation, and configurable stat scaling. - Respec system with Scroll of Rebirth and admin commands. - Build templates for quick stat distribution. - Public write API: `RasApi.respec()`, `RasApi.applyTemplate()`. - Synced `rpg_attribute_system:rpg_level` Minecraft attribute.

# RPG Attribute System v4.1.3 ### New Features * None ### Improvements * None ### Bug Fixes * **Fabric 26.2 crash on launch** — `rpg_attribute_system:sync_items_lock` was registered twice in Fabric init, causing `IllegalArgumentException: Packet type … is already registered!` and preventing the game from starting (e.g. Prism/Fabric 26.2 packs). ### Configuration * No config changes. ### Compatibility * Same loaders as 4.1.2: Minecraft **1.20.1** (Fabric, Forge) · **1.21.1** (Fabric, NeoForge) · **26.2** (Fabric, NeoForge). * Functional fix applies to **26.2 Fabric** only; other jars are version-synced to **4.1.3**. ### Upgrade Notes 1. Remove any older RAS jars (including Windows duplicates like `…4.1.2(1).jar`). 2. Install **4.1.3** for your MC version + loader. 3. Restart the client/server fully (not only `/reload`).

# RPG Attribute System v4.1.3 ### New Features * None ### Improvements * None ### Bug Fixes * **Fabric 26.2 crash on launch** — `rpg_attribute_system:sync_items_lock` was registered twice in Fabric init, causing `IllegalArgumentException: Packet type … is already registered!` and preventing the game from starting (e.g. Prism/Fabric 26.2 packs). ### Configuration * No config changes. ### Compatibility * Same loaders as 4.1.2: Minecraft **1.20.1** (Fabric, Forge) · **1.21.1** (Fabric, NeoForge) · **26.2** (Fabric, NeoForge). * Functional fix applies to **26.2 Fabric** only; other jars are version-synced to **4.1.3**. ### Upgrade Notes 1. Remove any older RAS jars (including Windows duplicates like `…4.1.2(1).jar`). 2. Install **4.1.3** for your MC version + loader. 3. Restart the client/server fully (not only `/reload`).

# RPG Attribute System v4.1.3 ### New Features * None ### Improvements * None ### Bug Fixes * **Fabric 26.2 crash on launch** — `rpg_attribute_system:sync_items_lock` was registered twice in Fabric init, causing `IllegalArgumentException: Packet type … is already registered!` and preventing the game from starting (e.g. Prism/Fabric 26.2 packs). ### Configuration * No config changes. ### Compatibility * Same loaders as 4.1.2: Minecraft **1.20.1** (Fabric, Forge) · **1.21.1** (Fabric, NeoForge) · **26.2** (Fabric, NeoForge). * Functional fix applies to **26.2 Fabric** only; other jars are version-synced to **4.1.3**. ### Upgrade Notes 1. Remove any older RAS jars (including Windows duplicates like `…4.1.2(1).jar`). 2. Install **4.1.3** for your MC version + loader. 3. Restart the client/server fully (not only `/reload`).

# RPG Attribute System v4.1.3 ### New Features * None ### Improvements * None ### Bug Fixes * **Fabric 26.2 crash on launch** — `rpg_attribute_system:sync_items_lock` was registered twice in Fabric init, causing `IllegalArgumentException: Packet type … is already registered!` and preventing the game from starting (e.g. Prism/Fabric 26.2 packs). ### Configuration * No config changes. ### Compatibility * Same loaders as 4.1.2: Minecraft **1.20.1** (Fabric, Forge) · **1.21.1** (Fabric, NeoForge) · **26.2** (Fabric, NeoForge). * Functional fix applies to **26.2 Fabric** only; other jars are version-synced to **4.1.3**. ### Upgrade Notes 1. Remove any older RAS jars (including Windows duplicates like `…4.1.2(1).jar`). 2. Install **4.1.3** for your MC version + loader. 3. Restart the client/server fully (not only `/reload`).

# RPG Attribute System v4.1.3 ### New Features * None ### Improvements * None ### Bug Fixes * **Fabric 26.2 crash on launch** — `rpg_attribute_system:sync_items_lock` was registered twice in Fabric init, causing `IllegalArgumentException: Packet type … is already registered!` and preventing the game from starting (e.g. Prism/Fabric 26.2 packs). ### Configuration * No config changes. ### Compatibility * Same loaders as 4.1.2: Minecraft **1.20.1** (Fabric, Forge) · **1.21.1** (Fabric, NeoForge) · **26.2** (Fabric, NeoForge). * Functional fix applies to **26.2 Fabric** only; other jars are version-synced to **4.1.3**. ### Upgrade Notes 1. Remove any older RAS jars (including Windows duplicates like `…4.1.2(1).jar`). 2. Install **4.1.3** for your MC version + loader. 3. Restart the client/server fully (not only `/reload`).

# RPG Attribute System v4.1.3 ### New Features * None ### Improvements * None ### Bug Fixes * **Fabric 26.2 crash on launch** — `rpg_attribute_system:sync_items_lock` was registered twice in Fabric init, causing `IllegalArgumentException: Packet type … is already registered!` and preventing the game from starting (e.g. Prism/Fabric 26.2 packs). ### Configuration * No config changes. ### Compatibility * Same loaders as 4.1.2: Minecraft **1.20.1** (Fabric, Forge) · **1.21.1** (Fabric, NeoForge) · **26.2** (Fabric, NeoForge). * Functional fix applies to **26.2 Fabric** only; other jars are version-synced to **4.1.3**. ### Upgrade Notes 1. Remove any older RAS jars (including Windows duplicates like `…4.1.2(1).jar`). 2. Install **4.1.3** for your MC version + loader. 3. Restart the client/server fully (not only `/reload`).

Release 4.1.2

Release 4.1.2

Release 4.1.2

Release 4.1.2

Release 4.1.2

Release 4.1.2

# RPG Attribute System 4.1.1 Patch Notes **Release date:** 2026-07-29 ## Bug fix — item-lock tooltips for server-only modded items ### Problem Item-lock requirement tooltips were read from the client's local `config/ras/items_lock.json`. Server enforcement always used the server config. Modded weapons (for example WeaponExpanded entries added only on the server) were correctly blocked in use, but showed no requirement tooltip on the client. Vanilla defaults worked because they ship with the mod on both sides. ### Solution - Sync `items_lock` settings (`enabled`, `show_tooltip`, `items_list`) from server to client on player join, following the existing `SyncConfigPayload` attribute-config pattern. - Add shared `ItemsLockClientCache` and `ItemLockTooltipHelper.appendTooltip(...)` in common code. - Slim platform tooltip handlers (Fabric / NeoForge / Forge) to delegate to the helper. - Restore honoring of `show_tooltip` on 1.21.1 and 26.2 clients. ### Affected versions - Minecraft 1.20.1 (Fabric + Forge) - Minecraft 1.21.1 (Fabric + NeoForge) - Minecraft 26.2 (Fabric + NeoForge) ### Upgrade notes No config migration required. Clients automatically receive the server's item-lock list after joining. Ensure server and client mod versions match (4.1.1).

# RPG Attribute System 4.1.1 Patch Notes **Release date:** 2026-07-29 ## Bug fix — item-lock tooltips for server-only modded items ### Problem Item-lock requirement tooltips were read from the client's local `config/ras/items_lock.json`. Server enforcement always used the server config. Modded weapons (for example WeaponExpanded entries added only on the server) were correctly blocked in use, but showed no requirement tooltip on the client. Vanilla defaults worked because they ship with the mod on both sides. ### Solution - Sync `items_lock` settings (`enabled`, `show_tooltip`, `items_list`) from server to client on player join, following the existing `SyncConfigPayload` attribute-config pattern. - Add shared `ItemsLockClientCache` and `ItemLockTooltipHelper.appendTooltip(...)` in common code. - Slim platform tooltip handlers (Fabric / NeoForge / Forge) to delegate to the helper. - Restore honoring of `show_tooltip` on 1.21.1 and 26.2 clients. ### Affected versions - Minecraft 1.20.1 (Fabric + Forge) - Minecraft 1.21.1 (Fabric + NeoForge) - Minecraft 26.2 (Fabric + NeoForge) ### Upgrade notes No config migration required. Clients automatically receive the server's item-lock list after joining. Ensure server and client mod versions match (4.1.1).

# RPG Attribute System 4.1.1 Patch Notes **Release date:** 2026-07-29 ## Bug fix — item-lock tooltips for server-only modded items ### Problem Item-lock requirement tooltips were read from the client's local `config/ras/items_lock.json`. Server enforcement always used the server config. Modded weapons (for example WeaponExpanded entries added only on the server) were correctly blocked in use, but showed no requirement tooltip on the client. Vanilla defaults worked because they ship with the mod on both sides. ### Solution - Sync `items_lock` settings (`enabled`, `show_tooltip`, `items_list`) from server to client on player join, following the existing `SyncConfigPayload` attribute-config pattern. - Add shared `ItemsLockClientCache` and `ItemLockTooltipHelper.appendTooltip(...)` in common code. - Slim platform tooltip handlers (Fabric / NeoForge / Forge) to delegate to the helper. - Restore honoring of `show_tooltip` on 1.21.1 and 26.2 clients. ### Affected versions - Minecraft 1.20.1 (Fabric + Forge) - Minecraft 1.21.1 (Fabric + NeoForge) - Minecraft 26.2 (Fabric + NeoForge) ### Upgrade notes No config migration required. Clients automatically receive the server's item-lock list after joining. Ensure server and client mod versions match (4.1.1).

# RPG Attribute System 4.1.1 Patch Notes **Release date:** 2026-07-29 ## Bug fix — item-lock tooltips for server-only modded items ### Problem Item-lock requirement tooltips were read from the client's local `config/ras/items_lock.json`. Server enforcement always used the server config. Modded weapons (for example WeaponExpanded entries added only on the server) were correctly blocked in use, but showed no requirement tooltip on the client. Vanilla defaults worked because they ship with the mod on both sides. ### Solution - Sync `items_lock` settings (`enabled`, `show_tooltip`, `items_list`) from server to client on player join, following the existing `SyncConfigPayload` attribute-config pattern. - Add shared `ItemsLockClientCache` and `ItemLockTooltipHelper.appendTooltip(...)` in common code. - Slim platform tooltip handlers (Fabric / NeoForge / Forge) to delegate to the helper. - Restore honoring of `show_tooltip` on 1.21.1 and 26.2 clients. ### Affected versions - Minecraft 1.20.1 (Fabric + Forge) - Minecraft 1.21.1 (Fabric + NeoForge) - Minecraft 26.2 (Fabric + NeoForge) ### Upgrade notes No config migration required. Clients automatically receive the server's item-lock list after joining. Ensure server and client mod versions match (4.1.1).

# RPG Attribute System 4.1.1 Patch Notes **Release date:** 2026-07-29 ## Bug fix — item-lock tooltips for server-only modded items ### Problem Item-lock requirement tooltips were read from the client's local `config/ras/items_lock.json`. Server enforcement always used the server config. Modded weapons (for example WeaponExpanded entries added only on the server) were correctly blocked in use, but showed no requirement tooltip on the client. Vanilla defaults worked because they ship with the mod on both sides. ### Solution - Sync `items_lock` settings (`enabled`, `show_tooltip`, `items_list`) from server to client on player join, following the existing `SyncConfigPayload` attribute-config pattern. - Add shared `ItemsLockClientCache` and `ItemLockTooltipHelper.appendTooltip(...)` in common code. - Slim platform tooltip handlers (Fabric / NeoForge / Forge) to delegate to the helper. - Restore honoring of `show_tooltip` on 1.21.1 and 26.2 clients. ### Affected versions - Minecraft 1.20.1 (Fabric + Forge) - Minecraft 1.21.1 (Fabric + NeoForge) - Minecraft 26.2 (Fabric + NeoForge) ### Upgrade notes No config migration required. Clients automatically receive the server's item-lock list after joining. Ensure server and client mod versions match (4.1.1).

# RPG Attribute System 4.1.1 Patch Notes **Release date:** 2026-07-29 ## Bug fix — item-lock tooltips for server-only modded items ### Problem Item-lock requirement tooltips were read from the client's local `config/ras/items_lock.json`. Server enforcement always used the server config. Modded weapons (for example WeaponExpanded entries added only on the server) were correctly blocked in use, but showed no requirement tooltip on the client. Vanilla defaults worked because they ship with the mod on both sides. ### Solution - Sync `items_lock` settings (`enabled`, `show_tooltip`, `items_list`) from server to client on player join, following the existing `SyncConfigPayload` attribute-config pattern. - Add shared `ItemsLockClientCache` and `ItemLockTooltipHelper.appendTooltip(...)` in common code. - Slim platform tooltip handlers (Fabric / NeoForge / Forge) to delegate to the helper. - Restore honoring of `show_tooltip` on 1.21.1 and 26.2 clients. ### Affected versions - Minecraft 1.20.1 (Fabric + Forge) - Minecraft 1.21.1 (Fabric + NeoForge) - Minecraft 26.2 (Fabric + NeoForge) ### Upgrade notes No config migration required. Clients automatically receive the server's item-lock list after joining. Ensure server and client mod versions match (4.1.1).

### 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` | Method |Description | | ---------------------------------------------- |--------------------------------------------------------- | | <code>isAvailable()</code> |Returns <code>true</code> when RAS classes are on the classpath | | <code>getLevel(Player)</code> |Player RPG level after migration (server-side) | | <code>getCombatSnapshot(Player)</code> |Final combat attribute values from MC attribute instances | | <code>respec(Player)</code> / <code>respec(Player, RespecOptions)</code> |Reset allocated points (unchanged) | | <code>applyTemplate(Player, String)</code> |Apply a build template (unchanged) | | <code>CombatSnapshot</code> fields: |&nbsp; | | Field |Source | | ------- |-------- | | <code>rpgLevel</code> |<code>rpg_attribute_system:rpg_level</code> synced attribute | | <code>maxHealth</code> |<code>Attributes.MAX_HEALTH</code> final value | | <code>attackDamage</code> |<code>Attributes.ATTACK_DAMAGE</code> final value | | <code>armor</code> |<code>Attributes.ARMOR</code> final value | | <code>armorToughness</code> |<code>Attributes.ARMOR_TOUGHNESS</code> final value | | <code>movementSpeed</code> |<code>Attributes.MOVEMENT_SPEED</code> final value | ### 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 ```java 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. } ```

### 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` | Method |Description | | ---------------------------------------------- |--------------------------------------------------------- | | <code>isAvailable()</code> |Returns <code>true</code> when RAS classes are on the classpath | | <code>getLevel(Player)</code> |Player RPG level after migration (server-side) | | <code>getCombatSnapshot(Player)</code> |Final combat attribute values from MC attribute instances | | <code>respec(Player)</code> / <code>respec(Player, RespecOptions)</code> |Reset allocated points (unchanged) | | <code>applyTemplate(Player, String)</code> |Apply a build template (unchanged) | | <code>CombatSnapshot</code> fields: |&nbsp; | | Field |Source | | ------- |-------- | | <code>rpgLevel</code> |<code>rpg_attribute_system:rpg_level</code> synced attribute | | <code>maxHealth</code> |<code>Attributes.MAX_HEALTH</code> final value | | <code>attackDamage</code> |<code>Attributes.ATTACK_DAMAGE</code> final value | | <code>armor</code> |<code>Attributes.ARMOR</code> final value | | <code>armorToughness</code> |<code>Attributes.ARMOR_TOUGHNESS</code> final value | | <code>movementSpeed</code> |<code>Attributes.MOVEMENT_SPEED</code> final value | ### 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 ```java 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. } ```

### 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` | Method |Description | | ---------------------------------------------- |--------------------------------------------------------- | | <code>isAvailable()</code> |Returns <code>true</code> when RAS classes are on the classpath | | <code>getLevel(Player)</code> |Player RPG level after migration (server-side) | | <code>getCombatSnapshot(Player)</code> |Final combat attribute values from MC attribute instances | | <code>respec(Player)</code> / <code>respec(Player, RespecOptions)</code> |Reset allocated points (unchanged) | | <code>applyTemplate(Player, String)</code> |Apply a build template (unchanged) | | <code>CombatSnapshot</code> fields: |&nbsp; | | Field |Source | | ------- |-------- | | <code>rpgLevel</code> |<code>rpg_attribute_system:rpg_level</code> synced attribute | | <code>maxHealth</code> |<code>Attributes.MAX_HEALTH</code> final value | | <code>attackDamage</code> |<code>Attributes.ATTACK_DAMAGE</code> final value | | <code>armor</code> |<code>Attributes.ARMOR</code> final value | | <code>armorToughness</code> |<code>Attributes.ARMOR_TOUGHNESS</code> final value | | <code>movementSpeed</code> |<code>Attributes.MOVEMENT_SPEED</code> final value | ### 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 ```java 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. } ```

### 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` | Method |Description | | ---------------------------------------------- |--------------------------------------------------------- | | <code>isAvailable()</code> |Returns <code>true</code> when RAS classes are on the classpath | | <code>getLevel(Player)</code> |Player RPG level after migration (server-side) | | <code>getCombatSnapshot(Player)</code> |Final combat attribute values from MC attribute instances | | <code>respec(Player)</code> / <code>respec(Player, RespecOptions)</code> |Reset allocated points (unchanged) | | <code>applyTemplate(Player, String)</code> |Apply a build template (unchanged) | | <code>CombatSnapshot</code> fields: |&nbsp; | | Field |Source | | ------- |-------- | | <code>rpgLevel</code> |<code>rpg_attribute_system:rpg_level</code> synced attribute | | <code>maxHealth</code> |<code>Attributes.MAX_HEALTH</code> final value | | <code>attackDamage</code> |<code>Attributes.ATTACK_DAMAGE</code> final value | | <code>armor</code> |<code>Attributes.ARMOR</code> final value | | <code>armorToughness</code> |<code>Attributes.ARMOR_TOUGHNESS</code> final value | | <code>movementSpeed</code> |<code>Attributes.MOVEMENT_SPEED</code> final value | ### 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 ```java 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. } ```

### 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` | Method |Description | | ---------------------------------------------- |--------------------------------------------------------- | | <code>isAvailable()</code> |Returns <code>true</code> when RAS classes are on the classpath | | <code>getLevel(Player)</code> |Player RPG level after migration (server-side) | | <code>getCombatSnapshot(Player)</code> |Final combat attribute values from MC attribute instances | | <code>respec(Player)</code> / <code>respec(Player, RespecOptions)</code> |Reset allocated points (unchanged) | | <code>applyTemplate(Player, String)</code> |Apply a build template (unchanged) | | <code>CombatSnapshot</code> fields: |&nbsp; | | Field |Source | | ------- |-------- | | <code>rpgLevel</code> |<code>rpg_attribute_system:rpg_level</code> synced attribute | | <code>maxHealth</code> |<code>Attributes.MAX_HEALTH</code> final value | | <code>attackDamage</code> |<code>Attributes.ATTACK_DAMAGE</code> final value | | <code>armor</code> |<code>Attributes.ARMOR</code> final value | | <code>armorToughness</code> |<code>Attributes.ARMOR_TOUGHNESS</code> final value | | <code>movementSpeed</code> |<code>Attributes.MOVEMENT_SPEED</code> final value | ### 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 ```java 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. } ```

### 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` | Method |Description | | ---------------------------------------------- |--------------------------------------------------------- | | <code>isAvailable()</code> |Returns <code>true</code> when RAS classes are on the classpath | | <code>getLevel(Player)</code> |Player RPG level after migration (server-side) | | <code>getCombatSnapshot(Player)</code> |Final combat attribute values from MC attribute instances | | <code>respec(Player)</code> / <code>respec(Player, RespecOptions)</code> |Reset allocated points (unchanged) | | <code>applyTemplate(Player, String)</code> |Apply a build template (unchanged) | | <code>CombatSnapshot</code> fields: |&nbsp; | | Field |Source | | ------- |-------- | | <code>rpgLevel</code> |<code>rpg_attribute_system:rpg_level</code> synced attribute | | <code>maxHealth</code> |<code>Attributes.MAX_HEALTH</code> final value | | <code>attackDamage</code> |<code>Attributes.ATTACK_DAMAGE</code> final value | | <code>armor</code> |<code>Attributes.ARMOR</code> final value | | <code>armorToughness</code> |<code>Attributes.ARMOR_TOUGHNESS</code> final value | | <code>movementSpeed</code> |<code>Attributes.MOVEMENT_SPEED</code> final value | ### 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 ```java 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. } ```

## Default maximum level The new-install default changes from level **50** to **100**. The level-cap implementation was already configurable and working; no replacement level system was introduced. `max_player_level` and `exp_curve_max_level` are both seeded to 100, and the generated explicit EXP list now covers levels 1–100. Existing settings files retain their current values because initialization only writes missing keys. ## Default balance changes | Setting | Previous default | 4.0 default | Reason | |---|---:|---:|---| | `max_player_level` | 50 | 100 | Gives one-point-per-level progression room for eight attributes without making every cap reachable. | | `exp_curve_max_level` | 50 | 100 | Keeps the active curve cap aligned with the new player cap. | | Generated explicit EXP entries | 1–50 | 1–100 | Prevents the default curve from ending halfway through the new progression. | | `levels_scale_default` | 1.001 | 1.02 | Makes fallback levels meaningful while remaining less steep than the early interval multipliers. | | Attack Power per point | 0.25 | 0.20 | A 40-point investment now adds 8 damage instead of 10, reducing one-shot pressure with weapon enchantments and effects. | | Attack Speed max | 50 | 40 | Caps the default bonus at +0.8 attack speed instead of +1.5. | | Attack Speed per point | 0.03 | 0.02 | Limits extreme swing-rate stacking with haste and weapon modifiers. | | Movement Speed max | 20 | 12 | Limits the default bonus to +0.03 over the 0.1 base, avoiding extreme travel/combat speed. | | Diamond tool/item lock | 10 | 12 | Places diamond equipment after early attribute investment. | | Netherite tool/item lock | 20 | 30 | Reserves Netherite for mid/late progression under the 100-level cap. | | Diamond ore block lock | 10 | 12 | Keeps mining progression aligned with diamond equipment. | | Ancient debris block lock | 20 | 30 | Keeps Netherite-material progression aligned with Netherite equipment. | Unchanged defaults remain deliberate: one point per level, 20 starting Health, +1 Health per point, armor +0.25 per point capped at 10, knockback resistance +0.01 capped at 0.8, toughness +0.10 capped at 5, luck +0.10 capped at 5, shared XP disabled, and respec cost disabled with the Scroll of Rebirth item available. Critical chance/damage, mining speed, strength, and separate respec-item settings are not independent default settings in the current implementation, so no new unsupported settings were invented. ## Bugs actually fixed - Combat-stat display now resolves both modern and legacy Minecraft attribute registry IDs and reads the final `AttributeInstance` value, including modifiers, instead of falling back to zero when a short legacy name such as `max_health` is configured. - The combat-stat screen discovers enabled display sections independently from allocation attributes and paginates eight rows per page. - The external HUD XP display now uses the same green XP textures and proportions as the RPG screen. - The Allocate and Combat Stats labels have improved contrast and centering. ## Configuration compatibility Existing configuration files are not overwritten. New defaults are written only when a key is absent. Existing custom maximum levels, explicit EXP arrays, scaling intervals, attributes, restrictions, respec settings, worlds, NBT, and player progress remain in effect. If an existing configuration is intentionally migrated by an operator, back it up first; 4.0 itself performs no automatic rewrite of existing values. Invalid values continue to pass through the existing validation/reporting path. Custom caps remain bounded by the lower of `max_player_level` and `exp_curve_max_level` at runtime. ## Upgrade instructions 1. Stop the server and back up the world and `config/ras/` directory. 2. Replace the old mod JAR with the matching 4.0 JAR for the Minecraft version and loader. 3. Start once and review the existing validation output. 4. Keep existing configuration keys if custom behavior is desired; only missing keys receive 4.0 defaults. 5. Verify multiplayer allocation, relog persistence, and item/block restrictions before enabling the release in a public pack.

## Default maximum level The new-install default changes from level **50** to **100**. The level-cap implementation was already configurable and working; no replacement level system was introduced. `max_player_level` and `exp_curve_max_level` are both seeded to 100, and the generated explicit EXP list now covers levels 1–100. Existing settings files retain their current values because initialization only writes missing keys. ## Default balance changes | Setting | Previous default | 4.0 default | Reason | |---|---:|---:|---| | `max_player_level` | 50 | 100 | Gives one-point-per-level progression room for eight attributes without making every cap reachable. | | `exp_curve_max_level` | 50 | 100 | Keeps the active curve cap aligned with the new player cap. | | Generated explicit EXP entries | 1–50 | 1–100 | Prevents the default curve from ending halfway through the new progression. | | `levels_scale_default` | 1.001 | 1.02 | Makes fallback levels meaningful while remaining less steep than the early interval multipliers. | | Attack Power per point | 0.25 | 0.20 | A 40-point investment now adds 8 damage instead of 10, reducing one-shot pressure with weapon enchantments and effects. | | Attack Speed max | 50 | 40 | Caps the default bonus at +0.8 attack speed instead of +1.5. | | Attack Speed per point | 0.03 | 0.02 | Limits extreme swing-rate stacking with haste and weapon modifiers. | | Movement Speed max | 20 | 12 | Limits the default bonus to +0.03 over the 0.1 base, avoiding extreme travel/combat speed. | | Diamond tool/item lock | 10 | 12 | Places diamond equipment after early attribute investment. | | Netherite tool/item lock | 20 | 30 | Reserves Netherite for mid/late progression under the 100-level cap. | | Diamond ore block lock | 10 | 12 | Keeps mining progression aligned with diamond equipment. | | Ancient debris block lock | 20 | 30 | Keeps Netherite-material progression aligned with Netherite equipment. | Unchanged defaults remain deliberate: one point per level, 20 starting Health, +1 Health per point, armor +0.25 per point capped at 10, knockback resistance +0.01 capped at 0.8, toughness +0.10 capped at 5, luck +0.10 capped at 5, shared XP disabled, and respec cost disabled with the Scroll of Rebirth item available. Critical chance/damage, mining speed, strength, and separate respec-item settings are not independent default settings in the current implementation, so no new unsupported settings were invented. ## Bugs actually fixed - Combat-stat display now resolves both modern and legacy Minecraft attribute registry IDs and reads the final `AttributeInstance` value, including modifiers, instead of falling back to zero when a short legacy name such as `max_health` is configured. - The combat-stat screen discovers enabled display sections independently from allocation attributes and paginates eight rows per page. - The external HUD XP display now uses the same green XP textures and proportions as the RPG screen. - The Allocate and Combat Stats labels have improved contrast and centering. ## Configuration compatibility Existing configuration files are not overwritten. New defaults are written only when a key is absent. Existing custom maximum levels, explicit EXP arrays, scaling intervals, attributes, restrictions, respec settings, worlds, NBT, and player progress remain in effect. If an existing configuration is intentionally migrated by an operator, back it up first; 4.0 itself performs no automatic rewrite of existing values. Invalid values continue to pass through the existing validation/reporting path. Custom caps remain bounded by the lower of `max_player_level` and `exp_curve_max_level` at runtime. ## Upgrade instructions 1. Stop the server and back up the world and `config/ras/` directory. 2. Replace the old mod JAR with the matching 4.0 JAR for the Minecraft version and loader. 3. Start once and review the existing validation output. 4. Keep existing configuration keys if custom behavior is desired; only missing keys receive 4.0 defaults. 5. Verify multiplayer allocation, relog persistence, and item/block restrictions before enabling the release in a public pack.

## Default maximum level The new-install default changes from level **50** to **100**. The level-cap implementation was already configurable and working; no replacement level system was introduced. `max_player_level` and `exp_curve_max_level` are both seeded to 100, and the generated explicit EXP list now covers levels 1–100. Existing settings files retain their current values because initialization only writes missing keys. ## Default balance changes | Setting | Previous default | 4.0 default | Reason | |---|---:|---:|---| | `max_player_level` | 50 | 100 | Gives one-point-per-level progression room for eight attributes without making every cap reachable. | | `exp_curve_max_level` | 50 | 100 | Keeps the active curve cap aligned with the new player cap. | | Generated explicit EXP entries | 1–50 | 1–100 | Prevents the default curve from ending halfway through the new progression. | | `levels_scale_default` | 1.001 | 1.02 | Makes fallback levels meaningful while remaining less steep than the early interval multipliers. | | Attack Power per point | 0.25 | 0.20 | A 40-point investment now adds 8 damage instead of 10, reducing one-shot pressure with weapon enchantments and effects. | | Attack Speed max | 50 | 40 | Caps the default bonus at +0.8 attack speed instead of +1.5. | | Attack Speed per point | 0.03 | 0.02 | Limits extreme swing-rate stacking with haste and weapon modifiers. | | Movement Speed max | 20 | 12 | Limits the default bonus to +0.03 over the 0.1 base, avoiding extreme travel/combat speed. | | Diamond tool/item lock | 10 | 12 | Places diamond equipment after early attribute investment. | | Netherite tool/item lock | 20 | 30 | Reserves Netherite for mid/late progression under the 100-level cap. | | Diamond ore block lock | 10 | 12 | Keeps mining progression aligned with diamond equipment. | | Ancient debris block lock | 20 | 30 | Keeps Netherite-material progression aligned with Netherite equipment. | Unchanged defaults remain deliberate: one point per level, 20 starting Health, +1 Health per point, armor +0.25 per point capped at 10, knockback resistance +0.01 capped at 0.8, toughness +0.10 capped at 5, luck +0.10 capped at 5, shared XP disabled, and respec cost disabled with the Scroll of Rebirth item available. Critical chance/damage, mining speed, strength, and separate respec-item settings are not independent default settings in the current implementation, so no new unsupported settings were invented. ## Bugs actually fixed - Combat-stat display now resolves both modern and legacy Minecraft attribute registry IDs and reads the final `AttributeInstance` value, including modifiers, instead of falling back to zero when a short legacy name such as `max_health` is configured. - The combat-stat screen discovers enabled display sections independently from allocation attributes and paginates eight rows per page. - The external HUD XP display now uses the same green XP textures and proportions as the RPG screen. - The Allocate and Combat Stats labels have improved contrast and centering. ## Configuration compatibility Existing configuration files are not overwritten. New defaults are written only when a key is absent. Existing custom maximum levels, explicit EXP arrays, scaling intervals, attributes, restrictions, respec settings, worlds, NBT, and player progress remain in effect. If an existing configuration is intentionally migrated by an operator, back it up first; 4.0 itself performs no automatic rewrite of existing values. Invalid values continue to pass through the existing validation/reporting path. Custom caps remain bounded by the lower of `max_player_level` and `exp_curve_max_level` at runtime. ## Upgrade instructions 1. Stop the server and back up the world and `config/ras/` directory. 2. Replace the old mod JAR with the matching 4.0 JAR for the Minecraft version and loader. 3. Start once and review the existing validation output. 4. Keep existing configuration keys if custom behavior is desired; only missing keys receive 4.0 defaults. 5. Verify multiplayer allocation, relog persistence, and item/block restrictions before enabling the release in a public pack.

## Default maximum level The new-install default changes from level **50** to **100**. The level-cap implementation was already configurable and working; no replacement level system was introduced. `max_player_level` and `exp_curve_max_level` are both seeded to 100, and the generated explicit EXP list now covers levels 1–100. Existing settings files retain their current values because initialization only writes missing keys. ## Default balance changes | Setting | Previous default | 4.0 default | Reason | |---|---:|---:|---| | `max_player_level` | 50 | 100 | Gives one-point-per-level progression room for eight attributes without making every cap reachable. | | `exp_curve_max_level` | 50 | 100 | Keeps the active curve cap aligned with the new player cap. | | Generated explicit EXP entries | 1–50 | 1–100 | Prevents the default curve from ending halfway through the new progression. | | `levels_scale_default` | 1.001 | 1.02 | Makes fallback levels meaningful while remaining less steep than the early interval multipliers. | | Attack Power per point | 0.25 | 0.20 | A 40-point investment now adds 8 damage instead of 10, reducing one-shot pressure with weapon enchantments and effects. | | Attack Speed max | 50 | 40 | Caps the default bonus at +0.8 attack speed instead of +1.5. | | Attack Speed per point | 0.03 | 0.02 | Limits extreme swing-rate stacking with haste and weapon modifiers. | | Movement Speed max | 20 | 12 | Limits the default bonus to +0.03 over the 0.1 base, avoiding extreme travel/combat speed. | | Diamond tool/item lock | 10 | 12 | Places diamond equipment after early attribute investment. | | Netherite tool/item lock | 20 | 30 | Reserves Netherite for mid/late progression under the 100-level cap. | | Diamond ore block lock | 10 | 12 | Keeps mining progression aligned with diamond equipment. | | Ancient debris block lock | 20 | 30 | Keeps Netherite-material progression aligned with Netherite equipment. | Unchanged defaults remain deliberate: one point per level, 20 starting Health, +1 Health per point, armor +0.25 per point capped at 10, knockback resistance +0.01 capped at 0.8, toughness +0.10 capped at 5, luck +0.10 capped at 5, shared XP disabled, and respec cost disabled with the Scroll of Rebirth item available. Critical chance/damage, mining speed, strength, and separate respec-item settings are not independent default settings in the current implementation, so no new unsupported settings were invented. ## Bugs actually fixed - Combat-stat display now resolves both modern and legacy Minecraft attribute registry IDs and reads the final `AttributeInstance` value, including modifiers, instead of falling back to zero when a short legacy name such as `max_health` is configured. - The combat-stat screen discovers enabled display sections independently from allocation attributes and paginates eight rows per page. - The external HUD XP display now uses the same green XP textures and proportions as the RPG screen. - The Allocate and Combat Stats labels have improved contrast and centering. ## Configuration compatibility Existing configuration files are not overwritten. New defaults are written only when a key is absent. Existing custom maximum levels, explicit EXP arrays, scaling intervals, attributes, restrictions, respec settings, worlds, NBT, and player progress remain in effect. If an existing configuration is intentionally migrated by an operator, back it up first; 4.0 itself performs no automatic rewrite of existing values. Invalid values continue to pass through the existing validation/reporting path. Custom caps remain bounded by the lower of `max_player_level` and `exp_curve_max_level` at runtime. ## Upgrade instructions 1. Stop the server and back up the world and `config/ras/` directory. 2. Replace the old mod JAR with the matching 4.0 JAR for the Minecraft version and loader. 3. Start once and review the existing validation output. 4. Keep existing configuration keys if custom behavior is desired; only missing keys receive 4.0 defaults. 5. Verify multiplayer allocation, relog persistence, and item/block restrictions before enabling the release in a public pack.

## Default maximum level The new-install default changes from level **50** to **100**. The level-cap implementation was already configurable and working; no replacement level system was introduced. `max_player_level` and `exp_curve_max_level` are both seeded to 100, and the generated explicit EXP list now covers levels 1–100. Existing settings files retain their current values because initialization only writes missing keys. ## Default balance changes | Setting | Previous default | 4.0 default | Reason | |---|---:|---:|---| | `max_player_level` | 50 | 100 | Gives one-point-per-level progression room for eight attributes without making every cap reachable. | | `exp_curve_max_level` | 50 | 100 | Keeps the active curve cap aligned with the new player cap. | | Generated explicit EXP entries | 1–50 | 1–100 | Prevents the default curve from ending halfway through the new progression. | | `levels_scale_default` | 1.001 | 1.02 | Makes fallback levels meaningful while remaining less steep than the early interval multipliers. | | Attack Power per point | 0.25 | 0.20 | A 40-point investment now adds 8 damage instead of 10, reducing one-shot pressure with weapon enchantments and effects. | | Attack Speed max | 50 | 40 | Caps the default bonus at +0.8 attack speed instead of +1.5. | | Attack Speed per point | 0.03 | 0.02 | Limits extreme swing-rate stacking with haste and weapon modifiers. | | Movement Speed max | 20 | 12 | Limits the default bonus to +0.03 over the 0.1 base, avoiding extreme travel/combat speed. | | Diamond tool/item lock | 10 | 12 | Places diamond equipment after early attribute investment. | | Netherite tool/item lock | 20 | 30 | Reserves Netherite for mid/late progression under the 100-level cap. | | Diamond ore block lock | 10 | 12 | Keeps mining progression aligned with diamond equipment. | | Ancient debris block lock | 20 | 30 | Keeps Netherite-material progression aligned with Netherite equipment. | Unchanged defaults remain deliberate: one point per level, 20 starting Health, +1 Health per point, armor +0.25 per point capped at 10, knockback resistance +0.01 capped at 0.8, toughness +0.10 capped at 5, luck +0.10 capped at 5, shared XP disabled, and respec cost disabled with the Scroll of Rebirth item available. Critical chance/damage, mining speed, strength, and separate respec-item settings are not independent default settings in the current implementation, so no new unsupported settings were invented. ## Bugs actually fixed - Combat-stat display now resolves both modern and legacy Minecraft attribute registry IDs and reads the final `AttributeInstance` value, including modifiers, instead of falling back to zero when a short legacy name such as `max_health` is configured. - The combat-stat screen discovers enabled display sections independently from allocation attributes and paginates eight rows per page. - The external HUD XP display now uses the same green XP textures and proportions as the RPG screen. - The Allocate and Combat Stats labels have improved contrast and centering. ## Configuration compatibility Existing configuration files are not overwritten. New defaults are written only when a key is absent. Existing custom maximum levels, explicit EXP arrays, scaling intervals, attributes, restrictions, respec settings, worlds, NBT, and player progress remain in effect. If an existing configuration is intentionally migrated by an operator, back it up first; 4.0 itself performs no automatic rewrite of existing values. Invalid values continue to pass through the existing validation/reporting path. Custom caps remain bounded by the lower of `max_player_level` and `exp_curve_max_level` at runtime. ## Upgrade instructions 1. Stop the server and back up the world and `config/ras/` directory. 2. Replace the old mod JAR with the matching 4.0 JAR for the Minecraft version and loader. 3. Start once and review the existing validation output. 4. Keep existing configuration keys if custom behavior is desired; only missing keys receive 4.0 defaults. 5. Verify multiplayer allocation, relog persistence, and item/block restrictions before enabling the release in a public pack.

## Default maximum level The new-install default changes from level **50** to **100**. The level-cap implementation was already configurable and working; no replacement level system was introduced. `max_player_level` and `exp_curve_max_level` are both seeded to 100, and the generated explicit EXP list now covers levels 1–100. Existing settings files retain their current values because initialization only writes missing keys. ## Default balance changes | Setting | Previous default | 4.0 default | Reason | |---|---:|---:|---| | `max_player_level` | 50 | 100 | Gives one-point-per-level progression room for eight attributes without making every cap reachable. | | `exp_curve_max_level` | 50 | 100 | Keeps the active curve cap aligned with the new player cap. | | Generated explicit EXP entries | 1–50 | 1–100 | Prevents the default curve from ending halfway through the new progression. | | `levels_scale_default` | 1.001 | 1.02 | Makes fallback levels meaningful while remaining less steep than the early interval multipliers. | | Attack Power per point | 0.25 | 0.20 | A 40-point investment now adds 8 damage instead of 10, reducing one-shot pressure with weapon enchantments and effects. | | Attack Speed max | 50 | 40 | Caps the default bonus at +0.8 attack speed instead of +1.5. | | Attack Speed per point | 0.03 | 0.02 | Limits extreme swing-rate stacking with haste and weapon modifiers. | | Movement Speed max | 20 | 12 | Limits the default bonus to +0.03 over the 0.1 base, avoiding extreme travel/combat speed. | | Diamond tool/item lock | 10 | 12 | Places diamond equipment after early attribute investment. | | Netherite tool/item lock | 20 | 30 | Reserves Netherite for mid/late progression under the 100-level cap. | | Diamond ore block lock | 10 | 12 | Keeps mining progression aligned with diamond equipment. | | Ancient debris block lock | 20 | 30 | Keeps Netherite-material progression aligned with Netherite equipment. | Unchanged defaults remain deliberate: one point per level, 20 starting Health, +1 Health per point, armor +0.25 per point capped at 10, knockback resistance +0.01 capped at 0.8, toughness +0.10 capped at 5, luck +0.10 capped at 5, shared XP disabled, and respec cost disabled with the Scroll of Rebirth item available. Critical chance/damage, mining speed, strength, and separate respec-item settings are not independent default settings in the current implementation, so no new unsupported settings were invented. ## Bugs actually fixed - Combat-stat display now resolves both modern and legacy Minecraft attribute registry IDs and reads the final `AttributeInstance` value, including modifiers, instead of falling back to zero when a short legacy name such as `max_health` is configured. - The combat-stat screen discovers enabled display sections independently from allocation attributes and paginates eight rows per page. - The external HUD XP display now uses the same green XP textures and proportions as the RPG screen. - The Allocate and Combat Stats labels have improved contrast and centering. ## Configuration compatibility Existing configuration files are not overwritten. New defaults are written only when a key is absent. Existing custom maximum levels, explicit EXP arrays, scaling intervals, attributes, restrictions, respec settings, worlds, NBT, and player progress remain in effect. If an existing configuration is intentionally migrated by an operator, back it up first; 4.0 itself performs no automatic rewrite of existing values. Invalid values continue to pass through the existing validation/reporting path. Custom caps remain bounded by the lower of `max_player_level` and `exp_curve_max_level` at runtime. ## Upgrade instructions 1. Stop the server and back up the world and `config/ras/` directory. 2. Replace the old mod JAR with the matching 4.0 JAR for the Minecraft version and loader. 3. Start once and review the existing validation output. 4. Keep existing configuration keys if custom behavior is desired; only missing keys receive 4.0 defaults. 5. Verify multiplayer allocation, relog persistence, and item/block restrictions before enabling the release in a public pack.

- release 26.2

- release 26.2

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Bug Fixes * Restored `[param(X)]` as the per-point multiplier when present in `cmd_to_exc` (fixes armor and other stats not scaling correctly after v3.4.0) * Ported direct `minecraft:armor` / attribute `base set` application to all loaders (1.20.1, 1.21.1, 1.21.11, 26.1.2) with `generic.*` alias support * Implemented missing legacy config migration (`generic.armor` → `minecraft:armor` in commands and display configs) ### Improvements * `ConfigValidator` warns when `[param(X)]` differs from `base_value_per_point` * Reduced redundant player sync calls when allocating points on 26.1.2 * Logs a warning when attribute `base set` cannot be applied directly and falls back to commands ### Configuration * Armor default `max_level` corrected to `10` (total armor value cap, +10 at 40 points with `param(0.25)`) * Updated `docs/HEALTH_SCALING.md`, `docs/CONFIGURATION.md`, and `docs/CONFIGURATION_TABLE.md` for param scaling semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

### Added - Full respec system with `/ras respec`, config (`ras/respec.json`), permissions, cooldown, and cost types - Attribute templates with `/ras template apply` and `/ras template list` - Player statistics overview GUI (scrollable breakdown + configurable totals) - `ConfigValidator` with `[RPGAS]` startup diagnostics - Public API: `tn.nightbeam.ras.api.RasApi` - Documentation in `docs/` (respec, templates, custom attributes, health scaling, commands, permissions, multiplayer) ### Improved - Custom attribute reliability: extended sync payload (init value, tips), client uses `AttributeManager` cache - Orphan attribute NBT keys preserved on login - Health scaling documentation and validation warnings - Multiplayer sync: single sync after point allocation (reduced packet spam) - Config validation for attributes, templates, and settings ### Fixed - `DisplayLogicLockAttributeGenericProcedure` reading server config on client - `ReturnAttributeNameGenericProcedure` / `ReturnAttributeTipGenericProcedure` using synced cache - Documentation mismatch for `[param(X)]` and `max_level` semantics

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

- Major Balance Changes - Fixed Multiple Bugs

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

### Fixes - Fixed Health scaling issue where increasing `base_value_per_point` reduced HP instead of increasing it. - Corrected attribute scaling formula to ensure consistent and linear stat growth across all attributes. ### Config - Fixed config overwrite issue where default values were injected into existing attribute configs. - Resolved bug causing attributes (e.g. movement speed) to reappear after being removed. - Prevented cross-attribute config corruption (e.g. Health appearing under Attack). ### Improvements - Config system now fully respects user-defined values. - Added strict config mode to disable automatic config modifications. - Improved config loading stability (no duplicates, no reordering, no silent changes).

- Updated the Fabric and NeoForge versions to the latest compatible builds. - Updated the JAUML dependencies to improve stability and prevent crashes. - Fixed an issue where breaking certain blocks could crash the game. - Fixed multiple balance-related issues to improve overall gameplay consistency.

- Updated the Fabric and NeoForge versions to the latest compatible builds. - Updated the JAUML dependencies to improve stability and prevent crashes. - Fixed an issue where breaking certain blocks could crash the game. - Fixed multiple balance-related issues to improve overall gameplay consistency.

- Fixed an issue that prevented the mod from loading correctly on NeoForge. - Fixed an issue where certain items were not displaying properly in-game. - Updated all development dependencies to their latest compatible versions for improved stability and maintainability.

- Fixed an issue that prevented the mod from loading correctly on NeoForge. - Fixed an issue where certain items were not displaying properly in-game. - Updated all development dependencies to their latest compatible versions for improved stability and maintainability.

- Fixed the missing creative tab on Fabric 1.21.1. - Fixed a major Fabric 1.21.1 issue where spending attribute points did not actually apply stat bonuses. - Fixed attribute point allocation so added points now correctly update player stats. - Fixed synchronization between the attribute UI and the real backend stat logic. - Fixed cases where players received initial points, but further point investment had no gameplay effect. - Updated the NeoForge 1.21.1 version to the latest supported NeoForge build. - Improved Fabric and NeoForge compatibility for better stability. - Improved overall RPG attribute logic and stat application reliability.

- Fixed the missing creative tab on Fabric 1.21.1. - Fixed a major Fabric 1.21.1 issue where spending attribute points did not actually apply stat bonuses. - Fixed attribute point allocation so added points now correctly update player stats. - Fixed synchronization between the attribute UI and the real backend stat logic. - Fixed cases where players received initial points, but further point investment had no gameplay effect. - Updated the NeoForge 1.21.1 version to the latest supported NeoForge build. - Improved Fabric and NeoForge compatibility for better stability. - Improved overall RPG attribute logic and stat application reliability.

- Updated all Fabric loader requirements to the latest supported versions. - Fixed an issue where the mod could launch without the required JAUML libraries. - Fixed a Fabric 1.20.1 issue where the core RPG attribute logic was not running correctly. - Fixed the creative tab not displaying properly on Fabric 1.20.1. - Improved internal mod logic for better stability, reliability, and consistency.

- Updated all Fabric loader requirements to the latest supported versions. - Fixed an issue where the mod could launch without the required JAUML libraries. - Fixed a Fabric 1.20.1 issue where the core RPG attribute logic was not running correctly. - Fixed the creative tab not displaying properly on Fabric 1.20.1. - Improved internal mod logic for better stability, reliability, and consistency.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Fixed HUD overlapping with JEI interface. - Added configurable HUD scaling and positioning. - Improved compatibility with inventory overlays (JEI/REI). - Fixed cursor jumping to center when switching tabs. - Improved UI compactness and readability.

- Removed some left over debug messages.

- Removed some left over debug messages.

- Removed some left over debug messages.

- Removed some left over debug messages.

- Removed some left over debug messages.

- Removed some left over debug messages.

- Removed some left over debug messages.

- Removed some left over debug messages.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

## Updates - Changed the leveling logic and now the levels are no longer tied to the number of attributes assigned. ## Fixes - Player attributes now reload from the server's saved player data on login, respawn, dimension change, and player clone. - Attribute application is refreshed from saved stats each time, so relogging no longer drops RAS bonuses or creates duplicate modifier state. - Reset and Scroll of Rebirth now restore configured initial/default attribute values instead of leaving attributes empty or at 0. - Singleplayer and multiplayer both use the server-side saved values as the source of truth.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

- Fixed a bug that caused the player stats not to sync properly between client and server. - Fixed a bug that caused the scroll of rebirth not to work properly. - Updated version 26.1.1 to 26.1.2.

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

## Fixes - Fixed multiplayer attribute desync caused by `@p` command selector targeting nearest player instead of source player - Fixed players receiving incorrect max health and other attributes when joining near another player - Fixed attribute sync missing after respawn on Fabric (UI showed Level 0 after death) - Fixed stale attribute entries persisting in PlayerVariables after sync and clone operations - Fixed NeoForge double-copy on death causing undefined clone behavior ## Improvements - Improved cross-loader attribute synchronization consistency (Fabric + NeoForge) - Improved thread safety in AttributeManager for LAN/integrated server environments

- release neoforge-26.1

- release fabric-26.1

- Fixed service loader configuration to avoid NeoForge startup crash. - Ensured only correct platform-specific implementations are discovered. - Updated NeoForge build script and version to `21.11.38-beta` and `3.0.1_hf`. - Removed all template `com.example.examplemod` service references.

- Fixed service loader configuration to avoid NeoForge startup crash. - Ensured only correct platform-specific implementations are discovered. - Updated NeoForge build script and version to `21.11.38-beta` and `3.0.1_hf`. - Removed all template `com.example.examplemod` service references.

- Fixed /ras lock and /ras unlock so they now correctly lock and unlock attributes. - Fixed level/attribute lock state not updating in-game. - Fixed attributes GUI hotkey conflict that could open JEI at the same time. - Fixed player skills and attributes resetting on death when death reset is disabled in config. - Default keybind for opening the attributes menu is now K (can still be changed in Controls).

- Fixed /ras lock and /ras unlock so they now correctly lock and unlock attributes. - Fixed level/attribute lock state not updating in-game. - Fixed attributes GUI hotkey conflict that could open JEI at the same time. - Fixed player skills and attributes resetting on death when death reset is disabled in config. - Default keybind for opening the attributes menu is now K (can still be changed in Controls).

* Fixed a bug where the mod would break the advancements tab. * Fixed /ras lock and /ras unlock so they now correctly lock and unlock attributes. * Fixed level/attribute lock state not updating in-game. * Fixed attributes GUI hotkey conflict that could open JEI at the same time. * Fixed player skills and attributes resetting on death when death reset is disabled in config. * Default keybind for opening the attributes menu is now K (can still be changed in Controls).

* Fixed a bug where the mod would break the advancements tab. * Fixed /ras lock and /ras unlock so they now correctly lock and unlock attributes. * Fixed level/attribute lock state not updating in-game. * Fixed attributes GUI hotkey conflict that could open JEI at the same time. * Fixed player skills and attributes resetting on death when death reset is disabled in config. * Default keybind for opening the attributes menu is now K (can still be changed in Controls).

* Fixed a bug where the mod would break the advancements tab. * Fixed /ras lock and /ras unlock so they now correctly lock and unlock attributes. * Fixed level/attribute lock state not updating in-game. * Fixed attributes GUI hotkey conflict that could open JEI at the same time. * Fixed player skills and attributes resetting on death when death reset is disabled in config. * Default keybind for opening the attributes menu is now K (can still be changed in Controls).

* Fixed /ras lock and /ras unlock so they now correctly lock and unlock attributes. * Fixed level/attribute lock state not updating in-game. * Fixed attributes GUI hotkey conflict that could open JEI at the same time. * Fixed player skills and attributes resetting on death when death reset is disabled in config. * Default keybind for opening the attributes menu is now K (can still be changed in Controls).

- HF : fixed a bug that caused failure to break minable block.

- HF : fixed a bug that caused failure to break minable block.

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://nightbeam.gitbook.io/rpg-attribute-system/getting-started/change-log-and-roadmap">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://nightbeam.gitbook.io/rpg-attribute-system/getting-started/change-log-and-roadmap">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://nightbeam.gitbook.io/rpg-attribute-system/getting-started/change-log-and-roadmap">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://nightbeam.gitbook.io/rpg-attribute-system/getting-started/change-log-and-roadmap">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://nightbeam.gitbook.io/rpg-attribute-system/getting-started/change-log-and-roadmap">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://nightbeam.gitbook.io/rpg-attribute-system/getting-started/change-log-and-roadmap">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

<span style="color: rgb(35, 111, 161);"><strong><a style="color: rgb(35, 111, 161);" href="https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md" target="_blank" rel="noopener noreferrer">Change Log</a></strong></span>

## 🚀 New Features - **JAUML Library Integration**: Added support for the JAUML library, unlocking new possibilities for mod compatibility and performance. - **JSON Config Overhaul**: Say goodbye to `.toml`! The `drop_rate`, `items_lock`, and `levelup_rewards` config files are now in `.json` format for easier management and consistency. - **Default Drop Rate Config**: Introduced a `default_drop_rate` config that applies across all dimensions, ensuring seamless gameplay even if specific dimension settings are missing. - **Items Lock Mining Restrictions**: The Items Lock system now prevents mining specific blocks until you meet the required stats, adding strategic depth to resource gathering. - **Hot Reload for JSON Configs**: Change any `.json` config file, and watch it auto-reload in-game for real-time testing and tweaking—no restarts needed! ## 🛠️ Bug Fixes - **Level Up Rewards Fix**: Resolved an issue that prevented random level-up rewards from functioning correctly. - **Armor Duplication Bug**: Fixed a bug where equipping restricted armor via the main hand would duplicate the armor or fail to swap properly. - **UI Polish**: Implemented minor UI fixes and tweaks for a smoother, more professional look.

## 🚀 New Features - **JAUML Library Integration**: Added support for the JAUML library, unlocking new possibilities for mod compatibility and performance. - **JSON Config Overhaul**: Say goodbye to `.toml`! The `drop_rate`, `items_lock`, and `levelup_rewards` config files are now in `.json` format for easier management and consistency. - **Default Drop Rate Config**: Introduced a `default_drop_rate` config that applies across all dimensions, ensuring seamless gameplay even if specific dimension settings are missing. - **Items Lock Mining Restrictions**: The Items Lock system now prevents mining specific blocks until you meet the required stats, adding strategic depth to resource gathering. - **Hot Reload for JSON Configs**: Change any `.json` config file, and watch it auto-reload in-game for real-time testing and tweaking—no restarts needed! ## 🛠️ Bug Fixes - **Level Up Rewards Fix**: Resolved an issue that prevented random level-up rewards from functioning correctly. - **Armor Duplication Bug**: Fixed a bug where equipping restricted armor via the main hand would duplicate the armor or fail to swap properly. - **UI Polish**: Implemented minor UI fixes and tweaks for a smoother, more professional look.

## 🚀 New Features - **JAUML Library Integration**: Added support for the JAUML library, unlocking new possibilities for mod compatibility and performance. - **JSON Config Overhaul**: Say goodbye to `.toml`! The `drop_rate`, `items_lock`, and `levelup_rewards` config files are now in `.json` format for easier management and consistency. - **Default Drop Rate Config**: Introduced a `default_drop_rate` config that applies across all dimensions, ensuring seamless gameplay even if specific dimension settings are missing. - **Items Lock Mining Restrictions**: The Items Lock system now prevents mining specific blocks until you meet the required stats, adding strategic depth to resource gathering. - **Hot Reload for JSON Configs**: Change any `.json` config file, and watch it auto-reload in-game for real-time testing and tweaking—no restarts needed! ## 🛠️ Bug Fixes - **Level Up Rewards Fix**: Resolved an issue that prevented random level-up rewards from functioning correctly. - **Armor Duplication Bug**: Fixed a bug where equipping restricted armor via the main hand would duplicate the armor or fail to swap properly. - **UI Polish**: Implemented minor UI fixes and tweaks for a smoother, more professional look.

- **Added** new XP level display in the **Stats** menu. - **Added** option to level up an attribute up to **10 times at once**. - **Updated** default UI theme for improved clarity and consistency. - **Improved** navigation: switching between the **Stats** menu and **Attributes** menu no longer resets mouse position. - **Enhanced** unspent points message: now clearly shows how many points are available to allocate. - **Fixed** display bug for attribute **NB 2**: now shows integers (e.g., `##`) instead of decimals (e.g., `##.##`). - **Fixed** various icon display problems in the GUI. - **Fixed** several GUI alignment issues for a more polished look.

- **Added** new XP level display in the **Stats** menu. - **Added** option to level up an attribute up to **10 times at once**. - **Updated** default UI theme for improved clarity and consistency. - **Improved** navigation: switching between the **Stats** menu and **Attributes** menu no longer resets mouse position. - **Enhanced** unspent points message: now clearly shows how many points are available to allocate. - **Fixed** display bug for attribute **NB 2**: now shows integers (e.g., `##`) instead of decimals (e.g., `##.##`). - **Fixed** various icon display problems in the GUI. - **Fixed** several GUI alignment issues for a more polished look.

- **Added** new XP level display in the **Stats** menu. - **Added** option to level up an attribute up to **10 times at once**. - **Updated** default UI theme for improved clarity and consistency. - **Improved** navigation: switching between the **Stats** menu and **Attributes** menu no longer resets mouse position. - **Enhanced** unspent points message: now clearly shows how many points are available to allocate. - **Fixed** display bug for attribute **NB 2**: now shows integers (e.g., `##`) instead of decimals (e.g., `##.##`). - **Fixed** various icon display problems in the GUI. - **Fixed** several GUI alignment issues for a more polished look.

- **Added** new XP level display in the **Stats** menu. - **Added** option to level up an attribute up to **10 times at once**. - **Updated** default UI theme for improved clarity and consistency. - **Improved** navigation: switching between the **Stats** menu and **Attributes** menu no longer resets mouse position. - **Enhanced** unspent points message: now clearly shows how many points are available to allocate. - **Fixed** display bug for attribute **NB 2**: now shows integers (e.g., `##`) instead of decimals (e.g., `##.##`). - **Fixed** various icon display problems in the GUI. - **Fixed** several GUI alignment issues for a more polished look.

- Fixed an issue where item locking incorrectly applied to components sharing the same starting name as the tool - Fixed an issue that caused some configs to generate with extra space inside of them.

- Fixed an issue where item locking incorrectly applied to components sharing the same starting name as the tool - Fixed an issue that caused some configs to generate with extra space inside of them.

- Fixed an issue where item locking incorrectly applied to components sharing the same starting name as the tool - Fixed an issue that caused some configs to generate with extra space inside of them.

- Fixed an issue where item locking incorrectly applied to components sharing the same starting name as the tool - Fixed an issue that caused some configs to generate with extra space inside of them.

- Fixed an issue where item locking incorrectly applied to components sharing the same starting name as the tool - Fixed an issue that caused some configs to generate with extra space inside of them.

- Fixed a bug where the display option overlay wasn't hiding the VP bar. - Fixed a bug that caused "DEBUG" messages to appear when holding a locked item. - Removed unused VP parameters from drop_rate_config.toml.

- Fixed a bug where the display option overlay wasn't hiding the VP bar. - Fixed a bug that caused "DEBUG" messages to appear when holding a locked item. - Removed unused VP parameters from `drop_rate_config.toml`.

- Fixed a bug where the display option overlay wasn't hiding the VP bar. - Fixed a bug that caused "DEBUG" messages to appear when holding a locked item. - Removed unused VP parameters from `drop_rate_config.toml`.

- Fixed a bug where the display option overlay wasn't hiding the VP bar. - Fixed a bug that caused "DEBUG" messages to appear when holding a locked item. - Removed unused VP parameters from `drop_rate_config.toml`.

- Fixed a bug where the display option overlay wasn't hiding the VP bar. - Fixed a bug that caused "DEBUG" messages to appear when holding a locked item. - Removed unused VP parameters from `drop_rate_config.toml`.

- Added option to toggle item locking - Added option to enable and disable items requirements tool tips - The item locking system now works with armors - Added custom dimensions support to set the VP drop values

- Added option to toggle item locking - Added option to enable and disable items requirements tool tips - The item locking system now works with armors - Added custom dimensions support to set the VP drop values

- Added option to toggle item locking - Added option to enable and disable items requirements tool tips - The item locking system now works with armors - Added custom dimensions support to set the VP drop values

- Added option to toggle item locking - Added option to enable and disable items requirements tool tips - The item locking system now works with armors - Added custom dimensions support to set the VP drop values

- Added option to toggle item locking - Added option to enable and disable items requirements tool tips - The item locking system now works with armors - Added custom dimensions support to set the VP drop values

Need a server ? [click here](https://www.bisecthosting.com/curseforge?curseforge_project_id=1079687&dl=1) **[<span style="color: rgb(35, 111, 161);">Change Log</span>](https://github.com/MeherBenSalem/Motp/blob/main/CHANGELOG.md)**

- Added param in attributeGUI.toml to disable the stats attribute screen - Changed debug messages in configurations

- Added param in attributeGUI.toml to disable the stats attribute screen - Changed debug messages in configurations

- Added param in attributeGUI.toml to disable the stats attribute screen - Changed debug messages in configurations

- Added param in attributeGUI.toml to disable the stats attribute screen - Changed debug messages in configurations

## Changelog [1.5.0] - **Locked Items Tooltip:** Now renders at the bottom instead. - **Artifact Tooltips:** Removed printed required tooltips from artifacts - **Block Placement Restriction:** Added support to deny placing blocks - **Custom Messages:** Each individual action on locked items now has a custom message. - **XP Option:** Added an option to give `vanilla_xp` when `enable_drops` is off. - **Community Feedback:** Your feedback is crucial! Please vote this will shape the future of the mod - 🗳️ **Vote here:** [Vote Now](https://forms.gle/XGSRBML4LW7gAY5x6) - **Renamed Features:** - `random rewards` → `random events` (New format: `[level]LEVEL[levelEnd]CMD_TO_EXC_AT_THAT_LEVEL`) - `levelup_rewards.toml` → `levelup_events.toml` - **New Feature:** Added `on_level_event`, which executes separately when leveling an attribute