面向玩家的关卡编辑器可以延长音游的生命周期,但也会涉及谱面格式、音频时钟、计分、输入、存档,有时还会牵涉社区功能。继续以现有播放系统为时序基准。先实现一套最小的本地创作流程,让玩家在节拍网格上放置事件、预览和校验谱面,并保存带版本号的草稿,同时保持已发布关卡的游玩方式。

本文介绍如何为现有项目添加编辑器,并沿用原有的节奏引擎。示例游戏、配乐、界面、谱面数据和结果均为虚构。编写本文时,没有可用的项目文件、音乐、解析器或构建版本。文中的检查清单列出的是拟开展的校验工作,并非测试结果。
明确编辑器的功能范围
从一个干净的提交开始,选一份已确认可以正常游玩的谱面作为基准,并记录音频时钟、谱面加载器、速度映射、输入绑定、音符轨道、计分规则、歌曲偏移量、保存路径和进度标记。如果没有可运行的构建版本,就只检查已提供的文件,并说明实际运行行为仍不明确。
首个版本只做本地核心功能。玩家应能选择可用曲目、放置和移动事件、撤销修改、预览某个片段、保存并重新打开草稿,以及查看校验提示。在线分享、评分、内容审核、订阅和跨设备同步可以另行规划。同时加入这些功能,会让时序回归问题更难定位。
| 现有系统 | 动工前记录 | 默认保护措施 |
|---|---|---|
| 音频与时序 | 时钟来源、延迟偏移量、曲速变化 | 沿用现有播放时钟 |
| 谱面运行时 | 文件字段、事件顺序、加载器行为 | 保持与已发布谱面的兼容性 |
| 计分与输入 | 命中判定窗口、动作名称、轨道映射 | 预览时沿用相同规则 |
| 游戏进度 | 解锁状态、完成状态、已保存分数 | 将草稿与正式成绩分开 |
在修改之前,让 AI 先检查实际文件并拟定变更计划。要求它列出允许修改的文件,以及必须保持原样的系统。“添加一个关卡编辑器”这样的请求范围太广,可能让 AI 引入新的时序模型,或替换本来就能正常工作的谱面加载器。更稳妥的提示词应指定一种谱面格式、一个本地保存路径,以及一个调用现有播放代码的小型编辑界面。
按音乐节拍编排事件
用事件在歌曲中的位置来表示它,避免使用拖动方块时采集的系统时间戳。如果现有运行时使用拍点坐标,就沿用这套坐标。如果使用秒数,就添加明确的转换适配器,并对照现有速度映射验证换算结果。编辑器的标尺与实际游玩的谱面必须在每个曲速区段内保持一致。
从概念上讲,一个事件可以包含稳定的 ID、轨道、小节、拍、细分位置、事件类型,以及可选的持续时长。只保留必要字段,并与项目实际使用的加载器匹配。只有运行时已经支持曲速变化,或功能计划明确要加入这项支持,才在谱面格式中保存曲速变化。切勿仅凭截图或未提供的示例谱面推断完整的数据结构。

Godot 的稳定版文档介绍了如何通过 FileAccess 及相关 API 在运行时读写文件,并提供了涉及用户提供内容的示例。其数据路径指南说明了如何使用 user:// 持久保存用户数据。这些参考资料说明了引擎有哪些文件读写方式,无法据此确定音游谱面的必用格式、作出安全保证,或认定 Pulse Harbor 的实现已经过测试。
使用稳定的标识符,让移动或删除一个事件时无需为其他事件重新编号。用确定的规则为播放事件排序,明确如何处理同时出现的音符,并区分可选字段缺失与必填字段无效。如果项目已经将谱面存为资源,就围绕现有格式构建编辑器适配器,避免另建一套并行结构绕过它。
让编辑操作可预期、可撤销
为节拍网格提供缩放控件,缩放时保持已存储的时序数据。点击可添加事件,拖动可移动事件,清晰的选中状态让玩家知道要删除哪个事件,撤销可恢复到上一次编辑前的状态。键盘快捷键应避开游戏现有的操作绑定。显示当前小节、节拍细分、选中轨道和播放头,让创作者看清操作对应的位置。
将草稿操作与正式通关状态隔离。预览时应避免推进游戏进度、覆盖已发布谱面或向排行榜提交分数。把草稿存入专用文件夹,并在玩家打开已有的自定义谱面时保留原始副本。如果游戏只支持内置曲目,编辑器就应提供这些资源,避免让玩家误以为已支持导入任意音频。
在虚构的 Pulse Harbor 示例中,编辑器保存带版本号的本地谱面草稿,并复用现有的预览场景。这是一种拟议方案,尚无实际文件或集成可供核实。你的项目可能需要采用不同的功能边界,尤其是在谱面加载与资源导入流程绑定时。
预览前校验本地谱面文件
将玩家创建的文件作为待校验的数据处理,切勿将其当作指令执行。检查文件版本、必填字段、轨道标识符、事件类型、数值范围、重复 ID 和引用的曲目。拒绝超出项目限制或引用了不可用资源的谱面。错误提示应易懂,并说明怎么修复,指出出问题的事件或字段。
区分警告与会阻止预览的错误。音符密度异常但仍符合规则时,可以给出警告。如果缺少轨道或拍点位置无效,且运行时无法处理,就应阻止预览。根据项目设置文件大小和事件数量上限,并测试解析器如何处理空文件、截断文件、旧版本文件和格式错误的文件。这些限制必须根据目标游戏的设计确定,切勿凭空给出通用数值。
| 校验项目 | 需确认的问题 | 校验失败时的处理 |
|---|---|---|
| 版本 | 编辑器能读取这个版本的数据结构吗? | 说明如何升级或为何拒绝读取 |
| 曲目引用 | 这首歌在允许使用的曲目库中吗? | 避免在未提示的情况下替换音频 |
| 事件坐标 | 轨道和拍点取值受支持吗? | 指出无效事件 |
| 事件标识 | ID 是否唯一且稳定? | 提供安全的修复方式,或阻止保存 |
| 文件限制 | 内容是否符合项目限制? | 在加载前按预期拒绝文件 |
将项目改动控制在最小范围
接受补丁前,按文件变更计划逐项核对。首个最小可用版本可能涉及一个编辑器场景、一个编辑器控制器、一个谱面数据适配器、一项本地草稿管理服务,以及少量测试。避免在未说明的情况下重写所有曲目的数据、更改命中判定窗口、修改音频驱动,或将草稿谱面纳入正式游戏进度。
让 AI 展示完整的差异、列出兼容性假设,并说明如何移除该功能。在独立分支上工作,或复制项目。保留一份未经修改的已知谱面和一份参考录制。如果需要引入新的数据版本,先制定迁移计划,在谱面副本上测试,再修改玩家数据。如果改动影响了播放,就回退到基准版本并定位原因。
在项目副本上测试时序对齐和回归
除了确认编辑器界面能打开,还要对比同一份已知谱面在改动前后的表现。检查开头附近的一个音符、中间片段、曲速切换点以及结尾。确认编辑器播放头、预览音频、音符动画、命中判定和计分都使用同一个时序来源。网格在视觉上对齐,并不能证明音频延迟或游玩时序正确。

| 拟检查项目 | 操作 | 记录内容 |
|---|---|---|
| 基准谱面 | 用旧构建版本运行一份已知谱面 | 构建版本、曲目和预期时间戳 |
| 编辑器保存与重开 | 放置事件、保存草稿、重新打开并预览 | 序列化后的事件及任何差异 |
| 曲速切换点 | 在曲速变化前后放置事件 | 拍点、音频播放位置和播放头位置 |
| 格式错误的文件 | 测试字段缺失、无效和不受支持的情况 | 明确报错,程序不崩溃 |
| 回归 | 重新游玩未经修改的参考谱面 | 时序、计分、输入和游戏进度 |
| 回滚 | 移除功能分支或恢复项目副本 | 原谱面仍可游玩 |
这张表列出的是拟开展的测试,无法证明时序依然准确。实际测试时,记录项目版本、音频设备、谱面、偏移量、具体操作、预期行为、观察到的行为,以及任何回归问题。切勿根据生成的界面示意图宣称编辑器或校验面板已经实现。
单独规划发布和社区分享
如果长期目标包括分享,先明确内容审核、举报、删除、所有权、歌曲授权、存储限制和游戏版本间的兼容性。本地编辑器本身无法提供安全的在线谱面库。应先落实并测试相关服务与政策,再宣称玩家可以发布或下载自制谱面。
如果想另外探索一个音游创意,可以试用 SEELE AI Game Maker。它用于探索游戏概念,无法充当现有项目的编辑器。
常见问题
音游关卡编辑器应该让玩家做什么?
先实现创作和预览谱面所需的操作,包括选择曲目、在节拍网格上放置事件、编辑事件或撤销操作,以及保存和校验草稿。将发布、分享和内容审核作为独立功能,等本地创作流程稳定后再考虑加入。
谱面事件应该按秒数还是按拍点保存?
如果游戏已有速度映射,优先使用小节、拍和细分位置等稳定的音乐坐标。通过现有时序系统将这些坐标换算成播放时间。保留当前的音频时钟和偏移规则,再测试曲速变化和段落边界附近的音符。
如何在保持原有节奏播放的前提下添加编辑器?
以现有的谱面加载器、音频时钟、计分规则、输入和音符轨道为基准。让编辑器按运行时现有的格式生成数据,或通过带版本的适配器生成数据。对比一份已知谱面在改动前后的表现,如果事件时序发生偏移,就回滚改动。
如何校验玩家创建的谱面?
预览前检查文件版本、必填字段、曲目引用、事件类型、拍点范围、重复 ID 和不受支持的取值。在编辑器中提示可修复的问题,并安全拒绝格式错误的内容。仅凭数据结构检查清单,无法证明实际的解析器能处理所有恶意文件。
AI 能在我现有的音游里构建关卡编辑器吗?
AI 可以协助检查已提供的文件、提出范围明确的补丁方案,并起草校验用例。缺少实际项目和测试时,AI 无法验证时序或兼容性。向 AI 提供允许修改的文件清单、未经改动的参考谱面、预期的节拍表现和可回退到的提交,然后审查完整的差异。
沿用现有播放系统,加入谱面创作功能
继续由现有节奏引擎负责时序。添加一个功能范围明确的本地编辑器,保存带版本号、按节拍定位的事件,在预览前校验事件,并将草稿与已发布谱面和正式成绩隔离。审查代码差异,在项目副本上测试已知谱面,并保留可回滚的版本。在实际游戏完成测试前,所有结果都应视为尚未验证。


