边境远征

边境远征

一个缩小世界大小的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 任意 可选(单人 / 局域网)

仅服务端安装。 客户端无需安装此模组。


安装

  1. 将 border-quest-mod-x.x.x.jar 与 Fabric API 一起放入服务器的 mods/ 文件夹。
  2. 启动服务器一次 — config/borderquest.json 会自动生成。
  3. 根据你的服务器需求编辑配置,然后运行 /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 }

祭坛设置

祭坛可以是任意方块 — 信标、箱子、自定义旗帜 — 任何符合你服务器主题的方块。

  1. 在世界中放置该方块。
  2. 注视它并运行 /bq setaltar(可选 /bq setaltar Altar du Spawn)。
  3. 玩家现在可以右键点击该方块来捐赠物品。

要移除祭坛:注视它并运行 /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

  1. 在你的 Discord 服务器中创建一个 Webhook:频道设置 → 集成 → Webhooks。
  2. 复制 URL 并粘贴到 borderquest.json 中:
    "discordEnabled": true,
    "discordWebhookUrl": "https://discord.com/api/webhooks/123456789/abc...",
    "discordUsername": "Border Quest",
    "discordAvatarUrl": ""
    
  3. 运行 /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。