OneBlock 3.0.0 · Release docs

OneBlock Docs

Survive on a regenerating block in the void. This page covers installation, multiplayer setup, and what changed in version 3.0.0.

Version 3.0.0

Target: Minecraft 26.1.x (26.1 → 26.1.2)
Loaders: Fabric, Forge, NeoForge

What we did

  • Completed full multi-loader support for Fabric, Forge, and NeoForge.
  • Stabilized worldgen and registry timing across loaders.
  • Fixed built-in datapack registration and display names in pack screens.
  • Updated pack metadata formats for current Minecraft versions.
  • Defaulted OneBlock overworld structures to OFF.
  • Fixed thrown-item void behavior so items no longer snap back to throw position.
  • Improved island generation consistency and removed detached starter artifacts.
  • Removed wave-cleared message feedback while keeping wave logic active.
  • Enforced falling-block config so sand/gravel are blocked when disabled.

Quick start

  1. Install your loader for Minecraft 26.1.x (26.1, 26.1.1, or 26.1.2) (Fabric / Forge / NeoForge).
  2. Download OneBlock 3.0.0 and place the matching jar in your `mods` folder.
  3. Create a world using `level-type=oneblock:oneblock`.
  4. Enable oneblock:oneblock_multiplayer in initial-enabled-packs for per-player islands.
  5. Optional built-in packs:
  6. oneblock:oneblock_void_nether
  7. oneblock:oneblock_void_end
  8. oneblock:oneblock_no_island
  9. Set oneblock.multiplayerIslandSpacing=<blocks> before first world creation

Setup checklist

  • Set `oneblock.multiplayerIslandSpacing=<blocks>` before first world creation.
  • Optional built-in packs: oneblock_void_nether, oneblock_void_end, oneblock_no_island.
  • If island spacing is wrong, recreate the world after adjusting spacing.
  • Back up worlds before major updates or config migrations.

Gameplay and server notes

The core loop is progression through repeated OneBlock breaks. In multiplayer, set spacing before world creation and enable only the built-in packs you actually want.

Singleplayer + MultiplayerPer-player islandsWorld backup recommended

Admin menu (all options)

  • Open with `/oneblock admin` (OP / admin permission in multiplayer).
  • Navigation: page 1 → 5 with Previous/Next arrows.
  • Left click decreases and right click increases values.
  • Shift-click applies larger steps on numeric/weight options.
  • Reset to Defaults is available on every page.

Page 1 · Core, waves, drops, multiplayer, portal

  • Core toggles: Mob Waves, Item Drops, Friendly Mobs, Portal Frames, Plants.
  • Wave settings: Enemy Wave Chance, Max Wave Size, Wave Size Divisor, Hostile Spawn Radius, Friendly Wave Chance.
  • Drop settings: Item Drop Chance, Drop Count, Lava Chance, Water Chance.
  • Drop filters: Spawner Drops, Block-Entity Blocks, Falling Blocks, Fiddly Shapes.
  • Multiplayer breaking: Allow Breaking Others' Blocks, Count for Original Owner.
  • End portal: Frame Chance and Min Breaks requirement.

Page 2 · Biomes, progression, wave tiers

  • Biome system: Biome Cycling, Biome Switch Interval, Biome Voting, Vote Cooldown.
  • Progression: Progression Cap and Global Breaks (shown when multiplayer datapack is enabled).
  • Wave countdown tiers: Tier 0-5 timers for different progression thresholds.

Page 3 · UI and quality of life

  • UI: Tab Break Count, Dialog Messages, Dialog Duration, Visual Effects.
  • Wave alerts: Wave Alert and Alert Duration.
  • Quality of life: Items in Chest, Gentle Drop (OneBlock), Gentle Drop (Other), Keep Inventory, Verbose Logging.
  • Wave-cleared popup feedback is removed in 3.0.0.

Page 4 · Animal spawn control

  • Animal spawn weights (1-10): Farm, Resource, Mount, Pet, Utility, Rare.
  • Higher weight means that category appears more often during friendly spawns.

Page 5 · Block spawn control

  • Block category weights (1-20): Logs, Planks, Common Ores, Rare Ores, Wool, Structural, Plants, Leaves.
  • Higher weight increases how often that block category is selected by OneBlock generation.

Commands and permissions

Use the Copy button to paste commands directly in-game or in your server console.

  • OP means permission level 2 (GameMaster) in multiplayer.
  • Most commands are available to all players unless marked OP-only.
  • Some `/oneblock` subcommands only work in OneBlock world type.

/oneblock version

OP required: No

Shows mod/game version and update check.

/oneblock help

OP required: No

Exports a support/help report file for your current world.

/oneblock admin

OP required: No

Opens the admin panel GUI (player only).

/oneblock leaderboard

OP required: No

Opens multiplayer stats leaderboard (player only, multiplayer only).

/oneblock guide

OP required: No

Gives/updates the OneBlock guidebook (player only).

/oneblock config list

OP required: Yes

Lists key config values.

/oneblock config reset

OP required: Yes

Resets all config values to defaults.

/oneblock config get <setting>

OP required: Yes

Reads a specific setting value.

/oneblock config set <setting> <value>

OP required: Yes

Sets numeric config values.

/oneblock config toggle <feature>

OP required: Yes

Toggles supported boolean features.

/votebiome <biome>

OP required: No

Starts biome vote (player only).

/voteyes

OP required: No

Votes yes on active biome vote (player only).

/voteno

OP required: No

Votes no on active biome vote (player only).

/biomes

OP required: No

Lists available biome names.

/setbiome [biome]

OP required: No

Lists or selects a biome through vote flow (player only).

Troubleshooting

Mod not loading

Verify loader (Fabric/Forge), game version, and dependency versions match the downloaded release.

World progression feels stuck

Check config values, then confirm no other progression mods are overriding drop tables or loot behavior.

Crash on startup

Review latest log, remove conflicting mods, and re-test with only required dependencies enabled.

Tip: If islands are too close or too far apart, recreate the world after changing spacing.

View on ModrinthBack to docs hub