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


Stat Points

Points Per Level

  • StatPointsPerLevel - How many stat points you earn on each level up (default: 5)
Total stat points at max level:
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.

Harvest

Added in 0.3.9. Chance to proc double or triple crop yield when harvesting mature crops (F key / sickle). On proc, the player gets an in-game notification. Crop harvest XP is configured in HarvestingConfig.json, not here.
  • Double chance per point: HarvestDoubleChancePerPoint (default: 0.5% per point)
  • Triple chance per point: HarvestTripleChancePerPoint (default: 0.1% per point)
  • Caps: HarvestMaxDoubleChance (default 50%), HarvestMaxTripleChance (default 15%)
  • Max points: MaxStatPointsHarvest (default 50)
Triple is rolled only when double does not proc. See Formulas for yield math.

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: Set to 0 to effectively disable a stat, or increase for more specialization.

Blacklisted Stats

Hide or disable specific stats from the GUI:
Blacklisted stats:
  • Do not appear in the stats GUI
  • Cannot be allocated
  • Are comma-separated stat names

Example Config (Default Values)


File location and reload

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

See Also