Skip to content

Preface

Info

This is the documentation for Lychee 1.21. If you are using a different version, please select the correct version in the bottom right corner of the page.

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

You can download Lychee on CurseForge:

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

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

Dependencies Information

  • Kiwi

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.

Contact

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/YAML. You can click the corresponding link to validate your JSON/YAML.
  2. Check if your recipe is shown in JEI/REI/EMI. If not, search the error output in logs for some helpful information.

CraftTweaker integration?

There are no built-in integrations for adding recipes. You need to add recipes in JSON format. Here are some usages in their documentation: CraftTweaker.

There is a utility library from the community you may want to know: