⚠️ OneBlock SMP 处于早期开发阶段。方块掉落率、宝箱战利品、活动奖励及阶段平衡仍在调整中。新版本可能需要重置世界——在更新前请务必备份服务器。
OneBlock SMP 将每位玩家投放到虚空上方悬浮的一个方块上。打破它,一个新的方块就会出现。这就是你的整个世界——从一无所有开始建造。
阶段性进展
随着你打破方块,依次进入 11 个独特阶段,每个阶段都有各自的方块池、生物生成、宝箱战利品以及氛围生物群系的变化:
平原 → 森林 → 洞穴 → 沙漠 → 沼泽 → 针叶林 → 丛林 → 地下 → 深暗之域 → 下界 → 末地
每个阶段均由 JSON 数据驱动——服务器运营者可自定义方块池、生物生成、战利品表及阶段阈值。
以多人游戏(SMP)为核心的设计
- 独立玩家岛屿 —— 每位玩家拥有自己的一个方块岛,默认间距为 1000 格。每个人独立 progression。
- 领地保护 —— 每个岛屿周围 100 格半径范围内防止破坏。可以拜访朋友,但只能在属于自己的岛屿上建造。
- 排行榜 —— 通过记分板侧边栏和标签页列表追踪谁打破了最多的方块并达到了最远的阶段。
岛屿间距、保护半径和活动参数均可配置——详见下方的配置部分。
竞技活动
通过全服迷你游戏打破单调的刷怪节奏:
- 方块猎杀(Block Hunt) —— 一个程序生成的地牢,其中藏有目标方块。使用指南针在其他人之前找到它们。
- 挖矿挑战(Mining Challenge) —— 在巨大的圆石立方体中寻找唯一隐藏的金块。立方体大小随玩家数量缩放。
- 寻宝游戏(Scavenger Hunt) —— 探索原版荒野,竞速完成分级物品清单。这是一个允许随时加入退出的 45 分钟活动,每找到一个物品都会获得积分。
- 检查点拉力赛(Checkpoint Rally) —— 在程序生成的地形上冲刺,按顺序触碰检查点石柱。每到达一个检查点,下一个会以个人粒子轨迹亮起,确保所有人跑相同的路线但无人能尾随大部队。起伏的山丘、墙壁、水池和巨石会成为障碍。率先清除赛道者获胜。
在进入和离开活动时,完整保存/恢复玩家状态(背包、经验值、位置、效果)。
中央枢纽与经济系统
位于世界角落的浮动市场,可通过 /oneblock hub 从任何地方到达——设有喷泉、市场摊位以及将你直接传送回岛屿的返回传送门。
六家由村民经营商店交易 OneCoins:建筑商补给、矿工物资、农夫集市、探险家前哨站、活动奖励和稀有交易。右键点击店主浏览,或直接在聊天框购买。
通过在活动中取得名次、达到新阶段以及日常游玩赚取 OneCoins——枢纽区域受保护,因此无人可在此处建造或破坏。商店库存和价格由 JSON 数据驱动,运营者可重写整个经济体系。
?️ 专用服务器设置
OneBlock SMP 使用自定义虚空世界。在专用服务器上,你必须告知服务器生成该世界——否则你将出生在普通地图中且没有“一个方块”,此时执行 /oneblock home 会提示你没有方块。
- 安装 Fabric Loader 并将 Fabric API + OneBlock SMP 放入
mods/ 文件夹。
- 停止服务器,然后编辑
server.properties:level-type=oneblock:oneblock
- 删除(或重命名)你现有的世界文件夹(即由
level-name 命名的那个,默认为 world)。level-type 仅适用于新生成的世界——它不会转换现有世界。
- 启动服务器。你将在你的一个方块上出生。
⚠️ 在不删除旧世界的情况下更改 level-type 无效——这是最常见的设置错误。
单机模式自动生效:只需在创建世界界面选择 "OneBlock" 世界类型即可。
⚙️ 配置
服务器设置位于 config/oneblock.json,模组首次加载时会自动创建带有默认值的文件。编辑文件后运行 /oneblock config reload ——无需重启服务器。
岛屿布局
island.player_spacing — 相邻岛屿之间的格数 (默认 1000)
island.claim_radius — 每个岛屿周围的建造保护半径 (默认 100)
枢纽
hub.center_x / hub.center_z — 枢纽的位置。默认设置在远离岛屿链的地方,以便从任何人的岛屿上都看不到它。更改后,下次服务器启动时枢纽连同所有店主都会重新定位。
hub.protection_radius — 枢纽周围的禁止建造半径 (默认 50)
经济
economy.playtime_reward_interval_minutes 和 economy.playtime_reward_amount — 根据游戏时间发放 OneCoins (默认每 5 分钟 1 枚硬币)
活动
events.auto_schedule_interval_minutes — 活动自动触发的频率 (默认 45 分钟)
- 每个活动——
block_hunt、mining_challenge、scavenger_hunt 和 checkpoint_rally 分别接受 announce_seconds(加入窗口)、countdown_seconds(倒计时)、duration_seconds(持续时间)和 min_players(最小玩家数)
rewards — 每个活动的第 1、2、3 名及参与奖的一枚硬币数量
- 加上每个活动的微调参数:Block Hunt 中每个玩家的目标数、Mining Challenge 中的立方体尺寸、Scavenger Hunt 中的竞技场大小和清单长度
该文件还包含仍在开发中的活动密钥——目前请勿修改这些内容。
所有内容在加载时均经过验证——超出范围的值会被限制并记录日志,而不会导致服务器崩溃;并且保护半径被限制在岛屿间距的一半以下,以确保保护区域永远不会重叠到邻居身上。
⚠️ island.player_spacing 仅适用于更改后分发的岛屿。已经拥有岛屿的玩家保持原位不动,因此在已建立的服务器上更改此设置会导致出现混合间距的情况。
? 使用数据包自定义内容
阶段、商店和寻宝游戏物品池通过资源管理器加载,因此数据包可以在不接触 jar 文件的情况下更改它们。将文件放入
world/datapacks/<your-pack>/data/oneblock/:
| 路径 |
控制内容 |
oneblock_phases/*.json |
方块池、生物生成、宝箱间隔、阶段阈值 |
shops/*.json |
商人库存与价格 — stall 用于选择大厅位置 |
scavenger_items/*.json |
寻宝物品及其等级 — 文件会被合并 |
loot_table/chests/*.json |
各阶段的宝箱掉落物 |
复用已捆绑文件的现有路径会替换它;添加新路径则会追加。使用 /reload 命令即可应用更改,无需重启服务器。你可以重写整个进度体系、重新定价经济系统,或替换为特定主题的寻宝列表 — 无需编写 Java 代码。
命令
玩家命令:
/oneblock home — 传送至你的岛屿
/oneblock visit <player> — 访问其他玩家的岛屿
/oneblock phase — 查看当前进度
/oneblock leaderboard — 显示按破坏方块数排名的玩家列表
/oneblock sidebar — 切换进度侧边栏的显示/隐藏
/oneblock reset — 重置进度并重新开始
/oneblock event join/leave/info — 参与事件活动
/oneblock hub — 传送至中央大厅
/oneblock balance — 查询你的 OneCoins 余额
/oneblock buy <shop> <number> — 在聊天界面中直接购买商店中的编号商品
管理员命令(仅限 OP):
/oneblock event start <type> — 开始方块狩猎、挖矿挑战、寻宝或Checkpoint 接力赛
/oneblock event forcestart — 跳过加入阶段并立即开始
/oneblock event stop — 提前结束当前事件
/oneblock event time <amount> — 调整剩余时间(例如 5m、30s)
/oneblock event auto — 切换自动事件调度功能
/oneblock bedrock <players> — 为指定玩家重新生成基岩基础层
/oneblock config — 显示当前配置值
/oneblock config reload — 在不重启服务器的情况下重新读取 config/oneblock.json
依赖
- Minecraft 26.1
- Fabric Loader 0.16.0+
- Fabric API
⚠️ 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.
- Install Fabric Loader and drop Fabric API + OneBlock SMP into your
mods/ folder.
- Stop the server, then edit
server.properties: level-type=oneblock:oneblock
- 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.
- 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/:
| Path |
What it controls |
oneblock_phases/*.json |
Block pools, mob spawns, chest intervals, phase thresholds |
shops/*.json |
Vendor stock and prices — stall picks the hub position |
scavenger_items/*.json |
Scavenger Hunt items and their tiers — files are merged |
loot_table/chests/*.json |
Chest loot per phase |
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧