QCherry: Document expanded scripting capacities and complete audited limits for 0.1.3 BUILD81

2026-09-12T11:51:32Z

Document expanded scripting capacities and complete audited limits for 0.1.3 BUILD81

New page

{{DISPLAYTITLE:Player statistic limits}}
'''Current in update 0.1.3, expanded-budget BUILD81; audited 2026-09-12.''' These statistic ranges were '''not raised''' by the scripting-capacity update: gameplay values are separate from Lua VM storage.

<code>setPlayerStat</code> and its named stat setters reject unknown keys/non-finite values and clamp finite numeric values to the catalog range below. Further authoritative rules still apply (for example current health versus max health, life state and equipment). This table is not a promise that every underlying single-player attribute has independent gameplay support. Query [[getPlayerStatLimits]] and [[getPlayerStatNames]] rather than copying assumptions into a gamemode. See [[Scripting limits]].

== All 59 catalog ranges ==
{| class="wikitable sortable"
! Stat key !! Minimum !! Maximum
|-
| <code>alcohol</code> || 0 || 100000
|-
| <code>max_alcohol</code> || 0 || 100000
|-
| <code>alcohol_depletion_rate</code> || 0 || 100000
|-
| <code>super_armor</code> || 0 || 100000
|-
| <code>max_super_armor</code> || 0 || 100000
|-
| <code>resistance_blunt</code> || 0 || 100000
|-
| <code>resistance_edge</code> || 0 || 100000
|-
| <code>resistance_point</code> || 0 || 100000
|-
| <code>resistance_fire</code> || 0 || 100000
|-
| <code>resistance_energy</code> || 0 || 100000
|-
| <code>resistance_ice</code> || 0 || 100000
|-
| <code>resistance_wind</code> || 0 || 100000
|-
| <code>resistance_falling</code> || 0 || 100000
|-
| <code>dexterity</code> || 0 || 100000
|-
| <code>fatigue</code> || 0 || 100000
|-
| <code>max_fatigue</code> || 0 || 100000
|-
| <code>fatigue_fill_ratio</code> || 0 || 100000
|-
| <code>fatigue_fill_ratio_period</code> || 0 || 100000
|-
| <code>fatigue_max_threshold_index</code> || 0 || 100000
|-
| <code>fatigue_recovery_per_sleep_hour</code> || 0 || 100000
|-
| <code>health</code> || 0 || 100000
|-
| <code>max_health</code> || 1 || 100000
|-
| <code>damage_multiplier</code> || 0 || 100
|-
| <code>health_recovery_per_sleep_hour</code> || 0 || 100000
|-
| <code>level</code> || 0 || 1000
|-
| <code>experience</code> || 0 || 1000000000
|-
| <code>skill_points</code> || 0 || 1000000
|-
| <code>xp_executed_bounty</code> || 0 || 1000000000
|-
| <code>xp_kill_or_defeat_bounty</code> || 0 || 1000000000
|-
| <code>toughness</code> || 0 || 100000
|-
| <code>toughness_a</code> || 0 || 100000
|-
| <code>toughness_b</code> || 0 || 100000
|-
| <code>toughness_c</code> || 0 || 100000
|-
| <code>lockpick_durability</code> || 0 || 100000
|-
| <code>lockpick_precision</code> || 0 || 100000
|-
| <code>mana</code> || 0 || 100000
|-
| <code>max_mana</code> || 0 || 100000
|-
| <code>magician_level</code> || 0 || 6
|-
| <code>mana_recovery_per_sleep_hour</code> || 0 || 100000
|-
| <code>speed_modifier</code> || 0 || 100
|-
| <code>oxygen</code> || 0 || 100000
|-
| <code>max_oxygen</code> || 0 || 100000
|-
| <code>oxygen_depletion_rate</code> || 0 || 100000
|-
| <code>oxygen_recovery_rate</code> || 0 || 100000
|-
| <code>oxygen_critical_level_percent</code> || 0 || 100
|-
| <code>pickpocketing</code> || 0 || 100000
|-
| <code>sleep_time</code> || 0 || 100000
|-
| <code>max_sleep_time</code> || 0 || 100000
|-
| <code>sleep_recovery_amount</code> || 0 || 100000
|-
| <code>sleep_recovery_period</code> || 0 || 100000
|-
| <code>max_rest_time</code> || 0 || 100000
|-
| <code>strength</code> || 0 || 100000
|-
| <code>critical_fists</code> || 0 || 100
|-
| <code>critical_one_hand</code> || 0 || 100
|-
| <code>critical_two_hand</code> || 0 || 100
|-
| <code>critical_orc</code> || 0 || 100
|-
| <code>swampweed</code> || 0 || 100000
|-
| <code>max_swampweed</code> || 0 || 100000
|-
| <code>swampweed_depletion_rate</code> || 0 || 100000
|}

== Source audit ==
<code>shared/PlayerProgressionCatalog.hpp</code> (Stats, 59 entries); <code>server/src/scripting/ScriptRuntime.cpp</code> (set_player_stat_value).

[[Category:Lua API]]

Player statistic limits - Revision history

QCherry: Document expanded scripting capacities and complete audited limits for 0.1.3 BUILD81