CropXp

CropXp rewards farming: harvest a mature crop and there's a chance it drops a few experience orbs. Which crops count, how much XP, and the drop chance are all yours to configure.

✨ Highlights

• 🌾 XP for harvesting crops, with configurable amount and chance
• 🎚️ In-game settings screen (via Mod Menu + Cloth Config)
• 📦 Add, remove, or retune any crop with data pack files — great for modpacks and servers
• 📈 Optional LevelZ support — also grants LevelZ farming XP when LevelZ is installed
• ♻️ /reload applies changes instantly; Creative mode is opt-in

📦 Compatibility

Fabric 1.19.2, 1.20.1, 1.21.1

Required: Fabric API Optional: Mod Menu + Cloth Config (in-game settings), LevelZ (LevelZ XP)

⚙️ Configuration

Edit the settings in-game via Mod Menu → CropXp, or edit config/cropxp.json directly. These are the global defaults used by every crop that doesn't override them. Upgrading from a 1.x config is automatic.

{
  "general": {
    "enabled": true,
    "dropInCreative": false,
    "defaults": { "min": 1, "max": 2, "chance": 0.5 }
  },
  "levelz": {
    "enabled": true,
    "defaults": { "min": 1, "max": 1, "chance": 0.25 }
  }
}

Setting	Default	Meaning
general.enabled	true	Master switch for vanilla XP drops.
general.dropInCreative	false	If true, XP also drops while in Creative mode.
general.defaults.min / max	1 / 2	Vanilla XP amount; a whole number is rolled evenly between min and max.
general.defaults.chance	0.5	Chance per harvest to drop vanilla XP (0.0–1.0). 0 = never, 1 = always.
levelz.enabled	true	Switch for LevelZ XP (only matters when LevelZ is installed).
levelz.defaults.min / max	1 / 1	LevelZ XP amount range.
levelz.defaults.chance	0.25	Chance per harvest to drop LevelZ XP. Rolled independently of vanilla XP.

🌱 Custom crops (data packs)

Every recognized crop is a JSON file, so you can add, retune, or disable any crop — including modded ones — without changing the mod. Place files in a data pack at:

data/<namespace>/cropxp/crops/<name>.json

<namespace> can be anything (use your pack's name); cropxp/crops is the fixed folder CropXp scans. Put the pack in a world's datapacks/ folder or ship it inside a mod. Run /reload after editing — the Recognized Crops tab in the config screen lists everything currently loaded.

Field	Type	Required	Description
block	string	✅	Block id, e.g. minecraft:carrots.
conditions	object	—	Block-state values that must all match for XP to drop, e.g. { "age": 7 }. Omit to match any state.
vanilla	object	—	Vanilla XP override { min, max, chance }. Any field omitted falls back to the global default.
levelz	object	—	LevelZ XP override { min, max, chance }.
requiresCorrectTool	boolean	—	If true, XP only drops when the block is broken with the correct tool.
enabled	boolean	—	Set false to turn a crop off (e.g. to disable a built-in one).

Conditions use the block's own state properties — for example age (0–7 for wheat, 0–3 for nether wart), or half (lower / upper). Only states that match every listed condition grant XP, so unripe crops are skipped.

Examples

Mature carrots with custom XP:

{
  "block": "minecraft:carrots",
  "conditions": { "age": 7 },
  "vanilla": { "min": 1, "max": 3, "chance": 0.6 }
}

Fully-grown nether wart, overriding both vanilla and LevelZ XP:

{
  "block": "minecraft:nether_wart",
  "conditions": { "age": 3 },
  "vanilla": { "min": 2, "max": 4, "chance": 1.0 },
  "levelz":  { "min": 1, "max": 2, "chance": 0.5 }
}

Turn off a built-in crop:

{ "block": "minecraft:cocoa", "enabled": false }

The same pattern works for modded crops — use the modded block id and its own growth property in conditions.

🧺 Built-in crops

Wheat, carrots, potatoes, beetroots, nether wart, cocoa, melon & pumpkin stems (including the attached-stem state), and pitcher crop (where that block exists).

Melon/pumpkin blocks and torchflower are excluded on purpose — they regrow or can be re-placed, which would allow infinite XP.

---

Originally built for my own modpack, now shared for everyone. 🌾