自定义规则集编辑器可以丰富卡牌对战 RPG 的玩法,但它与牌组合法性、角色定位、卡牌效果、战斗结算、成长进度和存档都密切相关。把编辑器用作选择受支持选项的工具,避免借此改写战斗逻辑。先做一个功能范围有限的本地编辑器,在对局开始前校验规则数据,并保留随游戏发布的规则集作为可靠的默认选项。

本指南适用于扩展一个已经可以运行的卡牌 RPG。文中的示例、卡池、角色定位和测试结果均为虚构。撰写时没有可供检查的代码仓库、战斗结算器、牌组数据或构建版本,也没有进行试玩。下文提出的测试不得视为已经执行或通过。
添加控件前先记录现有规则
先创建一个干净的提交,或在独立的项目副本中操作。记录内置规则集、对局启动流程、牌组校验方式、角色定位如何限制可用卡牌,以及负责处理回合和效果的服务。记下规则和成长进度的保存位置。如果游戏无法在本地运行,记录已检查的代码,并将运行时行为标记为未验证。
列出编辑器必须维持的条件。例如,卡牌费用始终为非负数,角色定位保留原有的可用卡牌类别,回合顺序保持确定性,已发布的模式沿用当前配置。应逐项在目标项目中确认这些条件,因为不同卡牌 RPG 的规则可能不同。
| 系统 | 基线记录 | 默认保护措施 |
|---|---|---|
| 战斗结算器 | 回合与效果由谁处理、事件顺序 | 避免重复实现或替换结算器 |
| 牌组规则 | 牌组大小、角色定位兼容性、同名卡数量上限 | 保留现有的合法性校验 |
| 卡牌数据 | 费用、目标、效果字段及 ID | 避免全局修改卡牌目录 |
| 模式与存档 | 内置预设、成长进度、存档结构 | 单独保存自定义草稿 |
要求 AI 只检查实际提供的文件,并逐个文件列出修改计划。让它明确指出目前由哪个模块负责规则校验和战斗执行。在弄清项目中的规则优先级和数据边界前,避免接受大范围的代码重写。
缩小规则集的可编辑范围
先选几项现有游戏已经能够安全支持的设置,例如对局时长、牌组限制预设,或一条已受支持的卡牌类别规则。每个选项都应有清晰的标签、允许值和默认值,并明确它如何与角色定位配合。首版编辑器应避免开放任意脚本或所有卡牌数值字段。
在虚构的 Ashen Archive 示例中,本地自定义预设用于设置初始资源上限、同名卡数量上限,以及是否允许使用某个指定的卡牌类别。这些设置仅用于教学。实际项目可能并不支持它们,应等战斗系统明确定义每项设置的含义后再添加。

明确记录规则优先级。如果全局预设限制了某张卡,而角色定位也有相关限制,要明确哪条规则生效,以及是否必须同时满足两条规则。对于单张卡牌的覆盖设置,应定义允许覆盖的字段,并保持卡牌 ID 稳定。避免用控件在编辑器中的显示顺序来决定对局行为。
将规则数据与战斗结算分开
优先使用现有对局初始化流程和校验器都能读取的规则集值对象。编辑器负责修改数据,现有结算器继续处理回合和效果。这样可以把规则编辑与战斗执行分开,也方便比较自定义规则与默认预设下的对局。
一条规则集记录可以包含数据结构版本、规则集 ID、来源游戏版本、受支持的选项值和显示名称。存储内容应限于数据,排除可执行表达式。由游戏将通过校验的选项映射到现有规则。如果当前结算器无法表达某个值,编辑器就不应让玩家误以为保存该值便能使效果生效。
Godot 的 JSON 文档介绍了如何将 JSON 文本解析为 Variant,以及如何将数据序列化回 JSON。其运行时文件指南介绍了如何使用 FileAccess 读写文件,并包含处理用户提供内容的示例。这些资料可用于确认引擎提供了相关 API。本例的数据结构并非文档规定,文档也未提供安全保证或可运行的 Ashen Archive 实现。
对于玩家创建的数据,使用前应校验版本和每个字段。除非项目已制定向前兼容策略,否则遇到未知的规则 ID 应拒绝加载。按项目定义检查取值上下限,确保卡牌类别标识符已知、角色定位键有效。避免实例化任意资源,也不要将规则文件中的文本作为代码求值。如果游戏支持导入内容,应单独测试导入流程并记录其限制。
保留内置模式和旧存档
将自定义草稿与官方模式和成长进度分开保存。玩家编辑预设时应创建副本,避免在未提示的情况下覆盖原预设。如果游戏有成就、排位赛或可保存的战役状态,应单独记录自定义规则对局的结果。自定义规则能否接入这些系统,需要在产品规则中明确规定。
为数据结构设置版本号,并附上来源游戏版本。字段发生变化时,应选择迁移数据或明确拒绝加载。用现有存档和用户规则集的副本测试这两种处理方式。对于缺失字段,除非项目负责人已经指定了默认值,否则不要擅自采用会影响平衡性的取值。
| 兼容性场景 | 需要回答的问题 | 核查依据 |
|---|---|---|
| 旧版自定义文件 | 这个版本的数据结构能否迁移? | 迁移前复制的测试样本 |
| 选项缺失 | 是否有文档规定的默认值? | 经过测试的默认值处理结果 |
| 未知卡牌类别 | 加载时应拒绝还是给出警告? | 显示错误,且不静默替换 |
| 内置预设 | 编辑操作会修改随游戏发布的预设值吗? | 原始预设的哈希值或副本 |
| 自定义对局结果 | 是否影响战役或排位? | 明确的模式规则 |
只实现首版编辑器所需的流程
最简界面需要列出受支持的控件,提供生效规则预览和校验摘要,并支持另存为、创建副本和恢复默认设置。标明哪些限制来自所选的角色定位。如果所选选项与角色定位或卡牌集合冲突,应在对局开始前说明冲突,避免进入战斗后才报错。
清楚标注单位,并限制输入范围。只有项目有相应证据时,才能将选项标为“平衡”或“竞技”。提供一套与当前发布版本行为一致的默认规则,并让玩家轻松恢复这套规则。在运行时、界面和测试都能支持高级字段之前,先将这些字段隐藏。
生成的插图中,虚构界面只用于展示视觉构想。图中没有真实的规则集编辑器、实际游戏数据或已完成的校验结果。在实际项目中,编辑器应沿用现有界面交互模式,并复用已有的规则服务,避免另建一套服务。
规划最小改动和回滚步骤
接受代码改动前,先列出允许修改的文件。首轮可以把范围限制在一个编辑器界面、一个规则集模型或适配器、一个校验入口、一个本地草稿保存服务,以及针对这些改动的测试。除非检查项目后确认存在必须处理的依赖,否则应保留现有的战斗结算器、完整卡牌数据库、角色定位逻辑、内置预设和战役存档读取器。
检查完整的代码差异。要求 AI 解释每个文件的改动,并指出默认值、事件顺序、卡牌数值或成长进度相关钩子是否发生变化。对照允许修改的文件清单核查代码。如果任务扩展到调整整个卡池的平衡性或重构战斗系统,先停下来,把这部分拆成独立界定范围的改动。
在独立分支或干净的副本上操作。迁移前保存一份默认预设样本,并备份所有旧版规则文件。如果自定义规则集改变了现有模式,或者原本合法的牌组意外变得不合法,应回到基线并缩小改动范围。把回滚方案写成具体的版本控制操作。
在副本上测试规则之间的相互作用
先逐项测试各个选项,再测试组合。随后检查全局限制、特定角色定位的牌组规则、同名卡数量上限和对局设置之间的相互作用。验证以下场景:有效的自定义对局、不合法的牌组、不受支持的取值、旧版数据结构、字段缺失,以及恢复内置预设。应先在实际项目中执行这些测试,再声称编辑器具备兼容性或规则达到了平衡。

| 拟检查的项目 | 操作 | 记录内容 |
|---|---|---|
| 默认规则回归测试 | 使用已发布的规则启动一场已知对局 | 构建版本、预设、牌组和观察到的结算流程 |
| 角色定位兼容性 | 用每种角色定位分别尝试使用一张受限制的卡牌 | 校验结果及原因 |
| 取值边界 | 输入超出允许范围的值 | 拒绝与纠正情况,并确认系统没有静默将数值截断到边界 |
| 异常内容 | 加载含有缺失字段、无效字段或未来版本字段的数据 | 安全拒绝并提供便于处理的错误信息 |
| 存档迁移 | 加载旧版自定义规则集的副本 | 迁移结果或有文档说明的拒绝结果 |
| 回滚 | 恢复到干净的基线分支 | 确认默认模式照常运行 |
这张表只列出了测试计划。执行测试时,记录游戏版本、规则集版本、角色定位、牌组 ID、操作、预期行为、实际行为以及二者之间的差异。界面示意图无法证明某种规则组合是否公平,也无法证明旧存档仍能加载。
常见问题
自定义规则集编辑器应该控制哪些内容?
只开放现有战斗系统能够安全处理的对局选项,例如回合数上限或少量已有文档说明的卡牌限制。为规则取值设定范围,并确保其易于理解。首版编辑器应避免改写核心结算器、角色成长逻辑或所有卡牌效果。
如何避免自定义规则破坏卡牌对战?
仍由当前结算器负责战斗结算,并向它传入经过校验的规则集对象。明确全局规则、角色定位与卡牌文本相互作用时的优先级。先用默认规则测试一场已知对局,添加编辑器后再比较结果。
应该允许玩家编辑卡牌的所有数值吗?
先列出少量受支持的选项,仅开放清单内的设置,避免让玩家随意修改伤害、费用或效果脚本。限制数值的取值范围,并拒绝不受支持的组合。只有当游戏明确定义了相关规则,并有测试用例覆盖它与其他规则的相互作用时,才新增控件。
如何保存和更新自定义规则集?
使用带版本号的数据格式,标明来源游戏版本,并将用户创建的规则与内置预设分开保存。加载前校验各字段,并为旧版数据提供明确的迁移或拒绝加载流程。在副本上测试改动,确保现有存档和官方模式不受影响。
AI 能帮我平衡游戏的自定义卡牌规则集吗?
AI 可以协助检查已提供的规则、列举规则之间的相互作用并起草测试用例。要证明规则是否平衡,仍需真实的卡池、战斗逻辑和实战数据。把 AI 生成的数值视为提案。分享规则集之前,检查完整的代码差异,并运行有代表性的对局。
保留现有战斗系统,扩展规则选项
先记录内置规则下的游戏行为,再开放少量明确允许的设置,校验带版本号的规则数据,并且只将受支持的值传给现有战斗结算器。将自定义草稿与已发布的预设和旧存档分开保存。在确认编辑器可用之前,检查完整的代码差异,在副本上测试,并保留一个干净的回滚点。
如果想单独探索一个卡牌对战 RPG 的构想,可以试试 SEELE AI Game Maker。它用于探索游戏构想,不提供现有项目的编辑功能。


