

Modrinth · Fabric, Forge, NeoForge, Quilt
One Block on your Minecraft server
One Block runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
One Block: Begin your Minecraft adventure in a desolate world with just one respawning block. Break it, level it up, and unlock richer rewards with each upgrade.
- Downloads
- 784.4K
- Author
- –
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.20.1 – 26.3
- Updated
- –
Screenshots
What One Block looks like
Images: One Block on Modrinth, published by the project team.
Setup
Install One Block on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
6 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.3.
- 03
Install the mod
Search the mod browser for “One Block” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
One Block is optional on the client. Players connect using the server address from the panel.
- On the server
- Optional
- On the client
- Optional
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 26.3, 26.2, 26.1.2 +20 more
- License
- Creative Commons Attribution Non Commercial 4.0 International
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
One Block · Modrinth- OneBlock 5.2.0 — NeoForge 26.3November 3, 2026Minecraft 26.3 · NeoForge
- OneBlock 5.2.0 — Forge 26.3November 3, 2026Minecraft 26.3 · Forge
- OneBlock 5.2.0 — Fabric 26.3November 3, 2026Minecraft 26.3 · Fabric
- OneBlock 5.2.0 — NeoForge 26.2November 3, 2026Minecraft 26.2 · NeoForge
- OneBlock 5.2.0 — Forge 26.2November 3, 2026Minecraft 26.2 · Forge
Original description by the project author
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 helpdebug 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
- Install your loader (Fabric / Forge / NeoForge) for your Minecraft version.
- Put CodxLib for that same version and loader in
yourmodsfolder — OneBlock will not start without it. - Put the matching
OneBlockjar in yourmodsfolder. - Create a world using the
oneblock:oneblockworld preset (level-type=oneblock:oneblock). - (Optional) Enable the built-in datapacks below for multiplayer mode, a void Nether or
End, or to skip the starter island.
New to this? The step-by-step guides at the bottom of this page walk through it.
Datapack usage by loader (client + server)
All loaders use the same world preset:
level-type=oneblock:oneblock
Built-in pack meanings
...multiplayer= one island slot per player...void_nether= removes Nether terrain...void_end= removes End terrain...no_island= disables the initial 3x3 starter island...dungeons= carries the Structure Dungeon dimensions (the admin menu turns this on
for you when you enable dungeons)
Fabric (and Quilt)
Singleplayer / client-hosted world
In Create World → Data Packs, enable:
oneblock:oneblock_multiplayer(optional)oneblock:oneblock_void_nether(optional)oneblock:oneblock_void_end(optional)oneblock:oneblock_no_island(optional)oneblock:oneblock_dungeons(optional)
Set:
level-type=oneblock:oneblockinitial-enabled-packs=vanilla,oneblock\:oneblock_multiplayer,oneblock\:oneblock_void_nether,oneblock\:oneblock_void_end,oneblock\:oneblock_no_island,oneblock\:oneblock_dungeons
Forge
Singleplayer / client-hosted world
In Create World → Data Packs, enable:
oneblock:oneblock_multiplayer(optional)oneblock:oneblock_void_nether(optional)oneblock:oneblock_void_end(optional)oneblock:oneblock_no_island(optional)oneblock:oneblock_dungeons(optional)
Set:
level-type=oneblock:oneblockinitial-enabled-packs=vanilla,oneblock\:oneblock_multiplayer,oneblock\:oneblock_void_nether,oneblock\:oneblock_void_end,oneblock\:oneblock_no_island,oneblock\:oneblock_dungeons
NeoForge
Singleplayer / client-hosted world
In Create World → Data Packs, enable these built-ins:
mod/oneblock:resourcepacks/oneblock_multiplayer(optional)mod/oneblock:resourcepacks/oneblock_void_nether(optional)mod/oneblock:resourcepacks/oneblock_void_end(optional)mod/oneblock:resourcepacks/oneblock_no_island(optional)mod/oneblock:resourcepacks/oneblock_dungeons(optional)
Set:
level-type=oneblock:oneblockinitial-enabled-packs=vanilla,mod/oneblock\:resourcepacks/oneblock_multiplayer,mod/oneblock\:resourcepacks/oneblock_void_nether,mod/oneblock\:resourcepacks/oneblock_void_end,mod/oneblock\:resourcepacks/oneblock_no_island,mod/oneblock\:resourcepacks/oneblock_dungeons
Multiplayer spacing
- Set
oneblock.multiplayerIslandSpacing=<blocks>before first world creation. - If spacing was wrong once, delete the world and recreate it after updating this value.
A note on Structure Dungeons
A world only reads its dimension list while it loads, so turning dungeons on takes a
world reload. The admin menu enables the datapack for you 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 something didn't take,/oneblock dungeon says so instead of letting the first portal fail silently.
Getting started guides
Step-by-step walkthroughs live on the Discord — how to install the mod, create the world,
turn the datapacks on, and get a server running.
Join the Discord first, then open the guide you need:
Questions, bug reports and suggestions are welcome in the same place.
One Block server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does One Block run on?
According to Modrinth, One Block supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.3, 26.2, 26.1.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.
How much RAM does a server with One Block need?
As guidance, 4–6 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Server-ready
Xaero's Minimap
by thexaero
Displays a map of the nearby world terrain, players, mobs, entities in the corner of your screen. Lets you create waypoints which help you find the locations you've marked.
Server-ready
Xaero's World Map
by thexaero
Adds a full screen world map which shows you what you have explored in the world. Works great together with Xaero's Minimap.
Client only
Not Enough Animations
by tr7zw
Bringing first-person animations to the third-person
Client only
3D Skin Layers
by tr7zw
Render the player skin layer in 3d!
Ready for your server with One Block?
6 GB of RAM from €12.00 per month. 35% off your first month with MADO35.



