YUNG's API
YUNG's API gives worldgen modders a set of registration, serialization and randomization tools that the other YUNG structure mods are built on.
What it does
Developers who write structures or other world generation code get automatic registration, a safe structure locate trigger, JSON serialization with built-in type adapters, small vector and column math helpers, and BlockStateRandomizer and ItemRandomizer data classes for block and item variety in generated structures. Registration can be done with a single annotation on a field, and it works across the supported loaders.
The library is required by 24 other mods, including YUNG's Better Nether Fortresses, YUNG's Better Dungeons, YUNG's Better Ocean Monuments, YUNG's Better Mineshafts and YUNG's Better Jungle Temples, so those mods will not start without it. It requires Fabric API on Fabric. Files are published for Fabric, Forge and NeoForge, with builds covering 1.18.2 – 26.1.2, and the library runs client and server. It is open source under the GNU Lesser General Public License v3.0 only, and its source code and issue tracker are public.
Key features
Annotation-based registration
Any field can be registered with a simple annotation, and the same code works on Fabric, Forge and NeoForge. The automatic registration is available from 1.18 onward.
Safe structure trigger
A new criteria trigger locates a given structure, and when that structure does not exist the trigger fails instead of passing like the vanilla one does.
JSON serialization
Interfaces handle JSON serialization and deserialization, with type adapters included for common data types.
Vector and column math
Lightweight utilities cover vector arithmetic and column positions for placing structure pieces.
Block and item randomization
BlockStateRandomizer and ItemRandomizer are data abstractions for picking varied blocks and items when structures are generated.
Compatibility
Latest build for each game version and loader.
26.x2 of 2 versions with builds
1.21.x3 of 3 versions with builds
1.20.x3 of 3 versions with builds
1.19.x3 of 3 versions with builds
1.18.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Required by 24 mods
Use cases
Structure mod development
A worldgen mod can use the trigger, the randomizers and the serialization interfaces instead of writing its own versions.
Who it’s for: Developers of world generation and structure mods, who want shared registration and data tools for Fabric, Forge and NeoForge.
Questions
Does YUNG's API need Fabric API?
Which mods depend on YUNG's API?
Is YUNG's API needed on the server?
In the catalog
YUNG's API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 15,189 mods support Minecraft 26.1.2.
More from Refresh Studios
Similar mods
What the author says
For all my mod devs out there - This provides a lot of useful stuff, especially if you're a worldgen modder! AutoRegistration system (1.18+ only). Register any field with only a simple annotation, regardless of mod loader!
Official listing
- Modrinth page
- modrinth.com/mod/yungs-api
- Owner
- Refresh Studios
- Published
- 2022-11-28
- Updated on Modrinth
- 2026-09-16
- Facts verified
- 2026-10-15