Wilderness rifts · ForgeCraft Wiki

New in 1.1.0

Turn exploration into dungeon discovery. Small arcane, crypt, or infernal ruins appear in newly generated survival chunks and open your published dungeon instances. The entrance is in the survival world; the complete dungeon is played in its instance.

One-command setup

/df rift setup my_dungeon

Run this as an administrator in the intended survival world. It enables the arcane profile for the published dungeon and sets the natural world list to your current world. Edit rifts.yml for additional worlds, weighted dungeon profiles, biome restrictions, and themes.

Default density is one candidate per 16×16 chunk cell with a 65% chance per cell, at least 512 blocks from spawn. Candidates need dry, flat natural ground and an unobstructed site. Unsuitable sites are skipped. Existing chunks are not retrofitted.

Protected land

Recognized claims plugins pause natural generation by default. A protection integration can cancel DungeonForgeRiftGenerateEvent before any changes. Only enable natural.allow-with-claims-plugin after configuring that integration. This setting does not automatically provide support for every claims plugin.

Place a specific entrance

/df rift create crypt_gate my_dungeon crypt
/df rift list
/df rift remove crypt_gate
/df rift reload

Manual placement also needs clear natural ground and a 5×5×5 space, at least two blocks inside a chunk boundary. Removing an entrance deactivates it and removes journal entries; its decorative blocks remain.

Discovery journal and rift compass

/df rifts

Approach within 24 blocks to discover an entrance. Open the paginated journal, hold a compass in your main hand, and click an entry to attune it. The compass tracks the entrance while you are in the same world. Walk through the portal center to begin a run; the party leader starts party runs.

Returning to an entrance via teleport does not immediately start another run. Walk away, then return to enter again. Set portal.walk-in: false to disable automatic entry while keeping discoveries and compass tracking.

Storage and generation limits

rift-data.yml stores entrance ownership and discoveries. Ownership saves before blocks are changed. Discovery updates save every 10 seconds and on orderly shutdown. An interrupted build can leave a partially built registered entrance; inspect it before replacing it. Default limit: 250 entrances per world.