Config and commands
The main config, every file the mod uses, admin commands and scanning a mod for locks.
Main Config
The main config contains global Reskillable behavior.
On current Fabric 1.21.1 builds, it is stored at:
config/reskillable-common.tomlThe JSON progression files remain under:
config/reskillable/Important Main Config Options
| Config | Description |
|---|---|
disableWoolDrops | Controls Reskillable's wool-drop restriction |
deathSkillReset | Resets skills on player death |
HealthBonus | Enables total-level health scaling |
showTabButtons | Shows the Inventory / Skills tab buttons |
xpScalingMultiplier | Global XP cost multiplier |
maximumLevel | Maximum level per skill |
enableSkillLeveling | Enables or disables normal GUI leveling |
enableSkillUpMessage | Shows skill-up chat messages |
skillAliases | Additional accepted names for configured skills |
skill_level_gates | Skill progression gate rules |
enableSecondSkillPage | Enables the custom-skill page |
subpageNavPosition | Position of the built-in/custom page arrows |
showSubpageTitles | Shows or hides the skill subpage titles |
maxTotalSpentLevels | Maximum combined spendable levels; -1 is unlimited |
levelsPerHeart | Total skill levels required per health milestone |
healthPerHeart | Health granted per milestone |
attackAttribute | Attribute used by the default Attack perk |
attackOperation | Modifier operation for Attack |
attackDamageBonus | Attack perk amount |
defenseAttribute | Attribute used by Defense |
defenseOperation | Modifier operation for Defense |
agilityAttribute | Attribute used by Agility |
agilityOperation | Modifier operation for Agility |
magicAttribute | Attribute used by Magic |
magicOperation | Modifier operation for Magic |
buildingAttribute | Attribute used by Building |
buildingOperation | Modifier operation for Building |
miningSpeedMultiplier | Mining bonus scaling |
Some legacy bonus option names retain their original capitalization/spaces for compatibility. Per-skill values can also be overridden through built_in_skills.json.
Configuration Files
Reskillable automatically creates or uses the following files:
| File | Purpose |
|---|---|
config/reskillable-common.toml | Main/global configuration |
config/reskillable/skill_locks.json | Item and block requirements |
config/reskillable/attack_skill_locks.json | Entity attack requirements |
config/reskillable/craft_skill_locks.json | Crafting requirements |
config/reskillable/built_in_skills.json | Built-in skill definitions |
config/reskillable/custom_skills.json | Additional custom skills |
config/reskillable/reskillable_tabs.json | Inventory/Skills tab position |
Commands
Reskillable provides administration and modpack-development commands under:
/skillsMost administrative commands require operator/game-master permission.
Get Skill Levels
/skills getChecks player skill levels.
Set a Skill
/skills set <player> <skill> <level>Sets a built-in or enabled custom skill.
Set All Skills
/skills set <player> all <level>Sets all enabled built-in and custom skills.
Add Skill Levels
/skills add <player> <skill> <amount>Levels can also be added to all enabled skills.
Respec a Player
/skills respec <player>Resets progression and refunds stored/spent XP according to the command's respec behavior.
Reload Configs
/skills reloadReloads Reskillable's current configuration and JSON data without requiring a normal full game restart.
Scan a Mod
/skills scanmod <modid>Scans registered items belonging to a mod and adds generated entries to skill_locks.json.
Existing entries are preserved.
Generated requirement values should be treated as starting points and reviewed by the modpack author before release.
Mod Item Scanning
The scan command can save a large amount of manual configuration work.
/skills scanmod examplemodReskillable checks registered items in that namespace and generates suggested skill-lock entries.
The generated values can use item properties such as:
- Armor defense
- Armor toughness
- Tool type
- Weapon/tool progression
The scanner does not overwrite entries that already exist.