🌾 Farming Mode – Documentation

🎯 Purpose

In Farming Mode, players unlock new items and actions by collecting specific resources (e.g. coal, iron, diamonds). Progression is based on gathering quantities rather than XP.

⚙️ Configuration (`farmingmode.yml`)

🔧 Default Unlocks

The default section includes items and actions that are available from the beginning:

default:
  items:
    - WOODEN_TOOLS
    - WOODEN_SWORD
    - STONE_SWORD
    - CHEST
    - STICK
    - PLANKS
    - FURNACE
    - CRAFTING_TABLE
    - TORCH
  entities_actions:
    - shear
    - villagerTrades

🧱 Unlock Tiers

Players unlock new tiers by collecting required items. Each tier defines:

name – display name of the unlock
unlocks – items that become available
runCommandsOnReach (optional) – commands triggered when requirements are met
requires – item counts needed to unlock

unlocks:
  firstUnlock:
    name: First Unlock
    unlocks:
      - STONE_TOOLS
      - STONE_SWORD
      - LEATHER_ARMOR
      - STONES
      - FISHING_ROD
      - BEDS
      - DYES
    runCommandsOnReach:
      - broadcast %player% just reached level 2
      - eco give %player% 1
    requires:
      COBBLESTONE: 35
      COAL: 10

  next:
    name: Second Unlock
    unlocks:
      - IRON_ARMOR
      - IRON_TOOLS
      - IRON_SWORD
      - BOW
      - BLAZE_POWDER
      - ARROW
    requires:
      RAW_IRON: 10
      COAL: 20

  next2:
    name: Third Unlock
    unlocks:
      - DYES
      - FLINT_AND_STEEL
      - ARROWS
      - DIAMOND_TOOLS
    requires:
      RAW_IRON: 30
      COAL: 64
      DIAMOND: 10

  next3:
    name: Fourth Unlock
    unlocks:
      - DIAMOND_ARMOR
    requires:
      RAW_IRON: 64
      COAL: 40

  next4:
    name: Fifth Unlock
    unlocks:
      - NETHERITE_ARMOR
      - NETHERITE_TOOLS
    requires:
      OBSIDIAN: 10
      DIAMOND: 64

🧠 Summary