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. 🌾