Skip to content


Lychee is a mod that allows you to define custom interactions using JSON recipes and datapack.

You can download Lychee on CurseForge:

Currently Lychee has support for the following recipe type (with full JEI/REI support!):

  • Use or click on a block with item
  • Item entity burning
  • Item entity inside a specific block (for instance water)
  • Anvil crafting
  • Falling block crushing items or block
  • Lightning channeling
  • Random block ticking (No JEI/REI integration)
  • Dripstone dripping
  • Advanced shaped crafting

Dependencies Information

Kiwi (Optional)

  1. The random block ticking recipe requires Kiwi to work.
  2. Creates item breaking particles when a falling block crushing on items.

Adding Recipes

To create a new recipe that works in every world you create, you will need a datapack loader mod, such as OpenLoader.

Or you can add recipes using CraftTweaker or KubeJS.


Having trouble creating recipe, or got an idea for Lychee? You can join our Discord, or create a new issue in Lychee's GitHub repository.

Frequently Asked Questions

Why is my recipe not working?

  1. Make sure your recipe file is a valid JSON. You can use this site to validate your JSON.
  2. Check if your recipe is shown in JEI / REI. If not, search the error output in logs for some helpful information.

Where are the CraftTweaker/KubeJS integrations?

There are no built-in integrations for adding recipes, which means you need to add recipes in JSON format. Here are some usages in their docs: CraftTweaker / KubeJS

There are some utility libraries from the community you may want to know: