ArcQuest

ArcQuest

现代任务框

Arc Quest

Arc Quest 是一个数据驱动的任务、对话及 RPG 内容框架，适用于 Minecraft 整合包、服务器和冒险地图。

它提供了服务器权威的任务运行时、分支对话、NPC 互动、世界标记、商店、扭蛋系统、游戏内指南、完整的任务日志、追踪 HUD、历史图表和可视化编辑工具。

Arc Quest 主要是一个面向内容创建者的框架。
基础模组不包含完整的任务战役。整合包作者、地图制作者和服务器管理员通过 JSON 文件、Web 编辑器或 Java API 创建自己的内容。

主要特性

任务系统

可创建线性、分支、并行、随机、限时、可重复或收集类任务，支持：

  • 多阶段和完成策略
  • 条件和玩家选择转换
  • 随机初始阶段和阶段转换
  • 自动或手动确认的进度推进
  • 任务类别、分组、排序和追踪规则
  • 阶段和任务奖励
  • 可配置的放弃和时限

内置目标包括击杀实体、收集或交付物品、与 NPC 对话、与方块或实体互动、到达位置、合成、献祭物品、布尔检查和自定义目标类型。

条件和变量

使用以下方式控制任务、阶段、对话、选项和标记：

  • 任务和阶段状态
  • 标记和整数变量
  • 玩家等级和状态效果
  • Minecraft 谓词
  • 嵌套的 AND、OR 和 NOT 条件

持久变量使构建派系、隐藏分支、故事决策和长期进度系统成为可能。

任务日志和 HUD

玩家界面包括：

  • 进行中、已完成和失败的任务标签页
  • 类别和分组
  • 追踪任务 HUD
  • 目标进度和奖励预览
  • 新任务和状态通知
  • 章节商店和阶段故事
  • 未读指示器
  • 响应式布局和动画

历史视图通过阶段拓扑图显示玩家的实际路线，包括阶段图片、物品图标、目标、奖励、描述和隐藏的未到达阶段。

分支对话

创建多节点 NPC 对话，支持：

  • 玩家选项和条件可见性
  • 条件文本
  • 冷却时间和实体绑定
  • 对话动作
  • 标记和变量操作
  • 任务进度和标记触发
  • 专用对话 UI

任务和对话可以通过稳定的 ID、条件、变量和动作互相引用。

NPC、交易和扭蛋

Arc Quest 包含数据驱动的模块，支持：

  • 基于实体的 NPC 互动
  • 独立、阶段和章节商店
  • 条件交易可用性
  • 加权扭蛋池
  • 稀有度、权重修正和保底系统

世界标记

任务和对话可以为位置、实体、方块、附近实体类型、结构、阶段和目标创建标记。

标记可由任务接受、阶段变更、目标完成、对话节点、对话选项或持久条件触发。标记状态在死亡、重新登录、维度切换和世界切换时得以保持。

Xaero 集成

可选集成支持：

  • Xaero 的小地图
  • Xaero 的世界地图
  • Arc Quest 菱形样式图标
  • 世界地图悬停提示
  • 小地图图标（无重复的世界信标）

Arc Quest 的原生标记 HUD 无需 Xaero 即可工作。

指南和 Ponder

构建分类教程、游戏指南、任务解锁条目和 Ponder 场景。指南内容也可以通过任务阶段授予。

内容创建

Arc Quest 支持三种创作工作流：

模块化 Web 编辑器

可视化创建和验证任务、阶段、目标、转换、对话、NPC、标记、交易、扭蛋商店和指南。编辑器支持导入、导出、引用验证、规范化和通过 WebSocket 的实时注册表建议。

游戏内任务编辑器

管理员可以通过游戏内的阶段拓扑和属性工作区检查和编辑数据支持的任务。

Java API

插件开发者可以通过公开的构建器、注册表、API 和 NeoForge 事件注册自定义任务、目标、条件、奖励、对话动作、标记目标、类别和其他内容。

安全热重载

Arc Quest 在应用内容之前进行验证。重载包括：

  • 有界文件扫描和 UTF-8 JSON 解析
  • 重复 ID 和跨模块引用检查
  • 警告和阻塞错误报告
  • 不可变候选快照
  • 原子注册表替换
  • 失败后保留先前有效状态
  • 重载纪元日志记录和客户端同步

无效文件会报告其文件路径和字段路径，而不会清除已加载的有效内容。

要求

  • Minecraft： 1.21.1
  • 模组加载器： NeoForge
  • NeoForge： 21.1.234 或兼容的更新版本
  • Java： 21
  • 必需： Ponder 1.0.64+
  • 可选： Xaero 的小地图和 Xaero 的世界地图

所有依赖项必须面向 Minecraft 1.21.1 和 NeoForge。

推荐用于

  • RPG 整合包
  • 故事驱动的冒险地图
  • 多人任务服务器
  • 开放世界进度系统
  • NPC 故事和派系系统
  • 教程和游戏指南
  • 需要可视化内容创作工具的团队

安装

玩家：

  1. 安装 NeoForge 和 Ponder。
  2. 将 Arc Quest 放入 mods 文件夹。
  3. 安装兼容的内容包或加入提供 Arc Quest 内容的服务器。

内容创作者：

  1. 使用 Web 编辑器、JSON 文件或 Java 构建器创建内容。
  2. 将其导出到 Arc Quest 数据目录。
  3. 运行 Arc Quest 重载命令。
  4. 修正报告的任何验证或引用错误。

Arc Quest 提供框架、运行时和界面——而非内置战役。 如果安装后没有出现任务，请验证您的整合包或服务器是否包含 Arc Quest 内容文件。