Skip to main content

​
Stats Level Config

File: mods/Zuxaw_RPGLeveling/StatsLevelConfig.json All stat-related configuration options. Controls stat points per level, stat values, max allocations, and stat-specific mechanics.

​
Configuration Options

OptionTypeDefaultDescription
StatPointsPerLevelInteger5Stat points earned per level up
StatValuePerPointDouble1.0Default stat value per point for resource stats (used when per-stat key not set)
HealthStatValuePerPointDouble1.0Health increase per Health point
StaminaStatValuePerPointDouble1.0Stamina increase per Stamina point
ManaStatValuePerPointDouble1.0Mana increase per Mana point
AmmoStatValuePerPointDouble1.0Ammo capacity increase per Ammo point
OxygenStatValuePerPointDouble1.0Oxygen increase per Oxygen point
DamageStatValuePerPointDouble1.5Multiplicative damage bonus per Damage point (% per point)
CriticalDamageStatValuePerPointDouble0.2Critical hit chance % per Critical Damage point (e.g. 50 pts × 0.2 = 10% chance)
MiningStatValuePerPointDouble0.5Block damage multiplier per Mining point
WoodcuttingStatValuePerPointDouble0.5Block damage multiplier per Woodcutting point
DefenseStatValuePerPointDouble1.5Effective weight per Defense point (linear display %; diminishing curve, max 80%)
DefenseMaxReductionRatioDouble0.8Maximum damage reduction ratio for Defense stat (80% = 80% max reduction)
BlockDamageScalingDivisorDouble25.0Divisor for Mining/Woodcutting block damage multiplier
MiningPerTickDivisorDouble100.0Divisor for per-tick block damage bonus
StaminaConsumptionValuePerPointDouble0.01Stamina consumption reduction per point (1% per point)
StaminaRegenSpeedValuePerPointDouble0.18Stamina regen speed per point (18% per point)
MaxStatPointsHealthInteger50Max allocatable to Health
MaxStatPointsStaminaInteger50Max allocatable to Stamina
MaxStatPointsManaInteger50Max allocatable to Mana
MaxStatPointsAmmoInteger4Max allocatable to Ammo
MaxStatPointsOxygenInteger50Max allocatable to Oxygen
MaxStatPointsStaminaRegenSpeedInteger50Max allocatable to StaminaRegenSpeed
MaxStatPointsStaminaConsumptionInteger50Max allocatable to StaminaConsumption
MaxStatPointsDamageInteger50Max allocatable to Damage
MaxStatPointsCriticalDamageInteger50Max allocatable to Critical Damage
MaxStatPointsMiningInteger50Max allocatable to Mining
MaxStatPointsWoodcuttingInteger50Max allocatable to Woodcutting
MaxStatPointsDefenseInteger50Max allocatable to Defense
MovementSpeedStatValuePerPointDouble1.0Movement speed increase per point (%); e.g. 1.0 = 1% per point. Applied to ground movement.
MaxStatPointsMovementSpeedInteger50Max allocatable to Movement Speed
ManaRegenSpeedValuePerPointDouble0.18Mana regeneration speed multiplier per point (e.g. 0.18 = 18% faster per point). Only applies when mana is naturally regenerating.
MaxStatPointsManaRegenSpeedInteger50Max allocatable to Mana Regen
BlacklistedStatsString""Comma-separated stat names to disable/hide

​
Stat Points

​
Points Per Level

  • StatPointsPerLevel — How many stat points you earn on each level up (default: 5)
Total stat points at max level: 
Total = (MaxLevel - 1) × StatPointsPerLevel
Example: Max level 100, 5 points per level:
  • Total: (100 - 1) × 5 = 495 stat points

​
Base Stats

Stats that directly increase resource pools. Each has its own value-per-point key (default 1.0); if not set, StatValuePerPoint is used:
  • Health — HealthStatValuePerPoint (default: 1.0)
  • Stamina — StaminaStatValuePerPoint (default: 1.0)
  • Mana — ManaStatValuePerPoint (default: 1.0)
  • Ammo — AmmoStatValuePerPoint (default: 1.0)
  • Oxygen — OxygenStatValuePerPoint (default: 1.0)

​
Combat Stats

​
Damage

Multiplicative damage bonus to NPCs:
  • Value per point: DamageStatValuePerPoint (default: 1.5)
  • Formula: damage = baseDamage × (1 + statLevel × DamageStatValuePerPoint / 100) — e.g. 1.5% per point (50 points = 75% bonus = 1.75× damage).
  • GUI icon: Weapon_Longsword_Flame

​
Critical Damage

Chance to deal a critical hit (damage multiplied by a random value between 1.5× and 2.0×). When a critical hit occurs, the player receives a notification showing the damage value (styled in red).
  • Value per point: CriticalDamageStatValuePerPoint (default: 0.2) — 0.2% chance per point (e.g. 50 points = 10% chance; at 0.5 per point, 50 points = 25% chance).
  • Formula: on each hit, roll; if random < (points × valuePerPoint / 100) then multiply damage by random(1.5, 2.0).
  • GUI icon: Weapon_Longsword_Adamantite_Saurian (displayed next to Damage in the Stats GUI).

​
Defense

Percentage damage reduction with diminishing returns. The GUI shows a linear value (points × valuePerPoint %); the actual reduction uses a diminishing curve.
  • Value per point: DefenseStatValuePerPoint (default: 1.5) — effective weight per point (display: 1 pt = 1.5%; curve caps at 80%).
  • Max reduction: DefenseMaxReductionRatio (default: 0.8 = 80%)
  • Formula: reduction = DefenseMaxReductionRatio × effective / (effective + 50) with effective = points × DefenseStatValuePerPoint
Example: With default settings, you can reach up to 80% damage reduction, but each additional point becomes less effective as you approach the cap.

​
Gathering Stats

​
Mining

Damage bonus to stone/ore blocks:
  • Value per point: MiningStatValuePerPoint (default: 0.5)
  • Scaling divisor: BlockDamageScalingDivisor (default: 25.0)
  • Per-tick divisor: MiningPerTickDivisor (default: 100.0)
Higher Mining stat = faster stone/ore breaking.

​
Woodcutting

Damage bonus to wood blocks:
  • Value per point: WoodcuttingStatValuePerPoint (default: 0.5)
  • Uses same scaling as Mining
Higher Woodcutting stat = faster tree/wood breaking.

​
Stamina Stats

​
Stamina Regen Speed

Increases how fast stamina regenerates:
  • Value per point: StaminaRegenSpeedValuePerPoint (default: 0.18 = 18% per point)
Example: 10 points = 180% faster stamina regen (2.8× normal speed)

​
Stamina Consumption

Reduces stamina consumption when performing actions:
  • Value per point: StaminaConsumptionValuePerPoint (default: 0.01 = 1% per point)
Example: 25 points = 25% less stamina consumption

​
Movement Speed

Increases player ground movement speed. Especially useful for melee and repositioning.
  • Value per point: MovementSpeedStatValuePerPoint (default: 1.0 = 1% per point)
  • Formula: Movement speed multiplier = 1 + (total effective points × valuePerPoint / 100). Total points = allocated + class innate bonus from level.
  • GUI icon: Tree Sap (Ingredient_Tree_Sap)

​
Mana Regen

Increases how fast mana regenerates. Especially relevant for the Arcane class and magical weapons (mana is used in Hytale for spells/magic).
  • Value per point: ManaRegenSpeedValuePerPoint (default: 0.18 = 18% per point)
  • Formula: Regen speed multiplier = 1 + (allocated points × valuePerPoint). Only applies when mana is naturally regenerating (not when spending).
  • GUI icon: Staff Crystal Ice (Weapon_Staff_Crystal_Ice)

​
Max Stat Allocations

Each stat has a maximum number of points you can allocate:
StatDefault Max
Health50
Stamina50
Mana50
Ammo4
Oxygen50
StaminaRegenSpeed50
StaminaConsumption50
Damage50
Critical Damage50
Mining50
Woodcutting50
Defense50
Movement Speed50
Mana Regen50
Set to 0 to effectively disable a stat, or increase for more specialization.

​
Blacklisted Stats

Hide or disable specific stats from the GUI: 
{
  "BlacklistedStats": "Ammo,Oxygen"
}
Blacklisted stats:
  • Do not appear in the stats GUI
  • Cannot be allocated
  • Are comma-separated stat names

​
Example Config (Default Values)

{
  "StatPointsPerLevel": 5,
  "StatValuePerPoint": 1.0,
  "HealthStatValuePerPoint": 1.0,
  "StaminaStatValuePerPoint": 1.0,
  "ManaStatValuePerPoint": 1.0,
  "AmmoStatValuePerPoint": 1.0,
  "OxygenStatValuePerPoint": 1.0,
  "DamageStatValuePerPoint": 1.5,
  "CriticalDamageStatValuePerPoint": 0.2,
  "MiningStatValuePerPoint": 0.5,
  "WoodcuttingStatValuePerPoint": 0.5,
  "DefenseStatValuePerPoint": 1.5,
  "DefenseMaxReductionRatio": 0.8,
  "BlockDamageScalingDivisor": 25.0,
  "MiningPerTickDivisor": 100.0,
  "StaminaConsumptionValuePerPoint": 0.01,
  "StaminaRegenSpeedValuePerPoint": 0.18,
  "MaxStatPointsHealth": 50,
  "MaxStatPointsStamina": 50,
  "MaxStatPointsMana": 50,
  "MaxStatPointsAmmo": 4,
  "MaxStatPointsOxygen": 50,
  "MaxStatPointsStaminaRegenSpeed": 50,
  "MaxStatPointsStaminaConsumption": 50,
  "MaxStatPointsDamage": 50,
  "MaxStatPointsCriticalDamage": 50,
  "MaxStatPointsMining": 50,
  "MaxStatPointsWoodcutting": 50,
  "MaxStatPointsDefense": 50,
  "MovementSpeedStatValuePerPoint": 1.0,
  "MaxStatPointsMovementSpeed": 50,
  "ManaRegenSpeedValuePerPoint": 0.18,
  "MaxStatPointsManaRegenSpeed": 50,
  "BlacklistedStats": ""
}

​
File location and reload

  • Path: mods/Zuxaw_RPGLeveling/StatsLevelConfig.json
  • This file is reloaded by /lvl reload. See Configuration Overview.

​
See Also