
Cyanide
A mod which substantially improves Minecraft's data driven world generation error detection, reporting, and recovery mechanisms.
About this Mod
Cyanide
cyanide seems to be something that will make me want to drink cyanide a lot less - Starmute, world generation datapack wizard.
A mod which substantially improves Minecraft's data driven world generation error detection and recovery mechanisms. It removes unnecessary stack traces and generates user-friendly error messages for most common issues with world generation datapacks. For some examples of what improvements Cyanide makes to error reporting, see the below list:
All errors identify the exact file, and source datapack where the error originated. Some error messages are improved for clarity or have additional context added where possible.
Parsing Error: Value provider too low (must be >= 0), got -1
at 'placement'
at 'cyanide:worldgen/placed_feature/ore_tin' defined in 'file/Test.zip'
The "Unbound values in registry" error tracks what files were referencing it.
Missing File Error: 'cyanide:worldgen/configured_feature/big_ores' was referenced but not defined
at 'cyanide:worldgen/placed_feature/big_ores' defined in 'file/Test.zip'
Illegal JSON will show the exact file location, along with the surrounding context of where it failed to parse.
Syntax Error: Expected ':' at line 3 column 13 path $.config
at:
{
"type": "minecraft:big_flowers",
"config" {
^
here
at 'cyanide:worldgen/configured_feature/flowers' defined in 'file/Test.zip'
"Feature Cycle" errors (where features are defined in different order within different biomes) trace and report the exact cycle found
A feature cycle was found.
Cycle:
At step 0
Feature 'minecraft:lake_lava_underground'
must be before 'minecraft:lake_lava_surface' (defined in 'minecraft:ocean' at index 1, 2 and 1 others)
must be before 'cyanide:big_ore' (defined in 'minecraft:ocean' at index 2, 3)
must be before 'cyanide:small_ore' (defined in 'minecraft:plains' at index 0, 1)
must be before 'minecraft:lake_lava_underground' (defined in 'minecraft:ocean' at index 0, 1 and 1 others)
Available Versions
How to Install Cyanide 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.1).
Install Mod
Open the mod browser in the dashboard and search for "Cyanide". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1, 1.20 (+4 more)
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Cyanide 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.1). You can switch loaders with one click in the panel.
Is Cyanide compatible with fabric and forge and neoforge?
Cyanide officially supports fabric, forge, neoforge for Minecraft 1.21.1, 1.20.1, 1.20. 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 Cyanide – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Cyanide 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 Cyanide with just one click on your server.