Lychee
Define in-world crafting & interactions using JSON recipes. item interaction, burning, touching fluid, anvil, crushing, lightning, exploding...
About this Mod
Lychee
Lychee is a mod that allows you to define custom interactions using JSON recipes and datapack.
Currently, Lychee has support for the following recipe types (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
- Item exploding
- Block exploding
- Random block ticking (No JEI/REI integration)
- Dripstone dripping
- Advanced shaped crafting
- Entity ticking (No JEI/REI integration)
Dependency
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 a recipe, or got an idea for Lychee? You can join our Discord, or create a new issue in Lychee's GitHub repository.
Available Versions
How to Install Lychee on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
Install Mod
Open the mod browser in the dashboard and search for "Lychee". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.2, 26.1.1, 26.1 (+6 more)
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Lychee server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.
Is Lychee compatible with fabric and forge and neoforge and quilt?
Lychee officially supports fabric, forge, neoforge, quilt for Minecraft 26.1.2, 26.1.1, 26.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Lychee – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Lychee consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Lychee with just one click on your server.