任务者：RPG引擎

⚔️ Questler: 活任务、叙事与 RPG 引擎

Questler 远不止是一本传统的任务书——它是一个完整的叙事、成长与世界构建引擎，专为 Fabric (Minecraft 26.2) 上的整合包作者、冒险服务器服主和地图制作者打造。

直接在游戏内通过精美可视化创作工作室，打造深度分支任务线、互动对话树和活生生的世界演员——无需编写任何代码，也无需重启世界。

---

✨ 核心特性

🎭 活体 NPC 系统与深度叙事

• 物理实体 vs. 借壳 AI：将视觉外观与行为逻辑解耦。任何原版或模组实体（村民、铁傀儡、僵尸、骷髅、自定义生物）都可以作为故事演员，并使用可互换的 AI 预设（被动/对话、守卫、敌对或自定义实体 AI）。
• 动态世界锚点与条件生成：将故事演员锚定到村庄、自定义结构、生物群系、精确坐标，或让它们仅在先决任务完成后动态出现在玩家面前（near_player）。
• 9 种高级生命周期策略：为演员配置条件保护（protected_until）、自动伤亡替换（replaceable / recoverable），或在死亡时动态失败或分支的任务（fail_on_death、branch_on_death）。
• 分支对话树与故事交付：互动对话系统可响应任务进度状态（available、in_progress、completed），并具备完整物品栏扫描功能以支持故事物品交付。
• 人性化保护措施：为亡灵故事演员内置阳光免疫（无需头盔），并锁定村民等级/经验值以防止原版职业重置。

🧭 探索与丰富任务目标

• 位置与探索任务（questler:location）：派遣玩家探索村庄、特定结构、生物群系、维度或精确坐标。包含可配置的发现半径，以及编辑器中的一键 “📍 我的位置” 按钮，可即时捕获作者坐标。
• 多样化原生任务：实体狩猎（kill）、物品/标签收集（item）、NPC 对话（talk_to_actor）、故事交付（deliver_item）、原版进度（advancement）、经验点（xp）以及手动复选框。
• 顺序任务链：要求任务中的多步骤任务必须严格按时间顺序执行。

🛠️ 游戏内可视化创作工作室（零代码）

• 流畅 2D 无限画布：交互式平移和缩放导航、自适应全局取景（F 键缩放适配）、无缝视差平铺背景，以及硬件加速的矢量连线（贝塞尔、直线或正交）。
• 游戏内实时热重载：实时编辑演员、任务、目标和奖励。世界实体将立即更新其名牌、装备、AI 行为和生成状态，无需断开连接或运行 /reload。
• 自定义章节画布图像：将可缩放图表、地图叠加层或游戏内截图直接放置到任务画布上，并完全控制其缩放、旋转、不透明度和工具提示。
• DAG 检查器与沙盒模拟器：内置叙事图可视化工具，支持 DFS 循环检测、损坏依赖诊断、带一键 /tp 按钮的实时演员定位器，以及交互式任务状态模拟器。

🖥️ 玩家体验与响应式 HUD

• 独立固定与固定级联：在画布上右键点击任意任务即可将其固定到你的 HUD。当固定的任务完成并领取后，它会自动取消固定，并级联固定任务链中新解锁的子任务。
• 固定任务标题托盘：点击任务界面标题栏中的任意固定标签，你的镜头将直接飞向该任务，并伴有金色定位信标闪烁。
• 脉冲提醒与可自定义提示：通过脉冲奖励通知和游戏内配置菜单（O 键）调整提示位置、持续时间和 UI 缩放，再也不会错过交付。

🔒 服务器权威与便携架构

• 100% 服务器权威：所有评估、完成和物品交付均由服务器安全管理，并按世界原子化保存（<world>/questler/progress/<uuid>.json），彻底消除客户端不同步和作弊行为。
• 单文件便携包（.questler.zip）：导出和导入完整战役，包含规范 JSON、自定义捆绑图像、版本化清单和 SHA-256 完整性校验。
• 容错草稿自动保存：创建和保存进行中的战役与演员，不会被严格的依赖验证错误所阻塞。

---

⌨️ 实用命令

• /questler — 打开主 Questler 书（也绑定到 < / 可在控制中重新绑定）。
• /questler config — 打开客户端设置与 HUD 叠加布局（或按 O 键）。
• /questler locate <actor_id> — 显示叙事演员的实时世界坐标以及可点击的 /tp 链接。
• /questler reload — 安全重载战役、章节和数据配置。
• /questler export <campaign_id> — 将战役打包为便携的 .questler.zip 文件。
• /questler progress <player> (reset|complete) [campaign_id] — 管理性进度管理。

---

📦 需求与兼容性

• 平台： Fabric
• Minecraft 版本： 26.2
• Java 版本： Java 25 LTS
• 必需依赖： Fabric API