Create: Recipe Hooks

Create Recipe Hooks

Create Recipe Hooks is a server-side library for Minecraft 1.20.1 (Forge and Fabric) that fires events whenever a Create machine finishes processing a recipe, and whenever a Create machine processes a world block: Drill mining, Harvester reaping, Saw felling trees. It provides a unified API so that integration mods - such as quest books, automation scripts, and analytics tools - can react to Create production without writing their own mixins.

What it does

The mod hooks into Create's machines at the bytecode level and fires three events:

• recipeFinished - a Create machine completed a recipe (Basin, Fan, Press, Millstone, Crushing Wheels, Saw, Crafter, Deployer, Spout, Item Drain, Sand Paper, Sequenced Assembly, CEI Printer)
• blockProcessed - a machine processed a world block: one event per block broken by a Mechanical Drill, per plant cut by a Mechanical Harvester, per lone block cut by a horizontal Mechanical Saw
• treeCut - a Mechanical Saw felled a whole tree, with the exact log and leaf counts

Every event carries:

• Source - which machine did the work
• Player attribution - the UUID of the player who placed the machine (for Crushing Wheels: who threw the item, with a fallback to whoever placed the wheels for belt and hopper input). Persisted across server restarts and carried along inside moving contraptions
• Recipe ID, item inputs and outputs, fluid outputs - for recipe events
• Block id, block state, contraption flag, log count - for block events
• Block position - where it happened in the world

Supported machines

Machine	Source constant	Event
Basin (Mixing / Compacting)	BASIN	recipeFinished
Crushing Wheels	CRUSHING_WHEEL	recipeFinished
Mechanical Saw (recipes)	MECHANICAL_SAW	recipeFinished
Spout (recipe and bucket filling)	SPOUT_FILLING	recipeFinished
Millstone	MILLSTONE	recipeFinished
Mechanical Press (belt and world)	MECHANICAL_PRESS	recipeFinished
Mechanical Crafter	MECHANICAL_CRAFTER	recipeFinished
Deployer	DEPLOYER_BELT	recipeFinished
Encased Fan (belt and world)	FAN_BLASTING / FAN_HAUNTING / FAN_SPLASHING / FAN_SMOKING	recipeFinished
Item Drain (recipes, buckets, potions)	ITEM_DRAIN_EMPTYING	recipeFinished
Sand Paper	SAND_PAPER	recipeFinished
Sequenced Assembly (final step)	SEQUENCED_ASSEMBLY	recipeFinished
CEI Printer (optional, Forge only)	CEI_PRINTER	recipeFinished
Mechanical Drill (stationary and contraption)	MECHANICAL_DRILL	blockProcessed
Mechanical Harvester (contraption)	MECHANICAL_HARVESTER	blockProcessed
Mechanical Saw, horizontal (stationary and contraption)	MECHANICAL_SAW	treeCut / blockProcessed

KubeJS scripting, no addons needed

CRH registers its own KubeJS event group. The same scripts run unchanged on Forge and Fabric, with an optional source filter and built-in owner resolution:

CRHEvents.recipeFinished('MILLSTONE', event => {
    const player = event.getOwner();
    if (!player) return;
    player.server.runCommandSilent('give ' + player.name.string + ' minecraft:emerald 1');
});

CRHEvents.treeCut('MECHANICAL_SAW', event => {
    // event.getLogCount(), event.getBlockId(), event.getOwner()
});
  

Ready-to-use script examples (FTB Quests integration, output filtering, per-player counters, drill mining quests, log counting) are available in the README.

Why you might want this

If you are building a quest integration (FTB Quests etc.), you can trigger quest progress the moment a Create machine finishes, attributed to the right player - not just when items land in an inventory. Quests like "smelt 64 iron with a Fan", "mine 500 stone with a Drill" or "fell 50 trees with a Saw" become one short script each.

If you are writing analytics or logging tools for a server, you get a single reliable event stream for all Create production.

This mod does nothing visible on its own. It is a library - you will not see any in-game UI, items, or blocks. Install it when another mod or script requires it. It is server-side: clients without the mod can join a server that has it. For singleplayer, install it in your instance.

Requirements

• Minecraft 1.20.1
• Forge file: Forge 47 or newer, Create 6.0.8 or newer. Also runs on NeoForge 1.20.1, verified on clients and dedicated servers
• Fabric file: Fabric Loader 0.15+, Fabric API, Create Fabric 6.0.8.1 or newer. Works on Quilt
• KubeJS - optional, only for JS scripting (no EventJS or other addons required)
• Create Enchantment Industry - optional soft dependency on Forge; CEI Printer events are only fired when CEI is installed

For developers

Register listeners during mod initialization, identical on both loaders:

CreateRecipeHooks.register(ctx -> {
    if (ctx.getSource() == RecipeSource.BASIN) {
        // ctx.getRecipeId(), ctx.getItemOutputs(), ctx.getBlockPos(), ...
    }
});

CreateRecipeHooks.registerBlockProcessed(ctx -> {
    // ctx.getBlockId(), ctx.isContraption(), ctx.getMetadata()
});

CreateRecipeHooks.registerTreeCut(ctx -> {
    // ctx.getLogCount(), ctx.getLeafCount()
});
  

On Forge the events are also posted on the event bus (CreateRecipeFinishedEvent, CreateBlockProcessedEvent, CreateTreeCutEvent); on Fabric they are standard callbacks (CreateRecipeFinishedCallback, CreateBlockProcessedCallback, CreateTreeCutCallback).

A debug mode is available for testing on Forge. Launch with the JVM argument -Dcrh.debug=true to write every recipe completion to logs/crh-events.log.

Full API documentation is available in the per-loader READMEs on the GitHub repository.

License

LGPL-3.0-or-later - free to use in public and private modpacks and as a dependency in other mods. Forks and derivative mods must remain open source under the same license with attribution.