# OneBlock 5.0.0
*This file is for **Forge 26.2**.*
**Biomes, waves and dungeons are now yours to write.** 4.0.0 opened up what the block
drops; this opens up what happens around it. Existing worlds, break counts and configs
carry over untouched — every new section is optional, and a config file that doesn't
mention one keeps the behaviour you already have.
- **Biomes, your way.** Pick how the biome changes as a player progresses: rotate in
order, draw at random by weight, **hard-set which biome comes at which break count**,
pin one biome forever, or let players vote. Each biome can replace the block pool
outright, or just favour the blocks that suit it, and bring its own mob list.
- **Biome progress beside your breaks.** When biome switching is on, the tab list and
the floating text show how far you are through the current biome — `Forest 37/100`.
- **Write your own waves.** Which mobs come, when, in what numbers, hostile or
friendly, limited to certain biomes and certain break ranges, with their own
countdown, size and scaling. Anything you don't set falls back to the old behaviour.
- **Lock during waves.** Optional: while a wave counts down and runs, your OneBlock
turns to bedrock — 30s by default, or any block, any duration, or until the wave is
cleared — so the wave has to be fought instead of mined past. Off by default.
- **Structure Dungeons.** Optional: every break has a small chance of opening a portal
above your OneBlock. Jump in and you land in a private dimension built around a real
structure — a woodland mansion in dark forest, an ocean monument in deep ocean, a
desert pyramid, a jungle temple, a stronghold, a nether fortress, a village or a
pillager outpost — with the world border drawn just outside the structure and a
return portal always available, beside you or hidden somewhere on the surface.
Admins set the chance, which dungeons unlock at which break counts or biomes, and an
optional timer that sends players home. While it's on, the column above the OneBlock
is kept clear so the portal has room.
- **Dungeon variety.** Three dungeons — village, desert pyramid and jungle temple — are
open from your very first break, and the rest unlock as you progress rather than
sitting behind thousands of breaks. **Avoid Repeats**, on by default, stops the same
dungeon being offered twice in a row while another one is unlocked. Together they fix
early portals all leading to the same place. Both are tunable: every dungeon's unlock
point is yours to set, and Avoid Repeats can be switched off for pure random rolls.
- **All of it in the admin menu and in `config/oneblock.json`** — new **Biomes**,
**Waves** and **Dungeons** pages, plus `/oneblock biome`, `/oneblock wave` and
`/oneblock dungeon` commands.
- **The website editor covers everything.** Export your config, edit biomes, waves and
dungeons visually at [codx.io/tools/one-block](https://www.codx.io/tools/one-block),
drop the file back in and hit **Reload From File**.
Turning Structure Dungeons on switches on the datapack that carries the dungeon
dimensions, and a world only reads its dimension list while it loads. The admin menu
asks you to confirm and then tells you what to do: on a server, restart it; in
singleplayer, **quit to the title screen and re-open the world** — that's enough, you
don't have to restart the game. If the dimensions still aren't there afterwards,
`/oneblock dungeon` says so instead of letting the first portal fail silently.
**CodxLib is required** — install the build matching your Minecraft version and loader.
On Fabric it must be **1.3.4 or newer**.
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }