One Block

OneBlock

You spawn in the void on a single block. Break it, and it comes back — as something else. Every break is a step through a progression you control: blocks get harder, mobs start showing up in waves, the biome around you changes, and eventually portals open to dungeons built around real Minecraft structures.

Everything in this mod is configurable, in-game through an admin menu, through commands, or by editing one JSON file — and that file has a visual editor on the web.

Runs on Minecraft 1.20.1 through 26.2, on Fabric, Forge and NeoForge. Requires CodxLib — install the build matching your Minecraft version and loader.

---

Features

The block

• Registry-wide spawn pool. Every block in the game can appear, including blocks

added by other mods — nothing is hardcoded, so a modded pack just works.

• Hardness-based progression. Soft blocks come first and harder ones scale in as you

break more, up to a progression cap you set. Or flip on Any Block (No Progression) and let the whole registry spawn from break one.

• Category weights. Logs, planks, ores, rare ores, wool, structural blocks, plants —

each category is a relative weight you can raise, lower or zero out.

• Item and chest drops, plant growth, bucket drops, and end portal frames on a

configurable chance and break requirement.

Your own drop tables

• Browse everything spawnable in the in-game dictionaries — blocks, items, hostile

mobs and friendly mobs — with live spawn chances, and toggle any entry off.

• Custom weighted tables: write exactly what drops and how often.
• Tiers and unlocks: gate any entry behind a break threshold, either directly or by

tier. Locked entries contribute zero weight, so the percentages you see always add up.

Biomes

• Pick how the biome changes as you progress: 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 can bring its own mob list.

• Biome progress beside your break count in the tab list and the floating text —

Forest 37/100.

Mob waves

• 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 leave unset falls back to the built-in 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.

• Incoming-wave alerts, completion feedback, and per-wave size scaling.

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, an ocean monument, a desert pyramid, a jungle temple, a stronghold, a nether fortress, a village or a pillager outpost.

• The world border sits just outside the structure, the biome matches it, and a

return portal is always available.

• Admins set the chance, which dungeons unlock at which break counts or biomes, an

optional timer that sends players home, and Avoid Repeats so you don't get the same dungeon twice in a row.

Multiplayer

• One island per player, spaced however far apart you want.
• Per-player or shared global break counts, and rules for whether players may break

each other's blocks and who gets the credit.

• Manage Players page: full stats per player, teleport to their OneBlock, or delete

their island entirely.

• A leaderboard command.

Dimensions

• Void the Nether and the End (or restore them) from the admin menu or a command —

backed up before wiping.

• Bundled datapacks for a void Nether, void End, no starter island, and multiplayer mode.

Quality of life

• Floating text above your OneBlock showing progress, plus optional break counts in

the tab list.

• Visual effects, gentle item drops, keep-inventory-on-death, verbose logging — all

toggles.

• Built-in update checker and /oneblock help debug report for bug reports.

---

Configure it your way

In-game admin menu — /oneblock admin opens a chest menu with pages for Overview, Core Settings, Biomes & Progression, UI & Quality of Life, Animal Spawn Control, Block Spawn Control, Drops & Tables, Dimensions and Manage Players. It's a normal chest GUI, so it works on a vanilla client.

Commands — /oneblock with admin, leaderboard, dictionary, table, export, config, biome, waves, dungeon, leave, void and restore subcommands.

One JSON file — everything lives in config/oneblock.json. Hit Export For Website on the admin menu's Overview page, edit it visually at codx.io/tools/one-block, drop the file back in and hit Reload From File. Both buttons are op-only.

---

Installation