JustQuests

注意

插件版本仅适用于 Paper 服务端

JustQuests

一个面向 NeoForge、Fabric 和 Forge 的轻量任务书——以及面向 Paper、Spigot 和 Purpur 的服务端插件。
没有臃肿的 GUI，没有沉重的依赖——数据包驱动的任务、游戏内任务书、轮换的生成任务板、团队任务和少量命令。一个专注、对服务端友好的 FTB Quests 和 HQM 替代品。

43 个模组构建，覆盖 NeoForge、Fabric 和 Forge 的 Minecraft 1.18.2 – 26.3，外加一个面向 Spigot、Paper 和 Purpur 1.19 – 26.3 的服务端插件，可与原版客户端配合使用。单人游戏和服务器皆可。

✨ 特性

• 📖 任务书——按下 J 浏览任务、查看进度条，并一键接受、放弃或领取。按分类或状态分组，每个任务都有像素图标，还有搜索栏和统计页面。
• 📍 任务追踪器——将你固定的（或最新的）任务及其目标显示在屏幕一角。H 可开启或关闭它，任务书中的按钮可将其移动到另一个角落。
• 🎁 领取奖励——完成的任务会连同奖励一起等待你领取：在任务书中、通过聊天栏按钮或使用 /quest claim。任务可以提供奖励选择——领取时由你挑选一个。想要旧方式的服务端主可切换为即时奖励。
• 👥 团队任务——标记为"team": true的任务属于整个团队：任何人接受它，所有人的行动都计入，每位成员都能获得奖励——包括离线成员。使用 /quest team 创建团队，或使用你的计分板团队（/team）。
• 🎒 开箱即玩——25 个内置任务。服务端主可用 /quest mainquests off 隐藏它们。
• 🎲 生成任务——每 12 小时刷新一次任务板。每个任务都会经过检查，确保在你的版本和模组组合下可完成，规模对应合理的游玩时长，并配有合适的奖励：采集、挖掘、合成、狩猎、附魔、酿造等。下界和末地任务会在玩家到访后出现。三种难度等级。
• 🧩 模组支持——安装 Farmer’s Delight、Create、Mekanism、The Twilight Forest、Botania、Applied Energistics 2、Immersive Engineering、Biomes O’ Plenty、Alex’s Mobs、Tinkers’ Construct 或 Ars Nouveau 后，任务板也会提供对应内容的任务。
• 🏁 先到先得——在服务器上，被某人接受的生成任务即被占用。任务书会显示Taken by Steve或Reserved for you。
• 🌍 五种语言——任务书、所有聊天消息、内置任务和生成任务均提供英语、德语、法语、西班牙语和日语。每位玩家以自己游戏的语言阅读。
• ✍️ 编写你自己的任务——在数据包中，或在每个世界独立的 custom-quests.json 中编写，编辑时会自动重载。15 种目标类型、8 种奖励类型、物品标签和物品过滤器（附魔、药水、名称）。
• 🔐 权限——LuckPerms 等权限插件可为每条命令获取权限节点，任务也可限制为拥有某权限的玩家。
• 🔗 任务逻辑——前置条件和任务链、带冷却的可重复任务、“全部”或“任意”目标、分类。
• 🛠️ 面向服务端主——完成广播、统计和排行榜、管理员命令、自检以及每个世界独立的 settings.json。

🖥️ 服务端插件（Spigot、Paper、Purpur）

在插件服务端上体验相同的任务——玩家使用原版客户端加入，无需安装任何东西。

• 任务书采用箱子菜单形式——新玩家会获得一本任务书物品；右键点击它或输入/quest。进度追踪器是一个Boss栏。
• 任务内容不变——内置任务、数据包任务、custom-quests.json，以及所有目标和奖励类型、领取奖励、奖励选项、团队任务、权限和五种语言。
• 更强大的服务器任务生成器——任务板会随玩家人数增加而扩展；为每位玩家生成个人每日任务，设置难度更高的每周任务，以及每周服务器目标，让所有人共同完成，并为每位参与者发放相同奖励。奖励包含三选一、幸运奖励、连续完成奖励，以及通过经济插件发放的金钱。
• 额外功能——用无害烟花发布公告、设置任务发布者（/quest npc set：村民或盔甲架可打开任务书），以及用于计分板和玩家列表的PlaceholderAPI占位符。
• 从模组迁移——在模组中游玩的世界可在插件服务器上保留进度、自定义任务和团队。

根据服务器版本选择对应的 JAR 文件：

• JustQuests-plugin-1.19——Minecraft 1.19 – 1.20.6（Java 17+）
• JustQuests-plugin-1.21——Minecraft 1.21 – 1.21.11（Java 21+）
• JustQuests-plugin-26.1——Minecraft 26.1 – 26.3（Java 25）

🧩 目标与奖励

目标：

• collect_item – 拾取物品（采矿、收获、怪物掉落）
• craft_item – 合成物品（使用工作台或切石机）
• smelt_item – 从熔炉中取出物品
• consume_item – 吃下或喝下物品
• enchant_item – 在附魔台为物品附魔
• use_item – 使用物品（投掷、放置、应用……）
• mine_block – 破坏方块
• place_block – 放置方块
• kill_mob – 击败生物
• tame_animal – 驯服动物
• breed_animal – 繁殖动物
• reach_level – 达到指定经验等级
• reach_location – 抵达指定位置
• visit_dimension – 进入维度（原版或模组添加的维度）
• gain_advancement – 获得进度

物品、方块和生物可使用 ID（minecraft:oak_log）或标签（#minecraft:logs）进行筛选；物品还可以按附魔、药水效果或名称筛选。

奖励：

• give_item – 交付物品
• loot_table – 掷取战利品表
• xp – 经验值
• effect – 药水效果
• message – 聊天消息（按语言显示）
• title – 大型屏幕标题
• command – 为玩家执行任意命令（替换{player}）——可用于发放经济奖励等，无需硬性依赖
• choice – 玩家从多种奖励中任选一种

🎮 命令

• /quest list [category] – 所有任务，按类别分组
• /quest accept <id> / /quest abandon <id> – 开始或放弃任务
• /quest progress – 查看进行中的任务
• /quest claim [id] – 领取已完成任务的奖励
• /quest team [create|invite|accept|leave|kick] – 查看团队任务中的队伍
• /quest stats / /quest leaderboard – 查看个人统计数据 / 服务器前十名
• /quest discord – 获取社区 Discord 邀请链接

管理员：

• /quest reload– 重新加载自定义任务和设置
• /quest mainquests on|off – 显示或隐藏内置任务
• /quest difficulty [easy|normal|hard] – 生成任务的难度
• /quest reroll – 立即生成一块新的任务板
• /quest generator status|stats|preview|explain|release – 检查生成器、释放已被接取的任务
• /quest admin view|reset|complete <player> – 管理玩家的进度
• /quest test – 运行自检并生成诊断报告

该插件新增了 /quest track、/quest bossbar、/quest book、/quest goal 和 /quest npc。

✍️ 自定义任务

首次启动时，JustQuests 会创建 <world>/justquests/custom-quests.json，其中附有说明示例和空白项。保存文件后，几秒内就能在游戏中看到你的任务——无需重启。同 ID 的自定义任务会覆盖数据包任务。

标题和描述可以是普通字符串，也可以是按语言区分的映射：

"title": { "en_us": "Mining Trip", "de_de": "Bergbau-Ausflug" }

GitHub 上提供了一个完整的 示例数据包，其中每种目标和奖励类型都包含一个任务；README 则详细说明了所有字段和设置。

📥 安装

模组：

1. 为你的 Minecraft 版本安装 NeoForge、Fabric（以及 Fabric API）或 Forge。
2. 将适用于你的加载器和确切游戏版本的 jar 文件（文件名会注明对应信息，例如 JustQuests-fabric-1.21.1-0.4.0.jar）放入你的 mods 文件夹。
3. 启动游戏后按 J，或运行 /quest list。

服务器端和客户端都要安装此模组。

插件：将适用于服务器版本的插件 jar 文件放入 plugins/，然后启动服务器。玩家无需安装任何内容。

✅ 兼容性

• NeoForge：1.20.4、1.20.6、1.21–1.21.11、26.1.2、26.2
• Fabric （需要 Fabric API）：1.18.2、1.19.2、1.19.4、1.20.1、1.20.4、1.20.6、1.21–1.21.11、26.1–26.3
• Forge：1.18.2、1.19.2、1.19.4、1.20.1
• Spigot / Paper / Purpur（插件）：1.19–1.21.11、26.1–26.3
• 任务书适用于 1.20.1 及更新版本。1.18 和 1.19 仅支持命令操作——任务、追踪和奖励的功能都相同。
• Minecraft 26.x 需要 Java 25。

💬 社区

加入 JustQuests Discord，获取支持、更新消息和抢先预览——也可以在游戏中运行 /quest discord。欢迎通过问题追踪器或 Discord 提交 Bug 报告和建议。

📄 许可协议

本项目依据 GNU LGPL v3 发布。可免费用于任何整合包，无需许可。修改后的版本必须继续以相同许可证开源。

源代码与问题反馈： https://github.com/ErikEdits/JustQuests