Note: This page is still in development. Some calculations or information may be incorrect.
| Level |
XP Required |
Total XP |
Actions |
XP Curve Visualization
Level 1
Level 50
Estimated actions needed to reach target level:
Note: This page is still in development. Some information may be incorrect or incomplete.
General Information
General Information about the builder and its features.
- Older versions: This HySkills Builder do not support older versions of the mod.
- Import: You can use import to load a default skill configuration or your own custom skill configurations.
- Merge: Merge multiple skill configurations into one.
Getting Started
-
Create a Skill:
Click "+ Add Skill" to create a new skill. Give it an ID (used internally) and a Display Name (shown to players).
-
Set Max Level:
Define how many levels this skill can have. Players will progress from level 1 to this maximum.
-
Add Triggers:
Define how players earn XP. Each trigger specifies an action (like killing mobs or mining blocks) and how much XP it rewards.
-
Add Unlocks:
Define rewards players get at specific levels - stat boosts, items, or special abilities.
-
Export:
Click "Export JSON" to download your skills configuration file.
Understanding Triggers
Triggers define how players earn experience in a skill. Each trigger has:
- Trigger Type: The action that grants XP (see table below)
- XP Reward: How much XP is granted per action
- Cooldown: Minimum time (in ms) between XP gains from this trigger
- Allow/Deny Lists: Filter which items, blocks, or entities count for this trigger
Understanding Unlocks
Unlocks are rewards granted when reaching specific levels:
- ITEM: Give players an item as a reward
- STAT_* types: Modify player statistics permanently
- Value Types:
FLAT - Adds a fixed value (e.g., +10 health)PERCENT_BASE - Percentage of the base statPERCENT_TOTAL - Percentage of the total (base + bonuses)
- Every Level: If checked, the reward applies at every level starting from the specified level
Requirements
Requirements restrict when a skill can gain XP:
- ITEM_IN_HAND: Player must be holding a specific item to gain XP
Locked Items
Locked items cannot be used until the player reaches a specific level in this skill. This allows for progression-gated equipment.
- Use the Statistics tab to balance XP progression
- Add cooldowns to prevent XP farming exploits
- Use deny lists to exclude specific items/mobs
- Start with small stat bonuses and increase with level
- Test your skills in-game to fine-tune values