为 Roguelite 添加任务编辑器,无需重写单局循环

用 AI 为现有 Roguelite RPG 添加自定义任务编辑器,并在审查改动时确认游戏仍可反复开局,永久解锁也能正常保留。

Seele Editorial Team更新于 2026年11月16日

任务编辑器可以为 Roguelite RPG 增加值得反复挑战的目标,但不应演变成第二套任务系统。让创作者配置游戏已支持的目标和奖励,由现有的单局循环决定如何推进目标,以及如何发放永久解锁。

一名虚构的冒险者带着任务令牌走进路线分岔的灰玻璃档案馆,准备开启一场可反复游玩的冒险。
灰玻璃档案馆是用来解释任务数据的虚构场景,并非经过实测的一局游戏。

本文用虚构的地牢和奖励来说明具体该做哪些决定。文中没有实际制作或测试任何编辑器、项目或单局流程。请 AI 修改代码之前,先梳理现有内置任务是如何定义、加载、推进和结算的。

将任务编辑与执行分开

从游戏已经实现的目标类型入手,例如击败已有的敌人群组、收集现有道具、前往指定地点,或完成一场已有的遭遇战。第一版编辑器应支持配置这些现有内容,避免引入新的脚本语言或可任意定义的事件系统。每增加一种目标类型,都要扩展任务执行器,并扩大测试范围。

将任务定义为具有稳定标识的内容数据。假设有一个名为“寻找档案馆印章”的任务,它可以引用一个已有的房间 ID、一种已支持的交互和一个奖励 ID。当前局的状态记录目标是否完成,跨局养成系统则在本局结算后保存解锁状态。两者相互关联,但各自有独立的记录。

稳定 ID 比显示名称更可靠。即使任务标题改名或被翻译,数据键仍可使用“archive_seal_01”。编辑器可以显示易读的名称,任务执行器则应引用游戏现有的房间、敌人、道具和奖励标识符。

以现有任务执行器为准

追踪一个内置任务的完整流程,从选中任务到更新目标进度、结算奖励,再到触发可能的解锁。找出哪个组件负责单局状态,哪个组件负责写入持久进度。先请 AI 梳理这条路径,再让它编辑代码。请它给出简短的改动计划,并列出预计会修改的文件。

让编辑器专注于内容编辑。它可以保存或选取任务定义,再将定义传给现有的开局入口。避免把目标计数、奖励代码或解锁逻辑复制到编辑器界面里,否则自定义任务和内置任务的行为可能不一致。

选择适合项目的任务数据格式。Godot 文档介绍了可在 Inspector 中编辑并序列化的自定义 Resources。Unity 6.1 文档将 ScriptableObject 描述为独立于类实例的数据容器。这些文档介绍了项目数据的可选方案。实际的内容处理流程、版本管理和打包规则应沿用现有代码库的做法。

一份简短的任务定义带有目标标记和奖励,并接入现有的 Roguelite 单局流程。
数据流示意图展示了编辑器如何定义任务,以及现有任务执行器如何执行任务。

将单局进度与永久解锁分开

Roguelite 的结构让状态边界尤为重要。一局结束时,任务目标可以重置,永久解锁则会保留。需要明确目标能否在不同房间里分步完成、失败的一局是否会发放任何奖励,以及奖励是即时发放,还是等本局返回据点后再发放。

记录示例有效期
任务定义目标类型、目标 ID、奖励 ID对应的内容版本
单局进度当前计数和已完成的目标限于一次远征,支持续玩时可在恢复后继续
单局结果成功、失败、放弃在本局结束时结算一次
跨局进度永久解锁档案馆的访问权限跨局保留,重新加载玩家档案后仍然有效

为单局结果指定一个结算时点。重试或重新加载场景时,同一项解锁只能发放一次。如果任务会随游戏版本而变化,请记录内容版本,或明确如何处理已停用的 ID。测试旧存档时使用副本,以免覆盖唯一的原件。

在玩家开局前验证任务

提前验证可以发现有问题的内容,避免玩家进入游戏后遇到难以理解的情况。检查任务 ID 是否唯一、目标类型是否受支持、目标是否存在、数量和阈值是否在允许范围内,以及奖励是否为已知项。如果任务要求按顺序经过多个房间,请按游戏实际使用的地图规则确认所引用的目标可以到达。

提供具体到字段、能指导修正的提示。“目标 2 引用了未知的房间 ID”比“任务失败”更容易排查。如果任务无法完成、奖励重复,或者目标不会出现在所选地牢的生成池中,就应发出提示。不要悄悄替换为默认目标,否则任务看似能正常运行,实际却要求玩家完成错误的目标。

区分会阻止开局的错误和需要设计者判断的警告。目标缺失应阻止开局。路线较短或奖励偏低可以作为警告,由设计者通过试玩来判断。验证可以检查任务结构,但无法证明任务在各种程序生成的布局中都好玩、公平或平衡。

在远征开始前,这条虚构的档案馆路线将每个任务目标与一个可到达的房间关联起来。
图中路线仅作示意。实际任务需要结合项目的地图生成器进行验证。

请 AI 先做一项范围小、可回退的改动

向 AI 助手明确要求:为一种现有任务类型添加编辑器,保留现有的单局循环、程序生成、战斗、奖励规则和跨局解锁流程,在开局前验证目标,并列出修改的文件、数据迁移和回退步骤。请它复用现有的目标和奖励接口。

审查补丁时,检查是否重复实现了任务执行逻辑、新增存档字段是否缺少默认值、仅供编辑器使用的资源是否被带入运行时,以及写入内容时是否会覆盖内置定义。保留一个已知可正常运行的任务作为回归测试样例。让内置任务和自定义任务经过同一套开局、推进和结算流程,再比较两者的表现。

通过多次开局测试任务流程

以下是建议执行的检查,并非虚构档案馆的实测结果。

测试用例操作验证项
内置任务对照游玩一个现有任务原有的单局流程和奖励行为保持正常
有效的自定义任务启动一个使用已知目标的任务现有任务执行器会更新目标进度
无效目标使用一个引用了不存在的 ID、用完即可丢弃的测试任务验证会阻止开局,并指出有问题的字段
单局失败在目标完成前结束本局失败时按已明确记录的规则处理奖励
重复结算在安全的条件下重放同一个结束事件跨局解锁或奖励不会重复发放
旧版内容或存档加载一份旧版本的副本未知的任务 ID 会被迁移,或有提示说明原因

记录游戏版本、内容版本、任务 ID、单局随机种子(如有)、操作步骤、预期结果和实际结果。除了编辑器预览,也要测试常规构建版本。示意路线能说明设计思路,但无法证明程序生成的地图一定能到达目标,也无法证明解锁状态能够持久保存。

常见问题

Roguelite 自定义任务编辑器应该能配置哪些内容?

先支持配置任务 ID、游戏已支持的目标类型、目标引用、计数或完成规则,以及奖励 ID。避免在编辑器里加入新的战斗或跨局养成逻辑。开放给创作者的字段越少,验证和测试就越简单。尽量复用已支持的 ID 和字段名。

如何让自定义任务适应反复开局的玩法?

将编辑好的任务定义与当前局的目标进度、永久解锁状态分别保存。沿用游戏中现有的进度管理组件,明确任务何时重置、解锁何时写入。将单局状态的重置逻辑与永久进度规则分开。

如何阻止无效任务进入单局流程?

在开局前检查必填字段、目标类型是否受支持、目标 ID 是否已知、完成条件是否可达,以及奖励引用是否有效。发现问题时,指出具体字段并给出可据此修正的错误提示,避免悄悄丢弃目标。创作者应能在开局前修正该字段。

任务定义应该用 JSON 还是引擎资源?

选择符合项目内容编辑流程和打包方式的格式。Godot 的自定义 Resources 可以编辑并序列化,Unity 文档则将 ScriptableObject 描述为可用于存放编辑数据的容器。无论选哪种格式,任务都由现有的任务执行器运行。确认目标引擎如何打包项目内容。

添加任务编辑器后应该测试什么?

测试内置任务、有效的自定义任务、目标缺失、反复开局、奖励发放、解锁状态的持久保存,以及旧版数据。记录构建版本和实际结果。仅凭编辑器预览无法证明一局游戏能完整跑完。每次测试都要保存用例 ID 和观察到的行为。

从一种任务类型做起

第一版可以先支持一种能通过现有游戏系统运行的目标类型。等实际项目中的 ID 引用、验证、单局重置、奖励结算和永久解锁都符合预期,再扩充编辑功能。让内容可以编辑,同时避免编辑器在不知不觉中演变成第二套玩法引擎。

如果想另做一个可在浏览器中游玩的原型,可以试试 SEELE AI Game Maker。这是一条独立的原型制作路径,不能用作现有项目的任务编辑器。

参考资料

SEELE AI

将这份指南变成可玩的作品。

先明确创作需求,再在 Seele AI 工作区中迭代。

开始创作