Reskillable Reimagined

Reskillable is an RPG-style progression mod that introduces a skill-based locking and leveling system for Minecraft.
Players must earn experience and level up skills in order to use powerful gear, defeat strong enemies, and access advanced content.

This guide covers the entire system, including skills, perks, configs, commands, and customization options.

🔥 Core Features

Reskillable adds:

A full skill leveling system
Gear gating by player skill level
Entity attack requirements (mobs can require skill levels to damage)
Crafting requirements
A modular perk system
Configurable attribute bonuses
XP-scaling and level progression
Full datapack-style JSON customization

🎯 Skill System

Each player has multiple skills they can level up using experience.

Available Skills

Skill	Purpose
Attack	Controls ability to use weapons and defeat strong enemies
Defense	Controls armor usage and survivability
Mining	Controls use of mining tools
Gathering	Controls use of gathering tools like shovels & axes
Farming	Controls hoe/tool usage for crops
Building	Controls building-related actions (block reach, etc.)
Agility	Grants movement and mobility perks
Magic	Controls magical items & spell-based gear

📈 Leveling & XP System

Players spend XP to upgrade skills via the skills menu.
XP cost scales dynamically using both:
- Predefined XP scaling curves
- A configurable multiplier

XP Scaling

XP requirements scale similarly to vanilla Minecraft levels.
XP progression beyond level 50 uses a fallback scaling system.
Fully configurable using:

xpScalingMultiplier
levelsPerHeart
healthPerHeart
maximumLevel

💥 Attribute Bonuses

Every 5 levels in a skill grants permanent bonuses.

These bonuses are configurable via the config.

Example Bonuses

Skill	Bonus
Attack	Extra attack damage
Defense	Extra armor + armor toughness
Agility	Movement speed
Magic	Custom attribute (configurable ID)
Building	Block reach distance
Gathering	Bonus XP gain
Mining	Mining speed
Farming	Crop growth chance

All of these are adjustable via config.

🧩 Perk System

At certain levels, skills unlock perks that modify gameplay.

Examples:

Increase movement speed
Bonus mining reach
Extra block break power
Faster gathering speed
Magical attribute boosts

Perks can be toggled and updated dynamically.

🛠 Skill Locking System

Reskillable can restrict:

✅ Item usage
✅ Entity attacks
✅ Crafting recipes

By skill level.

1. Item Skill Restrictions

Controlled by:

config/reskillable/skill_locks.json

Example:

{
  "skillLocks": {
    "minecraft:diamond_sword": ["attack:15"],
    "minecraft:netherite_chestplate": ["defense:30"]
  }
}

Meaning:

You need Attack 15 to use a diamond sword.
You need Defense 30 for netherite armor.

2. Entity Attack Restrictions

You can restrict attacking mobs:

config/reskillable/attack_skill_locks.json

Example:

{
  "attackSkillLocks": {
    "minecraft:warden": ["attack:25"]
  }
}

If your skill is too low:

You do no damage
Or reduced damage (depending on config)

3. Craft Skill Restrictions

Crafting can also be locked:

config/reskillable/craft_skill_locks.json

You can make crafting recipes require certain skill levels.

⚙ Config Options (Config File)

The main config controls mod behavior.

Important Config Options

Config	Description
`disableWoolDrops`	Disables wool drops unless shears are used
`deathSkillReset`	Reset skills on player death
`startingCost`	XP cost to reach level 2
`maximumLevel`	Max level a skill can reach
`xpScalingMultiplier`	Global XP scaling multiplier
`enableSkillLeveling`	Toggle skill leveling entirely
`enableSkillUpMessage`	Shows skill-up chat messages
`levelsPerHeart`	Total combined skill levels required per extra heart
`healthPerHeart`	Amount of health gained per heart milestone
`magicAttribute`	Attribute ID used for the Magic skill
`attackDamageBonus`	Attack damage bonus per milestone
`armorBonus`	Defense armor bonus per milestone
`movementSpeedBonus`	Agility movement speed bonus
`blockReachBonus`	Building block reach bonus
`miningSpeedMultiplier`	Mining speed bonus per milestone
`cropGrowthChancePer5Levels`	Farming crop growth bonus
`gatheringXpBonus`	Bonus XP gained from gathering actions
`skill_level_gates`	Defines progression gates that restrict skill leveling until requirements are met

🔒 Skill Level Gating

Reskillable supports skill level gating, allowing you to prevent players from leveling a skill until certain progression requirements are met.

This is configured using the skill_level_gates option in the main config.

Skill gates do not prevent XP gain — they only prevent leveling up until requirements are satisfied.

📄 Config Format

# "Format: SKILL:MIN_CURRENT_LEVEL:REQS",
# "Example: ATTACK:10:TOTAL=30,MINING=5,DEFENSE=5",
# "New token: ADV=<namespace:path> (player must have completed the advancement)",
# "You can include multiple: ADV=minecraft:story/mine_diamond,ADV=minecraft:nether/root",
# "Tokens: TOTAL=<n>, OTHER_SKILL=<n>, ADV=<advancement_id>"

skill_level_gates = []

Example's:

skill_level_gates = [
  "ATTACK:15:ADV=minecraft:story/mine_diamond"
]

Prevents leveling after ATTACK 15 until mine diamonds advancement has been completed:

you can use custom advancements or default ones
graet for ftbquests or other ways of preventing skill leveling

skill_level_gates = [
  "ATTACK:10:TOTAL=30"
]

Attack can be leveled freely up to level 10
from level 10 onward, the player must have 30 total skill levels

skill_level_gates = [
  "ATTACK:15:TOTAL=40,MINING=10,DEFENSE=10"
]

Attack level 15+ requires:

40 total skill levels
MINING level 10
DEFENSE level 10 all Requirements must be met to level attack past level 15

skill_level_gates = [
  "ATTACK:10:TOTAL=25",
  "ATTACK:20:TOTAL=50",
  "MAGIC:15:ATTACK=10"
]

Example of Multiple settings and 2 for 1:

To level ATTACK past 10 you need 25 levels
To level ATTACK past 20 you need 50 levels
to level MAGIC past 15 you need 10 ATTACK levels

❤️ Health Scaling

Reskillable allows players to gain bonus health:

Every X total skill levels → gain a heart
Fully controlled via:
- levelsPerHeart
- healthPerHeart

This makes progression feel more RPG-like.

🧠 Magic Skill Integration

The Magic skill connects to other mods using attributes.

You can define a custom mod attribute:

magicAttribute = "modid:spell_power"

If missing or invalid, it defaults to minecraft:generic.luck.

📟 Commands

Reskillable provides powerful commands:

`/skills`

Base command

`/skills set`

Set a player's skill level manually.

`/skills get`

Check a player's skill levels.

`/skills reload`

Reloads all configs and JSON files live. (Works in singleplayer only and only if your file is a certain size after it gets to big you will need to restart game.)

`/skills scanmod <modid>`

Automatically scans a mod and adds all its items into your skill lock config. (Singleplayer only) (1.21.1 adds all items/1.20.1 only adds weapons/tools/armor. Values added(if any)are merely placeholders you should triple check anything this mod command adds(it does not overwrite existing.))

🔍 JSON Presets & Defaults

Reskillable automatically generates:

skill_locks.json
attack_skill_locks.json
craft_skill_locks.json

It also includes default vanilla benchmarks for:

Armor tiers
Weapon power
Tool progression

🔌 Modpack & Developer Tools

Reskillable is made for:

Modpacks
RPG progression systems
Hardcore difficulty packs
Servers with progression gates

It supports:

Easy integration with other mods
Custom attribute linking
Datapack-style progression

🌟 Who Should Use Reskillable?

Perfect for:

✅ RPG modpacks
✅ Progression-based servers
✅ Hardcore survival worlds
✅ Magic-focused packs
✅ Adventure maps

❓ FAQ

Can I completely disable leveling?

Yes:

enableSkillLeveling = false

Skills then must be granted via commands or datapacks.

Can I lock modded items?

Yes! Just enter modid:itemid

Can I use my custom magic attribute for perks?

Yes.
Just set:

magicAttribute = "yourmod:attribute"

Can players bypass skill locks?

Only via creative mode or commands.

✅ Final Notes

Reskillable is designed to be:

Modular
Datapack-friendly
Highly configurable
Easy to expand

Every aspect of player progression is fully customizable.

⚔️ Reskill your world.
📈 Level with purpose.
🔥 Earn your power.

🔥 Core Features​

🎯 Skill System​

Available Skills​

📈 Leveling & XP System​

XP Scaling​

💥 Attribute Bonuses​

Example Bonuses​

🧩 Perk System​

🛠 Skill Locking System​

1. Item Skill Restrictions​

2. Entity Attack Restrictions​

3. Craft Skill Restrictions​

⚙ Config Options (Config File)​

Important Config Options​

🔒 Skill Level Gating​

📄 Config Format​

Example's:​

Prevents leveling after ATTACK 15 until mine diamonds advancement has been completed:​

Attack level 15+ requires:​

Example of Multiple settings and 2 for 1:​

❤️ Health Scaling​

🧠 Magic Skill Integration​

📟 Commands​

/skills​

/skills set​

/skills get​

/skills reload​

/skills scanmod <modid>​

🔍 JSON Presets & Defaults​

🔌 Modpack & Developer Tools​

🌟 Who Should Use Reskillable?​

❓ FAQ​

Can I completely disable leveling?​

Can I lock modded items?​

Can I use my custom magic attribute for perks?​

Can players bypass skill locks?​

✅ Final Notes​