KubeJS Create Automation

# KubeJS Hooks for Create Automation KJSCAuto allows KubeJS scripts to modify key automation behaviors in Create. This mod exposes several Create actions as script events so pack makers can intercept and modify them without writing Java mods. Recipe modification is intentionally not included, as that functionality is already provided by KubeJS Create. Currently supported hooks include: * Deployer item/tool usage * Basin recipe operations * Block breaking by drills and saws * Contraption disassembly These events allow scripts to: * adjust tool durability usage on Deployer * modify Basin recipe inputs and outputs * intercept or replace block drops when destroyed by machines or contraptions These hooks were selected to address several common automation control issues I often see discussed in the KubeJS community. If you feel there are other Create behaviors that would benefit from script hooks, feel free to suggest them in the discussion forum. Several breaking changes are introduced in 1.21.1, so the following example would not work well in that version. Check the [wiki](https://github.com/vomiter-scp-zh/KubeJS_Create_Automation/wiki/1.21-example) for 1.21.1 example. **Example Script:** (All goes into server script.) ## Deploying tool without consuming durability. When a diamond block is placed beneath the belt/depot, the Deployer gains a special effect: _sandpaper no longer loses durability, and the sanding result turns into a diamond._ ``` KJSCAutoEvents.deployerUse(event => { var {block, outputs, heldItem} = event if(heldItem != "create:sand_paper") return //only works for sand paper if(!block.offset(0, -3, 0).blockState.is(Blocks.DIAMOND_BLOCK)) return; //only works when the belt/deposit (y = -2) has a diamond block below. event.setDamage(0) //set the durability usage to 0 while(outputs.length > 0) outputs.remove(0) //remove all original outputs outputs.add(0, Item.of("diamond")) //add diamond }) ``` ## Mixing wool and red dye while not consuming the dye This is to enable some "catalyst" recipe. **Technical note:** _In Create’s Basin, outputs are kept separate from the input/ingredient inventory, so an item returned as an output will not be treated as an ingredient for the next operation._ ``` KJSCAutoEvents.basinOperation(event => { var {basin, block, fluidOutputs, heatLevel, outputs, recipe} = event; if(recipe.getId().toString() == "minecraft:dye_red_wool"){ event.addInput("red_dye") } }) ``` ## Conditional Silk Touch for Drills Drills can gain a Silk Touch-like effect when a certain condition is met. If an amethyst block is placed beneath the ore, the drill will drop the ore block itself instead of the normal drops. ``` //This works for stationary drill. KJSCAutoEvents.blockDestroy(event => { const { level, targetPos, targetBlock } = event const below = level.getBlockState(targetPos.below()) if (!below.is("minecraft:amethyst_block")) return if (!(targetBlock.blockState.is("minecraft:diamond_ore") || targetBlock.blockState.is("minecraft:emerald_ore")))return targetBlock.popItem(targetBlock.blockState.block.asItem()) level.destroyBlock(targetPos, false) event.cancel() }) //This works for drill on contraption. ContraptionEvents.afterBlockDestroy(event => { const { level, targetPos, targetBlock, drops } = event const below = level.getBlockState(targetPos.below()) if (!below.is("minecraft:amethyst_block")) return if (!(targetBlock.blockState.is("minecraft:diamond_ore") || targetBlock.blockState.is("minecraft:emerald_ore")))return while(drops.length > 0) { drops.remove(0) } drops.add(Item.of(targetBlock.blockState.block.asItem())) }) ``` ## Protective Ground for Contraptions Blocks placed on soul soil cannot be broken contraption machines. ``` ContraptionEvents.beforeBlockDestroy(event => { const { level, targetPos } = event const below = level.getBlockState(targetPos.below()) if (!below.is("minecraft:soul_soil")) return event.cancel() // prevent the contraption from breaking the block }) ``` ## Cancel Disassembly Prevent contraption disassembly when a sea lantern is in the disassembly range. ``` ContraptionEvents.beforeDisassemble(event => { console.log("disassemble") let shouldCancel = event.testTargetBlock(block => { return block == "minecraft:sea_lantern" }) if(shouldCancel) event.cancel() }) ``` ## Support If you'd like to support my modding work, including maintenance, updates, and compatibility work, Patreon is available here: [https://patreon.com/vomiter\_scp](https://patreon.com/vomiter_scp)