WorldgenLib is a server-side API library for Vintage Story world-generation mods. It gives modders ordered hook points for terrain and map work so separate mods can compose their changes through a shared interface.
The first public release is available from GitHub Releases. It publishes the WorldgenLib API, its unit tests, the server-only mod metadata, and the mod icon.
WorldgenLib is infrastructure, not a terrain overhaul. It does not replace GenTerra or GenMaps, and it does not add blocks, items, biomes, or world shape by itself.
- An API for world-generation integrations instead of a competing world generator.
- Ordered hook points for map, terrain, post-processing, and BlockLayers work.
- Cooperative composition for multiple world-generation mods.
- Diagnostics for incompatible takeover or patching strategies.
- A server-side mod package. Clients do not need to install the library itself.
Download WorldgenLib-0.1.0.zip from the release and place it in the server's Mods directory. The SHA-256 file published beside the archive can be used to verify the download.
WorldgenLib is server-side only. Clients do not need to install it. Mods that use WorldgenLib may list it as a server dependency, so follow each consumer mod's installation instructions for its own client and server needs.
WorldgenLib 0.1.0 is built and tested against Vintage Story 1.22.0 through 1.22.7. The reproducible release build uses the official 1.22.7 archive as its pinned reference input. See the compatibility and updates page for the evidence and current limits.
The WorldgenLib site is the public landing page. Its generated C# API reference is built by DocFX from the public source tree. The WorldgenLib Wiki remains the place for conceptual guides, migration notes, and compatibility limits.
The build obtains reference assemblies from the official Vintage Story Windows installer at build time. The installer and extracted game files are build inputs only and are never included in a WorldgenLib release archive.
See Building for local build and test commands. Release maintainers should also read Releasing.
See CONTRIBUTING.md for design and pull request guidelines. WorldgenLib's public API is intended to remain additive, ordered, and explicit about compatibility boundaries.
WorldgenLib is released under the MIT License.