Chrysalis
Flying past the boundaries of what you can do with a Minecraft library mod!
About this Mod
Chrysalis is a library mod for NeoForge 1.21.4 with built-in features to assist with mod development and to make modding a bit more accessible for developers!
For more information about Chrysalis, please check out the Wiki!
Do note that the wiki is slightly outdated, so information presented on there might not be fully accurate to the current version!
Currently, Chrysalis has quite a few helpful features and utilities:
Un-hardcoded various mechanics into an easy-to-use data-driven tag system! This includes various things such as piglin bartering items, nether portal base blocks, iron golem repairing materials, chorus plant base blocks, and more!
A good amount of utility methods and classes to assist with the creation of various features!
A dynamic structure-specific music system, mob bucketing system, camera shake system, custom weighted splash text system, and more!
Various admin-only items to help make play-testing a bit more convenient for developers, and a few new additional commands alongside that!
Q: What Minecraft version is this for?
A: This library is made for Minecraft 1.21.4, and I will not be porting it to any older versions!
Q: Is there a Fabric version?
A: No, this mod is and will remain exclusive to the NeoForge mod loader and I won't be supporting other mod loaders.
This project utilizes the Chrysalis License, which can be viewed by clicking on the blue text!
Available Versions
How to Install Chrysalis 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 (1.21.4).
Install Mod
Open the mod browser in the dashboard and search for "Chrysalis". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.4, 1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Chrysalis 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 (1.21.4). You can switch loaders with one click in the panel.
Is Chrysalis compatible with fabric and neoforge?
Chrysalis officially supports fabric, neoforge for Minecraft 1.21.4, 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Chrysalis – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Chrysalis 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 Chrysalis with just one click on your server.