Cyanide
Cyanide makes Minecraft's data driven world generation errors easier to read, replacing long stack traces with messages that name the file where a problem started.
What it does
Cyanide improves how the game reports and recovers from problems in world generation datapacks. Instead of printing unnecessary stack traces, it produces user-friendly error messages for the most common issues, and where possible it adds more context to the wording of existing messages.
Each report points to the exact file and source datapack where an error originated, so a pack author can find the broken entry without searching every file. The mod is open source under the MIT License and runs on Fabric, Forge and NeoForge, with files for 1.17.1 – 1.21.1. It works on either side, and neither side needs it, so it can be installed on a server, on a client or on both. Fabric API is required on Fabric builds.
Latest files are 5.0.0 for 1.21.1 on Fabric and NeoForge and 4.1.1 for 1.20.1 on Forge, all published under the same license. Source code, an issue tracker and a wiki are linked from the project.
Key features
Readable parsing errors
Parsing errors report the offending value and its placement, such as a value provider that must be 0 but received -1.
Missing file reports
When a configured or placed feature is referenced but never defined, the error names the feature and the datapack file that should contain it.
Unbound registry tracking
Unbound values in a registry list the files that reference them, so the missing entry is easier to locate.
Illegal JSON context
Malformed JSON errors point to the precise spot in a file and quote the lines around the failure.
Feature cycle tracing
When features are ordered inconsistently across biomes, the report traces the exact cycle, step by step, with the biome and index of each conflicting entry.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Datapack authors and server owners who load custom world generation datapacks and want clearer errors when a file fails to load.
How it compares
Configured Defaults is also open source under the Mozilla Public License 2.0 and works on either side, and neither side needs it, but it covers 1.18 – 26.3, a range that begins later than Cyanide's. Block Runner is open source under the same license across 1.18.2 – 26.3 and is a server mod that clients may leave out. Cyanide's own range starts at 1.17.1 and its license is the MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Cyanide | Fabric, Forge and NeoForge | 1.17.1 – 1.21.1 | Client or server, optional | 2024-10-04 |
| Configured Defaults | Fabric, Forge and NeoForge | 1.18 – 26.3 | Client or server, optional | 2026-09-26 |
| Block Runner | Fabric, Forge and NeoForge | 1.18.2 – 26.3 | Server required, client optional | 2026-09-23 |
Questions
Does Cyanide need Fabric API?
Does Cyanide have to be on the server?
Which versions does Cyanide support?
In the catalog
Cyanide is one of 36,990 Utility mods on ModsFinder, and one of 25,772 Utility mods for Fabric. 32,366 mods support Minecraft 1.21.1.
More from alcatrazEscapee
Similar mods
What the author says
cyanide seems to be something that will make me want to drink cyanide a lot less - Starmute, world generation datapack wizard. 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.
Official listing
- Modrinth page
- modrinth.com/mod/cyanide
- Owner
- alcatrazEscapee
- Published
- 2023-06-13
- Updated on Modrinth
- 2024-10-04
- Facts verified
- 2026-10-15