JustQuests

JustQuests

轻量级、数据包驱动的任务手册，用于 NeoForge。没有GUI冗余，没有复杂的依赖——只有任务。

冒险

JustQuests预览查看大图

JustQuests

一个轻量级的任务书模组，支持 NeoForge、Fabric 和 Forge。 没有臃肿的 GUI，没有沉重的依赖——只有任务和少量命令。 作为 FTB Quests 和 HQM 的专注、服务器友好的替代方案而构建，适用于那些想要任务系统但又不希望过于沉重的整合包。

现已支持三种加载器——NeoForge、Fabric 和 Forge——涵盖 Minecraft 1.18 – 1.21。在 1.20.1 及更新版本中有游戏内任务书（按 J 键）；较旧版本仅支持命令。支持单人游戏和服务器。

GUI 是一个早期的、临时的版本——最终设计正在由社区 Discord 投票 决定。欢迎来投票！

💬 加入社区——帮助我们塑造 GUI

大型游戏内 GUI 正在由社区设计：其风格、布局和功能将由 Discord 上的投票决定。投票的人越多，每个人得到的 GUI 就越好。

👉 加入 JustQuests Discord 来：

  • 🗳️ 用于即将推出的 GUI 投票——风格、布局以及哪些功能优先实现
  • 🛟 获取支持、报告错误并关注更新消息
  • 👀 在发布前查看预览并尝试早期构建版本

在游戏中，你可以随时运行 /quest discord 来获取邀请链接。

✨ JustQuests 的功能

  • 游戏内任务书 (GUI)——按 J 键浏览任务、跟踪目标进度，并一键接受（早期/临时版本，目前仅限单人游戏，适用于 MC 1.20.1+）。完整的 /quest 命令集在所有地方都可用。
  • 即开即玩——自带内置的任务进度，无需任何设置即可立即开始。
  • 轻量级——小巧快速，没有沉重的依赖。
  • 创建你自己的任务——将它们放入一个简单的、每个世界一个的 JSON 文件或数据包中。无需重启：该文件会在你编辑时自动重新加载。
  • 说玩家的语言——任务文本可以用多种语言编写，物品/生物/方块名称会自动为每位玩家进行翻译（1.20.2+ 版本为每位玩家独立语言；旧版本为英文）。
  • 进度可持久化——按世界保存，跨游戏会话和死亡保持不变。
  • 对服务器友好——在服务端运行，按世界存储；不会干扰其他模组和 UI 改造。

🧩 目标与奖励类型

任务由以下目标构成——你可以混合搭配，并选择任务是需要所有目标还是只需要任意一个：

  • collect_item – 收集物品（采矿、收获、生物掉落）
  • mine_block – 破坏某种类型的方块
  • craft_item – 合成指定的物品
  • smelt_item – 在熔炉中熔炼物品
  • consume_item – 食用或饮用物品
  • place_block – 放置方块
  • kill_mob – 击败某种类型的实体
  • tame_animal – 驯服动物
  • breed_animal – 繁殖某种类型的动物
  • reach_level – 达到某个经验等级
  • reach_location – 到达某个位置（可选择在特定维度中）
  • visit_dimension – 进入某个维度（原版或模组维度，按 ID 识别）
  • gain_advancement – 获得某个进度

物品目标接受单个 ID (minecraft:oak_log)、一个列表或一个标签 (#minecraft:logs)。

奖励：

  • give_item – 给予物品
  • loot_table – 从战利品表中随机抽取奖励
  • xp – 给予经验值
  • effect – 施加药水效果
  • message – 向玩家发送一条消息（支持多语言）
  • command – 以玩家身份运行任何命令（{player} 会被替换）—— 涵盖经济奖励、效果等，没有硬性依赖

任务逻辑： 任务可以要求先完成其他任务（requires → 连锁任务，解锁前显示为锁定状态），并且可以设置可重复完成，带有可选的冷却时间（例如每日任务）。

🎮 命令

命令 功能
/quest list [category] 列出所有任务（按类别分组），或只列出一个类别
/quest categories 列出类别以及每个类别中的任务数量
/quest stats 你的个人统计（完成百分比、按类别、日期）
/quest leaderboard 服务器上完成任务数排名前 10 的玩家
/quest accept <id> 开始一个任务（支持 Tab 补全）
/quest progress 显示你当前活跃的任务以及完成进度
/quest abandon <id> 放弃一个活跃的任务（会提示你当前活跃的任务）
/quest discord 获取社区 Discord 邀请链接（快来为 GUI 投票吧！）
/quest reload (管理员) 重新加载自定义任务
/quest test (管理员) 运行自检并写入诊断报告
/quest admin view|reset|complete <player> (管理员) 管理玩家的任务进度

服务器管理员： 任务完成默认会向所有人公告（可在 <world>/justquests/settings.json 中切换）。

任务 ID 支持 Tab 补全——accept 会提示所有可用的任务，abandon 只会提示你已接受的任务。

✍️ 自定义任务

首次启动时，JustQuests 会在你的世界文件夹（<world>/justquests/）中写入一个 custom-quests.json 文件，其中包含一个附有说明的示例和空白的填写槽。保存该文件后，你的任务会在几秒钟内出现在游戏中——无需重启。自定义任务会覆盖具有相同 ID 的数据包任务。

任务标题和描述可以是纯文本字符串：

"title": "采矿之旅",
"description": "挖掘 20 个铁矿石。"

……或者一个按语言代码 (en_us, de_de, fr_fr, …) 键控的多语言映射，这样单个任务就能正确显示给所有人：

"title": { "en_us": "Mining Trip", "de_de": "<German title here>" },
"description": { "en_us": "Mine 20 iron ore.", "de_de": "<German text here>" }

每位玩家会看到自己客户端的语言，如果找不到对应语言则回退到英文。

📦 内置任务

JustQuests 自带25 个可立即游玩的任务，涵盖多个类别（采集、农耕、战斗、建筑、合成、探索、挑战、生存、每日）——每个任务均已内置英文、德文、法文和西班牙文文本，因此你可以立即开始游玩。示例：

任务 目标 奖励
第一步 16 个橡木原木 4 个面包
石器时代 32 个圆石 16 个火把，石镐
采矿大师 挖掘 64 个石头 铁镐
家园建设者 放置 64 个橡木木板 16 个火把
动物朋友 驯服一只狼 16 根骨头
进入下界 进入下界 4 个黑曜石
升级 达到 20 级经验等级 经验 + 力量效果
探矿者 挖掘 3 个钻石矿石 神秘战利品
每日面包 吃 3 个面包（可重复，冷却 24 小时） 绿宝石
……还有 16 个更多

温馨提示： collect_item 统计的是捡起的物品（采矿、收获、生物掉落）。要统计玩家制作的物品，请使用 craft_item。

想要创建你自己的任务？ GitHub 上提供了一个完整的示例数据包，其中包含每种目标和奖励类型的示例任务。

📥 安装

  1. 根据你的 Minecraft 版本安装对应的加载器：NeoForge、Fabric (+ Fabric API) 或 Forge。
  2. 下载与你的加载器和版本相匹配的 JustQuests jar 文件——文件名会说明一切，例如 JustQuests-fabric-1.20.1-0.2.1.jar 或 JustQuests-neoforge-1.21.1-0.2.1.jar——并将其放入你的 mods 文件夹。
  3. 启动游戏，按 J 键打开任务书（1.20.1+ 版本）或运行 /quest list。

✅ 兼容性

为你的加载器和确切的 Minecraft 版本选择相应的 jar 文件：

  • NeoForge: 1.20.4, 1.20.6, 以及 1.21 – 1.21.10

  • 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.10

  • Forge: 1.18.2, 1.19.2, 1.19.4, 1.20.1

  • 环境： 单人游戏和服务器（在服务端运行）

  • GUI： 适用于 1.20.1 及更新版本；1.18/1.19 仅支持命令（完整的 /quest 命令集和所有任务追踪功能仍然有效）

为什么存在版本缺口？ NeoForge 仅从 1.20.2 开始存在，因此 1.18–1.20.1 由 Fabric/Forge 覆盖。Forge 和 NeoForge 在 1.20.1 处分道扬镳，因此 1.20.2+ 由 NeoForge（和 Fabric）提供服务，而不是在 Forge 上重复。

🗺️ 路线图

JustQuests 是逐步构建的。已发布的功能：一套深入的目标和奖励类型、物品标签、任务模式和类别、支持实时重载的每世界自定义任务、多语言任务文本，以及现在NeoForge、Fabric 和 Forge 对 1.18–1.21 版本的支持。

下一步计划：

  • 最终 GUI 设计：由 Discord 社区投票从 3 个概念图中选出，包含精美的纹理、领取按钮、选择奖励、可选的 HUD 追踪器——以及多人游戏支持（当前的 GUI 仅限单人游戏）
  • 服务器及生活质量改进：难度设置和权限控制
  • 自动任务生成器：轮换的、基于注册表的自动生成任务
  • 更广泛的覆盖：Paper/Bukkit 插件版本

反馈决定了优先级——欢迎在问题追踪器上提交错误报告和建议。

📄 许可证

基于 GNU LGPL v3 协议发布。可在任何整合包中免费使用，无需获得许可。修改版本和分支必须在同一许可证下保持开源。

💬 社区与 GUI 投票： https://discord.gg/cMTGE9QCja 源代码与问题跟踪： https://github.com/ErikEdits/JustQuests