Border Quest

模组

· 作者 hirochifaa

一个 Minecraft Fabric 模组,它会缩小世界的大小。玩家必须完成目标以逐步扩展它。完全可自定义。

0 本站下载 0 关注 更新于 5 个月前

需要前置:Fabric API

最新 2.1.0 · 26.1.2 · Fabric

一键开服(送7天)

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 任意版本 可选(单人 / 局域网)

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


安装

  1. 将 border-quest-mod-x.x.x.jar 放入服务器的 mods/ 文件夹中,需与 Fabric API 共存。
  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

{
  // 常规设置 -------------------------------------------------------------------

  // 阶段完成时庆祝烟花持续的时间(刻,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 }

祭坛设置

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

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

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

  1. 在你的 Discord 服务器中创建网络钩子:频道设置 → 集成 → 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
# 输出: 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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源