
边境远征
一个缩小世界大小的Minecraft Fabric模组。玩家必须完成目标来逐步扩展它。完全可自定义。
查看大图Border Quest
一个用于 Minecraft 1.21 的 服务端 Fabric 模组,将你的世界边界转变为一项合作推进挑战。 玩家收集资源,将它们捐赠给 祭坛,并逐阶段解锁一个不断扩展的世界。
特性
| 特性 | 描述 |
|---|---|
| 渐进式世界边界 | 从小范围开始,随着玩家完成阶段而扩展 |
| 祭坛系统 | 右键点击任意祭坛方块即可捐赠物品 |
| 阶段奖励 | 阶段完成时向所有玩家给予物品、药水效果或经验 |
| 维度锁定 | 下界与末地需要通过可配置的阶段解锁 |
| 捐赠排行榜 | /bq ladder 显示贡献最多的玩家 |
| 祭坛粒子 | 每个祭坛上显示 END_ROD 粒子效果 |
| 聊天公告 | 大额捐赠时向全服广播 |
| HUD 侧边栏 | 标签列表标题显示当前目标 |
| 地图集成 | BlueMap、Dynmap、JourneyMap、Xaero's Minimap 与 World Map |
| Discord Webhook | 每次阶段完成时发送消息 |
| 完全可配置 | 所有阶段、半径与行为均可通过 JSON 调整 |
依赖要求
| 依赖 | 版本 | 是否必需? |
|---|---|---|
| Minecraft | 1.21.x | ✅ |
| Fabric Loader | ≥ 0.14.21 | ✅ |
| Fabric API | 任意 | ✅ |
| BlueMap | 任意 | 可选 |
| Dynmap (Fabric) | 任意 | 可选 |
| JourneyMap | 任意 | 可选(单人 / 局域网) |
| Xaero's Minimap | 任意 | 可选(单人 / 局域网) |
| Xaero's World Map | 任意 | 可选(单人 / 局域网) |
仅服务端安装。 客户端无需安装此模组。
安装
- 将
border-quest-mod-x.x.x.jar与 Fabric API 一起放入服务器的mods/文件夹。 - 启动服务器一次 —
config/borderquest.json会自动生成。 - 根据你的服务器需求编辑配置,然后运行
/bq reload。
命令
所有命令均以 /bq 开头(可通过任意已注册的别名使用)。
玩家命令
| 命令 | 描述 |
|---|---|
/bq 或 /bq status |
显示当前阶段、目标与进度 |
/bq submit |
捐赠背包中所有符合条件的物品 |
/bq ladder |
显示前 10 名捐赠者 |
管理员命令(权限等级 2)
| 命令 | 描述 |
|---|---|
/bq setaltar |
将你正在注视的方块注册为祭坛 |
/bq setaltar <name> |
同上,但分配一个显示名称(显示在地图上) |
/bq removealtar |
将正在注视的方块从祭坛列表中移除 |
/bq skip |
强制推进到下一阶段,无需完成目标 |
/bq reset |
将游戏重置回第 1 阶段 |
/bq reload |
重新加载 borderquest.json 与保存的状态,无需重启 |
要捐赠,手持物品右键点击任意祭坛方块。
/bq submit可在任意位置使用,并扫描你的整个背包。
配置
文件位置:config/borderquest.json
{
// General -------------------------------------------------------------------
// Duration of the celebration fireworks on stage completion (ticks, 20 = 1s)
"celebrationDurationTicks": 200,
// Damage per second while a player is outside the border
"borderDamagePerBlock": 0.2,
// Distance (blocks) at which the border warning is shown
"borderWarningBlocks": 5,
// Nether coordinate scale factor (Nether border = Overworld radius / netherScale)
"netherScale": 8.0,
// Altar particles -----------------------------------------------------------
"altarParticlesEnabled": true,
// How often particles spawn, in ticks (20 = once per second)
"altarParticlePeriodTicks": 20,
// Donation announcements ----------------------------------------------------
// Broadcast a message to all players when a single donation reaches this count
"donationAnnouncementsEnabled": true,
"donationAnnounceMinItems": 16,
// Dimension locks -----------------------------------------------------------
// Prevent players from entering a dimension until the required stage is reached
"worldLocks": [
{ "worldId": "minecraft:the_nether", "requiredStage": 5 },
{ "worldId": "minecraft:the_end", "requiredStage": 7 }
],
// Discord webhook -----------------------------------------------------------
"discordEnabled": false,
"discordWebhookUrl": "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN",
"discordUsername": "Border Quest",
"discordAvatarUrl": "", // Leave empty to use the default webhook avatar
// Stages --------------------------------------------------------------------
"stages": [
{
"borderRadius": 10,
"title": "Clear the area",
// Fixed items required
"requirements": [
{ "itemId": "minecraft:cobblestone", "count": 64 }
],
// Biome-resolved categories (the mod picks the right log type automatically)
"categoryRequirements": [
{ "category": "logs", "count": 64 }
],
// Rewards distributed to ALL online players on completion
"rewards": []
},
{
"borderRadius": 25,
"title": "First steps toward civilisation",
"requirements": [
{ "itemId": "minecraft:iron_ingot", "count": 32 },
{ "itemId": "minecraft:bread", "count": 32 }
],
"categoryRequirements": [],
"rewards": [
// Give 3 bread to every online player
{ "type": "item", "itemId": "minecraft:bread", "count": 3 },
// Apply Haste I for 30 s
{ "type": "effect", "effectId": "minecraft:haste", "duration": 600, "amplifier": 0 },
// Give 50 XP points
{ "type": "xp", "amount": 50 }
]
}
// ... add as many stages as you like
// The LAST stage represents total freedom (use borderRadius: 29999984)
]
}
阶段结构
| 字段 | 类型 | 描述 |
|---|---|---|
borderRadius |
double | 方形边界边长的一半(直径 = 半径 × 2) |
title |
string | 显示在聊天与标签列表侧边栏中 |
requirements |
list | 需要的特定物品 — itemId + count |
categoryRequirements |
list | 生物群系自适应需求 — category + count |
rewards |
list | 阶段验证完成时给予所有在线玩家的奖励 |
内置类别:logs、planks、wool、sand、stone — 会解析为出生点生物群系中最常见的变种。
奖励类型
type |
必需字段 | 示例 |
|---|---|---|
"item" |
itemId、count |
{ "type": "item", "itemId": "minecraft:diamond", "count": 2 } |
"effect" |
effectId、duration(刻)、amplifier(0 = I 级) |
{ "type": "effect", "effectId": "minecraft:speed", "duration": 400, "amplifier": 1 } |
"xp" |
amount |
{ "type": "xp", "amount": 100 } |
祭坛设置
祭坛可以是任意方块 — 信标、箱子、自定义旗帜 — 任何符合你服务器主题的方块。
- 在世界中放置该方块。
- 注视它并运行
/bq setaltar(可选/bq setaltar Altar du Spawn)。 - 玩家现在可以右键点击该方块来捐赠物品。
要移除祭坛:注视它并运行 /bq removealtar。
祭坛位置保存在
world/data/borderquest_state.json中,重启后仍然保留。
地图集成
BlueMap
需要在服务器上安装 BlueMap。 模组会自动渲染:
- 在主世界地图上显示当前边界范围的绿色矩形。
- 每个祭坛的 POI 标记(如果设置了显示名称则显示名称)。
BlueMap 重新加载时标记会自动重建。
Dynmap
需要在服务器上安装 Dynmap for Fabric。 与 BlueMap 相同的标记 — 通过反射渲染,无需额外依赖。
JourneyMap 与 Xaero's Minimap / World Map
仅限单人与局域网。 这些模组运行在客户端,无法在专用服务器的类路径中使用。
在单人游戏或局域网中运行时,如果安装了 JourneyMap、Xaero's Minimap 或 Xaero's World Map:
- 每个祭坛注册时会创建一个路径点。
- 祭坛移除时路径点也会被移除。
- 不支持边界形状(客户端地图限制)。
该集成使用反射 — 无需额外配置。
Discord Webhook
- 在你的 Discord 服务器中创建一个 Webhook:频道设置 → 集成 → Webhooks。
- 复制 URL 并粘贴到
borderquest.json中:"discordEnabled": true, "discordWebhookUrl": "https://discord.com/api/webhooks/123456789/abc...", "discordUsername": "Border Quest", "discordAvatarUrl": "" - 运行
/bq reload。
每次阶段完成时会自动发送一条消息。
维度锁定
默认情况下:
- 下界在第 5 阶段前锁定。
- 末地在第 7 阶段前锁定。
尝试进入锁定的维度会取消传送并显示一条红色消息。
可在 borderquest.json 的 worldLocks 下自定义或移除锁定。
保存的状态
游戏状态(当前阶段、已提交物品、祭坛列表、捐赠者统计)保存在:
<world>/data/borderquest_state.json
如果你想在地图重置之间保留进度,请备份此文件。
从源码构建
git clone <repo>
cd border-quest-mod
./gradlew build
# Output: build/libs/border-quest-mod-x.x.x.jar
要求: Java 21、网络访问(用于下载 Fabric Loom 与 BlueMap API)。
依赖一览:
| 构件 | 作用域 | 用途 |
|---|---|---|
net.fabricmc.fabric-api |
modImplementation |
Fabric API |
de.bluecolored:bluemap-api:2.7.7 |
compileOnly |
编译时 BlueMap 标记 |
| Dynmap、JourneyMap、Xaero's | 无 | 通过反射集成 — 无编译依赖 |
许可证
MIT — 见 LICENSE。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。