🔒 Restricted Actions

There are two types of actions that can be restricted:

🛠 Regular Actions

These check whether a block or item is unlocked during specific player behavior:

• Placing block – Is the block the player is placing unlocked?
• Breaking block – Is the block the player is breaking unlocked?
• Crafting item – Is the item the player is crafting unlocked?
• Potion consuming – Is the potion effect of the potion the player is consuming unlocked?
• Equipping armor – Is the armor piece the player is equipping unlocked?
• Shooting projectiles – Is the specific type of projectile the player is using unlocked?
• Entering portals – Are portals (NETHER_PORTAL, END_PORTAL) unlocked for players?

⚙️ Config Examples

These are examples from xpmode.yml and farmingmode.yml.

🔹 xpmode.yml

Recipes:
  level1:
    needed_xp: 0
    items:
      - WOODEN_TOOLS
      - WOODEN_SWORD
      - STONE_SWORD
      - CHEST
      - STICK
      - PLANKS
      - FURNACE
      - CRAFTING_TABLE
      - TORCH
    entities_actions:
      - shear #Player can shear sheep

🔸 farmingmode.yml

unlocks:
  firstUnlock:
    name: First Unlock
    unlocks:
      - STONE_TOOLS
      - STONE_SWORD
      - LEATHER_ARMOR
      - STONES
      - FISHING_ROD
      - BEDS
      - DYES
    entities_actions:
      - shear #Player can shear sheep

🐾 EntityActions

Other actions can also have level requirements and are defined in either xpmode.yml or farmingmode.yml.

• shear – Player is allowed to shear sheep
• villagerTrades – Player is allowed to trade with villagers
• mobFeed – Allows feeding all mobs
  • Can also be specified as <entity>Feed, e.g. sheepFeed, cowFeed, etc.