Back to 9Minecraft
Wiki 9Minecraft Wiki 9Minecraft
Lychee Mod Wiki

Lychee Mod Wiki & Guide

wiki.9minecraft.net/lychee-mod/

If you are a Minecraft modder, or if you have tried to code in custom interactions in the game, you must know how complicated things can get. Lychee Mod is here to simplify the process of coding in custom interaction to Minecraft by using JSON recipes and datapacks.

Guides

Step-by-step, in-game.

Creating an Anvil Crafting Recipe in LycheeWhy Use Lychee for Anvil Recipes Vanilla anvil behavior is limited to repairing and renaming. Lychee lets you define…How to Make a Custom Right-Click Interaction with LycheeSetting Up the Recipe File Lychee reads JSON recipes from a datapack, so create a folder path like…Making Falling Blocks Crush Items or Blocks with LycheeUnderstanding the Crushing Interaction Lychee supports interactions where a falling block (such as sand, gravel, or…Triggering Interactions When an Item Entity Is in Water or BurningItem Entity Inside a Block Lychee can fire an interaction when an item entity sits inside a specific block, most…

Configuration

Every setting in the mod config file, with what it changes.

OptionWhat it does
debugDebug
dispenserFallableBlockPlacementDispenser Fallable Block Placement
enableEnable
fragmentFragment
yamlRecipesYaml Recipes

Frequently asked questions

How do I get started making my first Lychee interaction?
Create a datapack and add a JSON file under data/ /lychee/ with a type field matching the interaction you want, such as block_clicking or item_inside_block. Lychee reads these files on world load, so /reload applies changes without restarting.
Where do Lychee recipe files actually go in my datapack?
They live in data/ /lychee/ / .json, where the folder matches the interaction type (for example block_clicking, anvil_crafting, or falling_block). The namespace and file name become the recipe's ID, so keep them lowercase and unique.
Why isn't my Lychee interaction firing in-game?
The most common causes are a malformed JSON file (check your log for a parse error), a wrong type value, or the datapack not being enabled for the world. Run /reload and watch the log — Lychee reports broken recipes there instead of silently ignoring them.
How does the block_clicking interaction decide between using and clicking?
You specify the block, the item held, and whether the trigger is a right-click (use) or a left-click (click) in the recipe's conditions. If the item or block doesn't match exactly, the interaction won't run.

See all 10 Lychee questions ›