Border Quest
一款适用于 Minecraft 1.21 的 服务端 Fabric 模组,将你的世界边界转化为合作式的进度挑战。
玩家收集资源并将其捐赠给 祭坛,从而逐步解锁不断扩展的世界。
功能
| 功能 |
描述 |
| 渐进式世界边界 |
起始范围较小,随着玩家完成阶段而扩大 |
| 祭坛系统 |
右键点击任意祭坛方块即可捐赠物品 |
| 阶段奖励 |
在阶段完成时,向所有当前阶段的玩家发放物品、药水效果或经验值 |
| 维度锁定 |
下界与末地受可配置的阶段限制 |
| 捐赠排行榜 |
/bq ladder 显示贡献度最高的玩家 |
| 祭坛粒子效果 |
每个祭坛上都会显示 END_ROD 粒子特效 |
| 聊天公告 |
大额捐赠时向全服广播消息 |
| HUD 侧边栏 |
Tab 列表头部显示当前目标 |
| 地图集成 |
支持 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 放入服务器的 mods/ 文件夹中,需与 Fabric API 共存。
- 启动服务器一次 ——
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
{
// 常规设置 -------------------------------------------------------------------
// 阶段完成时庆祝烟花持续的时间(刻,20 = 1秒)
"celebrationDurationTicks": 200,
// 玩家在边界外时每秒受到的伤害
"borderDamagePerBlock": 0.2,
// 显示边界警告的距离(方块数)
"borderWarningBlocks": 5,
// 下界坐标缩放因子(下界边界 = 主世界半径 / netherScale)
"netherScale": 8.0,
// 祭坛粒子效果 -----------------------------------------------------------
"altarParticlesEnabled": true,
// 粒子生成的频率,单位为刻(20 = 每秒一次)
"altarParticlePeriodTicks": 20,
// 捐赠公告 ----------------------------------------------------
// 当单次捐赠达到此数量时,向所有玩家广播消息
"donationAnnouncementsEnabled": true,
"donationAnnounceMinItems": 16,
// 维度锁定 -----------------------------------------------------------
// 阻止玩家进入某个维度,直到达到所需阶段
"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": "", // 留空以使用默认 Webhook 头像
// 阶段设置 --------------------------------------------------------------------
"stages": [
{
"borderRadius": 10,
"title": "清理区域",
// 固定物品需求
"requirements": [
{ "itemId": "minecraft:cobblestone", "count": 64 }
],
// 按生物群系解析的分类(模组会自动选择正确的原木类型)
"categoryRequirements": [
{ "category": "logs", "count": 64 }
],
// 完成时分发给所有在线玩家的奖励
"rewards": []
},
{
"borderRadius": 25,
"title": "迈向文明的第一步",
"requirements": [
{ "itemId": "minecraft:iron_ingot", "count": 32 },
{ "itemId": "minecraft:bread", "count": 32 }
],
"categoryRequirements": [],
"rewards": [
// 给每位在线玩家 3 个面包
{ "type": "item", "itemId": "minecraft:bread", "count": 3 },
// 给予急迫 I 效果,持续 30 秒
{ "type": "effect", "effectId": "minecraft:haste", "duration": 600, "amplifier": 0 },
// 给予 50 点经验值
{ "type": "xp", "amount": 50 }
]
}
// ... 添加任意数量的阶段
// 最后一个阶段代表完全自由(使用 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。
模组会自动渲染:
- 在主世界地图上显示当前边境范围的绿色矩形。
- 每个祭坛的兴趣点标记(如果设置了显示名称则一并显示)。
当 BlueMap 重新加载时,标记会自动重建。
Dynmap
需要在服务器上安装 Dynmap for Fabric。
与 BlueMap 相同的标记 — 通过反射渲染,无需额外依赖。
JourneyMap & Xaero's Minimap / World Map
仅支持单人游戏和局域网。 这些模组仅在客户端运行,无法在专用服务器的类路径中找到。
当在单人游戏或局域网环境下运行时,如果安装了 JourneyMap、Xaero's Minimap 或 Xaero's World Map:
- 注册祭坛时会为其创建一个路标。
- 移除祭坛时也会移除对应的路标。
- 不支持边境形状(受限于客户端地图功能)。
该集成使用反射实现 — 无需额外配置。
Discord 网络钩子 (Webhook)
- 在你的 Discord 服务器中创建网络钩子:频道设置 → 集成 → 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
# 输出: 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 |
none |
通过反射集成 — 无编译依赖 |
许可证
MIT — 见 LICENSE。
Border Quest
A server-side Fabric mod for Minecraft 1.21 that turns your world border into a cooperative progression challenge.
Players collect resources, donate them to altars, and unlock an ever-growing world — stage by stage.
Features
| Feature |
Description |
| Progressive world border |
Starts small and expands as players complete stages |
| Altar system |
Donate items by right-clicking any altar block |
| Stage rewards |
Give items, potion effects or XP to all players on stage completion |
| Dimension locks |
Nether & End are gated behind configurable stages |
| Donation leaderboard |
/bq ladder shows the top contributors |
| Altar particles |
Visual END_ROD particle effect on every altar |
| Chat announcements |
Server-wide broadcast on large donations |
| HUD sidebar |
Tab-list header displays current objective |
| Map integrations |
BlueMap, Dynmap, JourneyMap, Xaero's Minimap & World Map |
| Discord webhook |
Sends a message on every stage completion |
| Fully configurable |
All stages, radii and behaviour tunable via JSON |
Requirements
| Dependency |
Version |
Required? |
| Minecraft |
1.21.x |
✅ |
| Fabric Loader |
≥ 0.14.21 |
✅ |
| Fabric API |
any |
✅ |
| BlueMap |
any |
Optional |
| Dynmap (Fabric) |
any |
Optional |
| JourneyMap |
any |
Optional (singleplayer / LAN) |
| Xaero's Minimap |
any |
Optional (singleplayer / LAN) |
| Xaero's World Map |
any |
Optional (singleplayer / LAN) |
Server-side only. Clients do not need to install this mod.
Installation
- Drop
border-quest-mod-x.x.x.jar into your server's mods/ folder alongside Fabric API.
- Start the server once —
config/borderquest.json is generated automatically.
- Edit the config to suit your server, then run
/bq reload.
Commands
All commands start with /bq (alias available via any registered alias).
Player commands
| Command |
Description |
/bq or /bq status |
Show current stage, objective and progress |
/bq submit |
Donate all eligible items from your inventory |
/bq ladder |
Show the top 10 donors |
Operator commands (permission level 2)
| Command |
Description |
/bq setaltar |
Register the block you are looking at as an altar |
/bq setaltar <name> |
Same, but assigns a display name (shown on maps) |
/bq removealtar |
Remove the looked-at block from the altar list |
/bq skip |
Force-advance to the next stage without filling the objective |
/bq reset |
Reset the game to stage 1 |
/bq reload |
Reload borderquest.json and the saved state without restarting |
To donate, right-click any altar block while holding items.
/bq submit works from anywhere and scans your entire inventory.
Configuration
File location: 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)
]
}
Stage anatomy
| Field |
Type |
Description |
borderRadius |
double |
Half the side length of the square border (diameter = radius × 2) |
title |
string |
Displayed in chat and the tab-list sidebar |
requirements |
list |
Specific items required — itemId + count |
categoryRequirements |
list |
Biome-adaptive requirements — category + count |
rewards |
list |
Rewards given to all online players on stage validation |
Built-in categories: logs, planks, wool, sand, stone — resolved to the most common variants found in the spawn biome.
Reward types
type |
Required fields |
Example |
"item" |
itemId, count |
{ "type": "item", "itemId": "minecraft:diamond", "count": 2 } |
"effect" |
effectId, duration (ticks), amplifier (0 = level I) |
{ "type": "effect", "effectId": "minecraft:speed", "duration": 400, "amplifier": 1 } |
"xp" |
amount |
{ "type": "xp", "amount": 100 } |
Altar setup
Altars can be any block — a beacon, a chest, a custom banner — whatever fits your server's theme.
- Place the block in-world.
- Look at it and run
/bq setaltar (optionally /bq setaltar Altar du Spawn).
- Players can now right-click the block to donate items.
To remove an altar: look at it and run /bq removealtar.
Altar positions are saved in world/data/borderquest_state.json and survive restarts.
Map integrations
BlueMap
Requires BlueMap installed on the server.
The mod automatically renders:
- A green rectangle showing the current border extent on the overworld map.
- A POI marker for each altar (with its display name if set).
Markers rebuild automatically when BlueMap reloads.
Dynmap
Requires Dynmap for Fabric installed on the server.
Same markers as BlueMap — rendered via reflection, no extra dependency needed.
JourneyMap & Xaero's Minimap / World Map
Singleplayer & LAN only. These mods run client-side and are not available on a dedicated server's classpath.
When running in singleplayer or LAN, if JourneyMap, Xaero's Minimap, or Xaero's World Map is installed:
- A waypoint is created for each altar when it is registered.
- The waypoint is removed when the altar is removed.
- Border shapes are not supported (client-side map limitation).
The integration uses reflection — no additional configuration is needed.
Discord webhook
- Create a webhook in your Discord server: Channel Settings → Integrations → Webhooks.
- Copy the URL and paste it in
borderquest.json:
"discordEnabled": true,
"discordWebhookUrl": "https://discord.com/api/webhooks/123456789/abc...",
"discordUsername": "Border Quest",
"discordAvatarUrl": ""
- Run
/bq reload.
A message is sent automatically each time a stage is completed.
Dimension locks
By default:
- The Nether is locked until stage 5.
- The End is locked until stage 7.
Attempting to enter a locked dimension cancels the teleport and displays a red message.
Customise or remove locks in borderquest.json under worldLocks.
Saved state
The game state (current stage, submitted items, altar list, donor stats) is saved in:
<world>/data/borderquest_state.json
Back up this file if you want to preserve progress between map resets.
Building from source
git clone <repo>
cd border-quest-mod
./gradlew build
# Output: build/libs/border-quest-mod-x.x.x.jar
Requirements: Java 21, internet access (to download Fabric Loom and BlueMap API).
Dependencies at a glance:
| Artifact |
Scope |
Purpose |
net.fabricmc.fabric-api |
modImplementation |
Fabric API |
de.bluecolored:bluemap-api:2.7.7 |
compileOnly |
BlueMap markers at compile time |
| Dynmap, JourneyMap, Xaero's |
none |
Integrated via reflection — no compile dependency |
License
MIT — see LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧