CompatSkills Mod — Reference
Core Mechanics and Locking
CompatSkills allows you to lock various aspects of the base game and modded interactions. These are handled via CraftTweaker scripts.
Item and Mod Locking
You can lock individual items or every item belonging to a specific mod.
* Item Lock: mods.compatskills.ItemSkillLock.addRawLock("minecraft:netherite_sword", "reskillable:attack|20");
* Mod Lock: mods.compatskills.ModLock.addModLock("tconstruct", "reskillable:building|10"); (Locks all Tinkers' Construct items).
Entity Interactions
Control how players interact with mobs and creatures. This includes preventing damage, taming, or mounting until requirements are met.
| Lock Type | Function | Purpose |
|---|---|---|
| Damage | addEntityDamageLock |
Prevents the player from hurting the specified entity. |
| Taming | addEntityTameLock |
Prevents taming (e.g., Wolves, Ocelots, modded pets). |
| Mounting | addEntityMountLock |
Prevents riding horses, pigs, or modded mounts. |
Dimension and World Gating
Prevent players from entering specific dimensions. If a player lacks the requirement, they will be blocked from teleporting or using portals to that dimension.
* Syntax: mods.compatskills.DimensionLock.addDimensionLock(int dimId, String... requirements);
Harvest and Tool Gating
You can gate the ability to use specific tool types at certain harvest levels.
* Example: mods.compatskills.HarvestLock.addToolLevelLock("pickaxe", 3, "reskillable:mining|15"); (Requires Mining 15 to use Obsidian-level pickaxes).