CompatSkills Mod — Guide

Mod-Specific Integrations

CompatSkills features dedicated support for several major mods, adding unique locking mechanisms for their specific features.

Tinkers' Construct

One of the most exhaustive integrations, allowing control over tool parts, materials, and modifiers. * Material Lock: Prevents using a specific material (e.g., Cobalt) on any tool part. * Modifier Lock: Gates modifiers like Mending or Luck behind skills. * Tool Type Lock: Prevents the creation of specific tools (e.g., Cleavers) in the Tool Station.

ProjectE

Integrates with the EMC system to gate transmutation. * EMC Lock: mods.compatskills.EMCLock.addEMCLock(int emc, String... requirements); * Functionality: Players can still collect EMC, but they cannot learn or "pull out" items from the Transmutation Tablet if the item's EMC value exceeds the lock or if the item itself has specific requirements.

Blood Magic

Focuses on gating magical progression. * Ritual Locking: Prevents the activation of specific rituals (e.g., Ritual of Binding) until the player has sufficient Magic or Alchemy levels. * Soul Network: Can gate the binding of items to a player's network.

Baubles

Adds the ability to lock specific Bauble slots. If a player equips an item into a locked slot without the requirements, the item is automatically ejected into their inventory or onto the ground. * Syntax: mods.compatskills.BaubleLock.addBaubleLock(int slot, String... requirements);

Immersive Engineering & Magneticraft

Both mods receive Multiblock Gating. This prevents the player from completing or interacting with large machines (like the Crusher or Excavator) until they meet the necessary Engineering or Building requirements.

Thaumcraft

Adds requirements based on the player's research progress. * Research Lock: "thaumcraft:research|RESEARCH_KEY" * Warp Lock: "thaumcraft:warp|amount" * Knowledge Lock: "thaumcraft:knowledge|type|amount"

Hwyla & The One Probe

When a block is locked, these mods will display the required skills in the on-screen HUD, informing the player exactly what they need to level up to interact with the block.

Advanced Scripting and Customization

For advanced modpack developers, CompatSkills allows for the creation of custom content and automated events.

Skill Change Commands

You can trigger console commands to run when a player reaches a certain level or unlocks a specific trait. * Level Up Command: mods.compatskills.SkillChange.addLevelUpCommands(<skill:reskillable:attack>, 5, "/say @p has reached Attack 5!");

Custom Traits and Visibility

• Trait Creator: Allows you to add entirely new traits to existing Reskillable skills using custom icons and requirements.
• Visibility Lock: Hide entire skills from the Reskillable menu until the player meets a specific requirement (e.g., hide the "Magic" skill until the player finds a magic wand).