OneBlock SMP

⚠️ OneBlock SMP is in early development. Block drop rates, chest loot, event rewards, and phase balance are still being tuned. New versions may require a world reset — back up your server before updating.

OneBlock SMP drops each player onto a single block floating over the void. Break it, and a new one appears. That's your entire world — build it from nothing.

Phased Progression

Progress through 11 unique phases as you break blocks, each with its own block pools, mob spawns, loot chests, and atmospheric biome shifts:

Plains → Forest → Caves → Desert → Swamp → Taiga → Jungle → Underground → Deep Dark → Nether → End

Every phase is data-driven via JSON — server operators can customize block pools, mob spawns, loot tables, and phase thresholds.

SMP-First Design

• Per-player islands — each player gets their own one-block, spaced 1000 blocks apart by default. Everyone progresses independently.
• Claim protection — a 100-block radius around each island prevents griefing. Visit friends, but only build on your own island.
• Leaderboards — track who's broken the most blocks and reached the furthest phase via the scoreboard sidebar and tab list.

Island spacing, claim radius and event tuning are all configurable — see the Configuration section below.

Competitive Events

Break up the grind with server-wide minigames:

• Block Hunt — a procedurally generated dungeon filled with hidden target blocks. Use your compass to track them down before anyone else.
• Mining Challenge — race to find a single hidden gold block inside a massive cobblestone cube. Cube size scales with player count.
• Scavenger Hunt — explore a vanilla wilderness and race to complete a checklist of tiered items. A 45-minute drop-in/drop-out event where every item found earns points.
• Checkpoint Rally — a sprint across procedurally generated terrain, hitting checkpoint pillars in order. Each one you reach lights up the next with a personal particle trail, so everyone runs the same route but nobody can follow the pack. Rolling hills, walls, pools and boulders get in the way. First to clear the course wins.

Full save/restore of player state (inventory, XP, position, effects) when entering and leaving events.

Central Hub & Economy

A floating marketplace off in its own corner of the world, reachable from anywhere with /oneblock hub — fountain, market stalls, and a return portal that drops you straight back on your island.

Six villager-run shops trade in OneCoins: Builder's Supply, Miner's Goods, Farmer's Market, Explorer's Outpost, Event Rewards and Rare Trades. Right-click a shopkeeper to browse, or buy straight from chat.

Earn OneCoins by placing in events, reaching a new phase, and simply playing — the hub is protected ground, so nobody can build or break there. Shop inventories and prices are data-driven JSON, so operators can rewrite the entire economy.

🖥️ Dedicated Server Setup

OneBlock SMP uses a custom void world. On a dedicated server you must tell it to generate that world — otherwise you'll spawn into a normal map with no one-block, and /oneblock home will say you don't have one.

1. Install Fabric Loader and drop Fabric API + OneBlock SMP into your mods/ folder.
2. Stop the server, then edit server.properties: level-type=oneblock:oneblock
3. Delete (or rename) your existing world folder (the one named by level-name, default world). level-type only applies to a freshly generated world — it will not convert an existing one.
4. Start the server. You'll spawn on your one-block.

⚠️ Changing level-type without deleting the old world has no effect — this is the single most common setup mistake. Single-player works automatically: just select the "OneBlock" world type on the create-world screen.

⚙️ Configuration

Server settings live in config/oneblock.json, created with defaults the first time the mod loads. Edit the file and run /oneblock config reload — no restart needed.

Island layout

• island.player_spacing — blocks between neighbouring islands (default 1000)
• island.claim_radius — build-protection radius around each island (default 100)

Hub

• hub.center_x / hub.center_z — where the hub sits. It defaults to well clear of the island chain so it's never in view from anyone's island. Change it and the hub relocates on the next server start, shopkeepers and all.
• hub.protection_radius — no-build radius around the hub (default 50)

Economy

• economy.playtime_reward_interval_minutes and economy.playtime_reward_amount — OneCoins paid out for time played (default 1 coin every 5 minutes)

Events

• events.auto_schedule_interval_minutes — how often events fire automatically (default 45)
• Per event — block_hunt, mining_challenge, scavenger_hunt and checkpoint_rally each take announce_seconds (the join window), countdown_seconds, duration_seconds and min_players
• rewards — OneCoins for 1st, 2nd, 3rd and participation, per event
• Plus per-event tuning: targets per player in Block Hunt, cube sizing in Mining Challenge, arena size and checklist length in Scavenger Hunt

The file also carries keys for events still in development — leave those alone for now.

Everything is validated on load — out-of-range values are clamped and logged rather than crashing the server, and claim radius is capped below half the island spacing so claims can never overlap onto a neighbour.

⚠️ island.player_spacing applies to islands handed out after the change. Players who already have an island stay where they are, so changing it on an established server gives you mixed spacing.

📦 Customising content with a datapack

Phases, shops and the Scavenger Hunt item pool are loaded through the resource manager, so a datapack can change them without touching the jar. Drop files into world/datapacks/<your-pack>/data/oneblock/:

Reusing a bundled file's path replaces it; a new path adds to it. /reload applies changes without a restart. Rewrite the whole progression, re-price the economy, or swap the scavenger list for something themed — no Java required.

Commands

Player commands:

• /oneblock home — teleport to your island
• /oneblock visit <player> — visit another player's island
• /oneblock phase — view your current progress
• /oneblock leaderboard — show ranked player list by blocks broken
• /oneblock sidebar — toggle the progress sidebar on/off
• /oneblock reset — reset your progress and start over
• /oneblock event join/leave/info — participate in events
• /oneblock hub — teleport to the central hub
• /oneblock balance — check your OneCoins
• /oneblock buy <shop> <number> — buy a numbered item from a shop without leaving chat

Admin commands (OP only):

• /oneblock event start <type> — start a Block Hunt, Mining Challenge, Scavenger Hunt or Checkpoint Rally
• /oneblock event forcestart — skip the join period and start immediately
• /oneblock event stop — end the current event early
• /oneblock event time <amount> — adjust remaining time (e.g. 5m, 30s)
• /oneblock event auto — toggle automatic event scheduling
• /oneblock bedrock <players> — regenerate bedrock foundation for specified players
• /oneblock config — show the current config values
• /oneblock config reload — re-read config/oneblock.json without a restart

Requirements

• Minecraft 26.1
• Fabric Loader 0.16.0+
• Fabric API