Perks and health

Perks & Attribute Bonuses

Skills can use their original Reskillable perk or one or more configurable attribute perks.

The preferred format is:

"perkAttributes": [
  {
    "attribute": "modid:attribute",
    "operation": "ADDITION",
    "amountPerStep": 1.0,
    "perkStep": 5
  }
]

A skill may contain multiple entries, and every entry can use a different operation, amountPerStep, and perkStep.

For example, one attribute can trigger every 5 levels while another triggers every 10 levels.

Built-In vs. Custom Perk Behavior

For built-in skills:

• perkAttributes: null keeps the original Reskillable perk.
• perkAttributes: [] disables the perk.
• perkAttributes: [ ... ] replaces the original perk with the configured attribute list.
• The legacy singular perkAttribute format is still supported and also acts as a replacement when configured.

For custom skills:

• perkAttributes: [] means the skill has no attribute perk.
• perkAttributes: [ ... ] grants every configured attribute perk.
• The legacy singular format remains supported for backward compatibility.

A custom attribute override does not stack with special built-in behavior such as Mining speed, Gathering bonus XP orbs, or Farming crop-growth chance. Supplying an override replaces that original perk.

Modifier Operations

Common operation names include:

ADDITION
MULTIPLY_BASE
MULTIPLY_TOTAL

ADDITION adds the configured amount directly at each milestone.

MULTIPLY_BASE uses the amount as a fraction of the attribute's base value. For example, 0.05 represents +5% of the base value per milestone.

Perk Page Names

When a built-in skill is using its original perk, Reskillable uses its normal legacy perk description.

When a skill is using a configured attribute override, the perk page displays the configured attribute's translated name. For third-party attributes, that translated name is normally supplied by the mod that owns the attribute.

For example, changing Reskillable's legacy:

tooltip.rereskillable.bonus_xp_orbs

changes the name used by the original Gathering perk. It does not rename a third-party attribute such as attributeslib:experience_gained.

Default Skill Bonus Types

These defaults remain active when perkAttributes is null. Supplying a configured attribute override replaces the corresponding original perk.

Health Scaling

Reskillable can grant bonus health based on total skill progression.

Controlled by:

HealthBonus
levelsPerHeart
healthPerHeart

For example, a pack can grant additional health every 10 combined skill levels.

Disabled skills are not intended to contribute to normal progression totals.