OneBlock
你出生在虚空中的一个方块上。破坏它,它会重新出现——但变成另一种东西。
每一次破坏都是你掌控的进度的一部分:方块变得更有硬度,怪物开始以波次出现,周围的生物群系发生变化,最终传送门会打开,通往围绕真实 Minecraft 结构建造的地牢。
本模组的所有内容均可配置,可以通过游戏内的管理员菜单、命令或编辑一个 JSON 文件来实现——并且该文件提供了一个
网页可视化编辑器。
支持 Minecraft 1.20.1 至 26.2,兼容 Fabric、Forge 和 NeoForge。
需要 CodxLib ——安装与你的 Minecraft 版本及加载器匹配的版本。
功能特性
方块机制
- 全局注册表生成池。游戏中的每个方块都可能出现,包括其他模组添加的方块——没有硬编码逻辑,因此模组整合包可以直接使用。
- 基于硬度的进度系统。软方块优先出现,随着破坏次数增加,更硬的方块按比例加入,直到达到你设定的进度上限。或者开启 任意方块(无进度) 模式,让所有注册表中的方块从第一次破坏就开始随机生成。
- 类别权重。原木、木板、矿石、稀有矿石、羊毛、建筑方块、植物等——每个类别都有一个相对权重,你可以提高、降低或设为零。
- 物品和战利品箱掉落、植物生长、桶装液体掉落以及末地传送门框架,均根据可配置的几率和破坏次数要求触发。
自定义掉落表
- 浏览所有可生成项:在游戏内字典中查看方块、物品、敌对生物和友好生物的实时生成几率,并可以关闭任何条目。
- 自定义加权表:精确编写掉落物及其频率。
- 层级与解锁:将任何条目设置在达到特定破坏阈值后才解锁,无论是直接设置还是通过层级限制。锁定的条目贡献为零权重,因此你看到的百分比总和始终正确。
生物群系
- 选择随进度变化的生物群系方式:按顺序轮换、按权重随机抽取、硬性指定在特定破坏次数时切换的生物群系、永久固定某个生物群系,或让玩家投票决定。
- 每个生物群系可以完全替换方块池,或者只是偏向于适合它的方块,并可以自带专属的怪物列表。
- 玩家列表和浮动文字旁显示生物群系进度——例如
Forest 37/100。
怪物波次
- 编写你自己的波次:定义哪些怪物出现、何时出现、数量多少、是敌对还是友好、限制在特定生物群系和特定破坏区间内,并拥有独立的倒计时、大小和缩放比例。未设置的选项将回退到内置行为。
- 波次期间锁定(可选):当波次倒计时和运行时,你的 OneBlock 会变成基岩——默认持续 30 秒,也可以设置为任意方块、任意持续时间,直到波次被清除——这样玩家必须战斗而不是挖掘绕过。
- 即将到来的波次提示、完成反馈以及每波次的大小缩放。
结构地牢
- 可选功能:每次破坏都有小概率在你 OneBlock 上方打开一个传送门。跳进去后,你会进入一个围绕真实结构建造的私人维度——如林地府邸、海洋神殿、沙漠神殿、丛林神庙、要塞、下界要塞、村庄或掠夺者前哨站。
- 世界边界位于结构外部附近,生物群系与之匹配,并且始终提供返回传送门。
- 管理员设置开启几率、哪些地牢在特定破坏次数或生物群系下解锁、可选的送回玩家的计时器,以及 避免重复 功能,防止连续两次进入相同的地牢。
多人游戏
- 每位玩家一个岛屿,间距由你设定。
- 支持单人计数或共享全局破坏计数,并设定规则判断玩家是否可以破坏彼此的方块,以及谁获得奖励。
- 管理玩家页面:查看每位玩家的完整统计信息、传送到他们的 OneBlock,或删除其整个岛屿。
- 提供排行榜命令。
维度管理
- 清空下界和末地(或恢复它们),可通过管理员菜单或命令操作——清空前会自动备份。
- 包含用于清空下界、清空末地、无初始岛屿和多人生存模式的集成数据包。
生活质量优化
- OneBlock 上方的浮动文字显示进度,玩家列表中也可选显示破坏计数。
- 视觉效果、柔和的物品掉落、死亡保留背包、详细日志记录——全部为可切换开关。
- 内置更新检查器和
/oneblock help 调试报告,便于提交错误报告。
按需配置
游戏内管理员菜单 — /oneblock admin 打开一个包含多个页面的箱子界面,涵盖概览、核心设置、生物群系与进度、用户界面与生活质量、动物生成控制、方块生成控制、掉落与表格、维度管理和玩家管理。这是一个标准的箱子 GUI,因此在原版客户端上也能正常工作。
命令 — /oneblock 带有以下子命令:admin、leaderboard、dictionary、table、export、config、biome、waves、dungeon、leave、void 和 restore。
一个 JSON 文件 — 所有配置存储在 config/oneblock.json 中。在管理员菜单的“概览”页面上点击 导出至网站,然后在
codx.io/tools/one-block 进行可视化编辑,将文件放回原处并点击 从文件重载。这两个按钮仅限 OP 权限使用。
安装
- 为你的 Minecraft 版本安装加载器(Fabric / Forge / NeoForge)。
- 将适用于相同版本和加载器的 CodxLib 放入你的
mods 文件夹中——没有它 OneBlock 将无法启动。
- 将对应的
OneBlock jar 包放入你的 mods 文件夹。
- 使用
oneblock:oneblock 世界预设创建世界(level-type=oneblock:oneblock)。
- (可选) 为多人游戏模式、虚空下界或末地,或者跳过起始岛屿,启用下方内置的数据包。
初次接触?页面底部的分步指南会引导你完成设置。
按加载器使用的数据包(客户端 + 服务器)
所有加载器都使用相同的 World Preset:
level-type=oneblock:oneblock
内置数据包含义
...multiplayer = 每位玩家一个岛屿槽位
...void_nether = 移除下界地形
...void_end = 移除末地地形
...no_island = 禁用初始的 3x3 起始岛屿
...dungeons = 携带结构地牢维度(当你启用地牢时,管理菜单会自动为你开启此项)
Fabric (以及 Quilt)
单人游戏 / 客户端托管世界
- 在“创建世界” → “数据包”中启用:
oneblock:oneblock_multiplayer(可选)
oneblock:oneblock_void_nether(可选)
oneblock:oneblock_void_end(可选)
oneblock:oneblock_no_island(可选)
oneblock:oneblock_dungeons(可选)
专用服务器 (server.properties)
- 设置:
level-type=oneblock:oneblock
initial-enabled-packs=vanilla,oneblock\:oneblock_multiplayer,oneblock\:oneblock_void_nether,oneblock\:oneblock_void_end,oneblock\:oneblock_no_island,oneblock\:oneblock_dungeons
Forge
单人游戏 / 客户端托管世界
- 在“创建世界” → “数据包”中启用:
oneblock:oneblock_multiplayer(可选)
oneblock:oneblock_void_nether(可选)
oneblock:oneblock_void_end(可选)
oneblock:oneblock_no_island(可选)
oneblock:oneblock_dungeons(可选)
专用服务器 (server.properties)
- 设置:
level-type=oneblock:oneblock
initial-enabled-packs=vanilla,oneblock\:oneblock_multiplayer,oneblock\:oneblock_void_nether,oneblock\:oneblock_void_end,oneblock\:oneblock_no_island,oneblock\:oneblock_dungeons
NeoForge
单人游戏 / 客户端托管的世界
- 在创建世界 → 数据包中,启用以下内置项:
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(可选)
专用服务器 (server.properties)
- 设置:
level-type=oneblock:oneblock
initial-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
多人游戏间距
- 在首次创建世界之前,将
oneblock.multiplayerIslandSpacing=<方块数> 设置为相应数值。
- 如果间距设置错误,请删除该世界并在更新此值后重新创建。
关于结构地牢的说明
世界仅在加载时读取其维度列表,因此启用地牢功能需要重新加载世界。管理员菜单会为你启用数据包,并告诉你接下来该怎么做:在服务器上,重启服务器即可;在单人游戏中,退出到主菜单并重新打开世界——这就足够了,无需重启游戏。如果操作未生效,/oneblock dungeon 命令会明确提示你,而不是让第一个传送门无声失败。
入门指南
逐步教程位于 Discord 频道中——包括如何安装模组、创建世界、启用数据包以及运行服务器。
请先 加入 Discord,然后打开你需要的那份指南:
- ? 开始单人世界
- ?️ 启动专用服务器
- ☁️ 在 Aternos 上设置
欢迎在同一频道提出疑问、报告错误或提交建议。
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
- Install your loader (Fabric / Forge / NeoForge) for your Minecraft version.
- Put CodxLib for that same version and loader in
your
mods folder — OneBlock will not start without it.
- Put the matching
OneBlock jar in your mods folder.
- Create a world using the
oneblock:oneblock world 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)
Dedicated server (server.properties)
- Set:
level-type=oneblock:oneblock
initial-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)
Dedicated server (server.properties)
- Set:
level-type=oneblock:oneblock
initial-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)
Dedicated server (server.properties)
- Set:
level-type=oneblock:oneblock
initial-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:
- ? Starting a singleplayer world
- ?️ Starting a dedicated server
- ☁️ Setting it up on Aternos
Questions, bug reports and suggestions are welcome in the same place.
评论 0
登录后参与评分
还没有评论,来抢沙发吧