Reef

Reef

Library that extends vanilla worldgen by providing alternatives to unmodifiable features

by
767 Downloads
fabriclibraryworldgen
Rent Server with this Mod

About this Mod

Reef logo

Library that extends vanilla worldgen by providing alternatives to unmodifiable features

What is the goal of the mod?

The main goal of Reef is to take vanilla world gen and make it configurable. The way we want to achieve this is by
not changing vanilla, but adding to it. So let's say we want to be able to customize the Ice Spike feature, the way Reef
approaches this is by creating a new identical feature that is fully customizable. So there is no need for dirty mixins and
breaking compatibility with other mods. This is not possible in all cases of course, and in those cases we will take
the least intrusive option.

What Does the mod do?

Reef does a lot of things! Well, only a few for now, but we have great plans.
Currently, the mod adds duplicates of vanilla features that can be properly configured. Custom Tags have been added to
enable icebergs or eroded badlands generation to occur in biomes. And a Custom StructurePool Projection (See warning
section about this.)

Contents

  • Custom Features:
    • Spike ("Ice Spike" Feature, but customizable)
    • Inverted Spike ("Spike" Feature, but is upside down)
    • Monster Room ("Dungeon" Feature, but customizable)
    • Structure Piece (Similar to "Fossil" Feature, but with no forced height offset)
    • Large Cave Pillar ("Large Dripstone", but customizable)
    • Feature List (Places all features in a list)
  • Custom Tags:
    • has_eroded_pillar (Will apply a custom Eroded Badlands Surface Builder, which has been tweaked to use OCEAN_FLOOR_WG)
    • has_vanilla_badlands_pillar (Will apply the vanilla Eroded Badlands Surface Builder. Should only be used to stop vanilla from generating. Will break in water)
    • has_iceberg (Will apply the Iceberg Surface Builder)
  • StructurePool Projections:
    • SEAFLOOR_MATCHING (Adds seafloor matching projection. See warning section about this.)

Future of the lib

While this lib is only in the early stages of development. We already have plans to fully deprecate this mod. Since This
is planned to be just one module from our future mod VoidLib.

Why?

Because it is nicer to have a single jar file for all the libs we use, kinda like Fapi or QSL

Then why not just release VoidLib?
Because Gradle multi-module projects are hard :(

WARNING

As the mod is currently in very early stages, so there are some kinks we have not fixed.
As of the current version (0.1.2) here are the current warning:

StructurePool Projection SEAFLOOR_MATCHING

This projection exists but does not behave anything like expected.
Please don't use it for anything, but testing.

Custom Features

All the current features were made quickly and very messily for a world gen mod we were working on. They have not been
property cleaned up and optimized. So do expect them to change, both as features and their configs.

Wiki

As of the current update (0.1.2) there is no wiki.
This is just a note saying that Ender is working on one.
If there isn't one more than a month after the (0.1.2) release, go @ Ender on discord

Available Versions

Reef 0.3.0+1.21.11release
MC 1.21.11fabric
March 29, 2026
Reef 0.2.0+1.21.7release
MC 1.21.7, 1.21.8, 1.21.9, 1.21.10fabric
June 30, 2025
Reef 0.1.3release
MC 1.21, 1.21.1fabric
June 18, 2024
Reef 0.1.2release
MC 1.21fabric
June 14, 2024
Reef 0.1.1release
MC 1.20.5, 1.20.6fabric
April 28, 2024

How to Install Reef on Your Server

1

Order Server

Order a Minecraft Java server with at least 4 GB RAM (6 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).

3

Install Mod

Open the mod browser in the dashboard and search for "Reef". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.11, 1.21.10, 1.21.9 (+6 more)

Server-side

Required

Recommended RAM

6 GB(min. 4 GB)

Frequently Asked Questions

Reef 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 4 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.

Is Reef compatible with fabric?

Reef officially supports fabric for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Reef – how to optimize performance?

Recommended RAM: 6 GB (per 5 players). Use /spark profiler to check if Reef 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.

Rent Modded Server

Install Reef with just one click on your server.

Recommended RAM
6 GBab €12/mo
Min. 4 GB | +1 GB pro 5 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.111.21.101.21.91.21.81.21.71.21.11.211.20.61.20.5