Home

PunchThemAll

Turn any click into a recipe. PunchThemAll lets modpack authors define what happens when a player left/right-clicks (with or without sneaking) on a block, a fluid, or the air — optionally with a specific item in hand. Everything is plain JSON dropped in the config folder. No Java, no scripting.

Each interaction can produce weighted and guaranteed drops, transform the clicked block/fluid, cost the player health or hunger, grant potion effects, play sounds and particles, and be gated by biome, dimension, time, weather, altitude, light, or player state — and it all shows up in JEI.

New in 2.0.0 — a cleaner schema_version: 2 format, advanced rewards, conditions, effects, typed NBT predicates, optional datapack loading, and correct JEI on dedicated servers. See the Changelog.

---

Start here

• Getting Started — a step-by-step guide that builds an interaction from scratch, with a cookbook and troubleshooting. Read this first.
• Interaction Format — the full reference for every field of the schema_version: 2 format, plus a legacy → v2 migration table.
• Configuration — where files live, IDs, and the pta-common.toml options.
• Examples — ready-to-copy interaction files.
• Troubleshooting — fix files that don't load or interactions that don't fire.
• Community — Discord, issues, CurseForge.

The 30-second version

An interaction is one JSON file in config/punchthemall/interactions/. It says: on this click, with this optional item in hand, on this target, do these things. Edit a file, run /reload, done.

{
  "schema_version": 2,
  "type": "shift_left_click",
  "hand": { "hand": "main", "match": "#minecraft:shovels", "consume": { "mode": "durability" } },
  "target": { "kind": "block", "match": "minecraft:gravel" },
  "rewards": { "weighted": [
    { "match": "minecraft:flint", "weight": 25 },
    { "match": "minecraft:air",   "weight": 75 }
  ] }
}

Requirements

• Minecraft 1.20.1, Forge 47.x
• JEI (recipe browser)