Cocoon
A Plugin & Mod Runtime Library
About this Mod
Cocoon
A library that provided mod compatibility layer support for plugin servers.
The main features is provide mod compatibility service for pure plugin servers, so the client features still need to rely on mods.
Unlike the mod server, the mod compatibility service provided by cocoon is optional, which means vanilla players still can join and play the server normally.
Features
You can implement this features on the plugin server:
Create custom items
Create custom blocks, and custom hitboxes
Create custom entities
Create custom size containers
Create custom container UI
How To Use
Note cocoon split the client and server versions, so careful use a wrong version.
** For Developer:**
NOTE: API documentation is coming soon
Add cocoon dependency to your plugin project
Implement the classes provided by cocoon
Register the class of you implemented class into cocoon
Done, the remaining work by cocoon
** For Server Owner: **
Install any bukkit server
Install concoon server library
Install compatible plug-ins that depend on cocoon
Done
For Plugin Server Client User:
Install fabric/forge
Install cocoon client library
Install the mods required for the plugin server
Done
Available Versions
How to Install Cocoon on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set bukkit Loader
In the panel under "Egg", select the bukkit loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Cocoon". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1, 1.19.2, 1.18.2 (+1 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Cocoon server crashes on startup – what to do?
Most common cause: wrong bukkit 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.20.1). You can switch loaders with one click in the panel.
Is Cocoon compatible with bukkit and fabric and forge?
Cocoon officially supports bukkit, fabric, forge for Minecraft 1.20.1, 1.19.2, 1.18.2. 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 Cocoon – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Cocoon 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 Cocoon with just one click on your server.