内容生产、调试与回放

返回总览。本篇连接内容作者、生成文件、开发观测和导演/录像功能。只阅读代码与工程文本，没有运行编辑器、打包脚本、测试场景或编译工具。

1. 内容生产同时存在手工编排与工具生成#

本仓库的玩法生产并非统一由一个关卡编辑器包办。可以看到三条互补路径：剧情任务手写状态机；通用玩法用公共头文件、数据与可覆盖钩子构造变体；邮件、任务统计等高重复结构由专用编辑器生成。

图表示源码中的生产分工，未验证当前环境能完成其中的构建与资源导出步骤。脚本源、外部资产、生成程序版本之间的一致性，不能仅通过“工程文件存在”确认。

2. EmailStar：一次导出连接结构和本地化文本#

DataSetIO.ExportTo 同时定义 email_generated_globals.sch、email_generated_functions.sch 和 americanEmail.txt 三类输出。[S1，L182] 它支持传入目标目录，也保留历史开发盘符的默认路径。

技术价值在于让一份邮件内容定义同时形成脚本枚举/状态、查询逻辑与文本资源，减少作者在三处手工维护索引。对应成本是生成代码不宜独立修改：若只改 .sch，下次导出可能覆盖；若只改文本，脚本索引与资源标签可能不一致。

该导出函数中仍能看到待完善的字符串合并注释，因此不能把“有编辑器”进一步推断为数据已完全规范化或去重。内容生产工具降低重复劳动，同时仍需要清晰的源数据归属和导出规则。

3. MishStatStar：把任务目标转为可执行统计契约#

ExportGenerator 不只是写一张评分表：它生成统计枚举、函数、字符串映射和排行榜相关输出。[S2] exportFunctionFile 中实际构造了 MISSION_STAT_RESET_STAT_REGISTER、MISSION_STAT_ADD_WATCH 等脚本代码；包括统计值、失效原因、成功显示状态和最大 watch 数量检查。

这种生成方式把任务设计中的“计时、命中率、特殊动作”等指标接入统一运行系统，任务内容负责报告事实，统计系统负责追踪和展示。新增目标应检查枚举、watch 注册、类型、文本、完成与失败规则，以及排行榜字段，不能只给任务结束页加一行字。运行时侧详见存档统计与进度。

CarcolsEditor、MarketStarPrototype 等目录说明还存在其他专用工具，但本文未逐项验证它们的导出协议，也不将原型工具等同于当前正式生产入口。[S10]

4. 观测按脚本线程归因，长稳测试按生命周期施压#

shared/script_metrics.sc 提供总体和单线程指标整理、记录及界面显示；后段可见 current、average、peak 等时间条绘制。[S3] 这与合作式脚本更新模型一致：一个常驻脚本中的重扫描可能影响整帧，只有总帧时间不能定位是哪一类控制器导致。

文件也保留注释掉的 cloud 上传代码，不能因此宣称这些记录当前一定自动上传。指标工具的存在只证明可观测能力，不代表本次已经取得性能数据。

net_session_soaktest.sc 为网络 bot 安排随机约 10–45 秒的加入/离开时间，随后持续驱动会话变化。[S4] 这类测试着重暴露迁移、断连、重生、资源清理等反复执行后的问题。multiplayer/scripts/bots 是这一类测试辅助入口，不能据其名字把普通城市 NPC 描述成独立网络机器人。

Code 还包含 camera、cutscene、combat、vehicle AI、navigation、physics 等针对性场景。[S5] 它们适合作为理解 Native 使用意图和边界条件的补充证据，测试脚本名本身不证明测试通过，更不证明生产玩法默认启用其中的实验。

5. 场景作者辅助与导演模式的角色#

sceneBuilder.sch 中有 widget 及以 <loadData> 结构保存场景数据的代码。[S6] 它体现作者在游戏环境中放置、观察、导出场景的工作方式。不能仅凭公共头文件位置，把它认定为所有运行场景的唯一底层框架。

director_mode.sc 则是玩家可进入的表现控制模式：演员模型交换、导演模式控制、初始化与退出/保存相关处理在一个专门脚本中协作。[S7] 模型交换会影响玩家实体、动画与可用能力，因此需要专门流程，而非只把模型 hash 改一下。导演模式与在线切换也存在清理契约，后台脚本中还保留了检测导演模式残留状态的修正，见后台脚本与内容更新。

debug、temp、marketing、cheat_controller 应分别视为开发辅助、临时内容、演示/拍摄内容和作弊控制入口；它们不是四套可统一套用的正式任务框架。报告将这些目录归到本模块作为覆盖归属，未声称逐一解析了其中所有场景。

6. 两种 Replay 必须区分#

replay_controller 会区分 mission、minigame、RC 等上下文。[S8] 这属于恢复玩法，不是把世界从视频数据中重新模拟。另一方面，Register_All_ReplayEditor_Fx 注册 No_Filter 及若干 phone_cam* 效果，表明录像编辑与手机摄像效果可以共享资源。[S9]

脚本中的录制触发只构成录制能力的上层入口；录像序列化、缓冲、编辑器及导出实现还涉及游戏原生模块，本文没有将其扩展成一份完整视频管线审计。

7. 对内容规模化的启示#

作者工具最适合处理稳定、重复的结构：ID、文本标签、属性表、统计目标和场景放置。复杂剧情节奏仍由手写脚本组织；在线通用模式则把差异限制到数据和钩子。三者共存，让内容作者在表达力与重复生产效率之间选择合适入口。

扩展内容时，应同时保留可定位的内容 ID、调试状态和失败原因。运行成本、网络成本和存档成本需要分别观测，不能用脚本行数、一个 timing 数值或一次成功体验代表全部质量。这里列的是基于源码架构的实践建议，本次没有执行这些运行验证。

源码证据#

[S1]: <../../../GTAV Source/script/dev_ng/Tools/EmailStar/EmailStar/DataSetIO.cs> [S2]: <../../../GTAV Source/script/dev_ng/Tools/mishstatstar/ExportGenerator.cs> [S3]: <../../../GTAV Source/script/dev_ng/shared/script_metrics.sc> [S4]: <../../../GTAV Source/script/dev_ng/multiplayer/scripts/soaktests/net_session_soaktest.sc> [S5]: <../../../GTAV Source/script/dev_ng/Code> [S6]: <../../../GTAV Source/script/dev_ng/shared/include/public/sceneBuilder.sch> [S7]: <../../../GTAV Source/script/dev_ng/singleplayer/scripts/director_mode/director_mode.sc> [S8]: <../../../GTAV Source/script/dev_ng/singleplayer/scripts/Replay/replay_controller.sc> [S9]: <../../../GTAV Source/script/dev_ng/shared/game_capture/video_editor.sch> [S10]: <../../../GTAV Source/script/dev_ng/Tools> [S11]: <../../../GTAV Source/script/dev_ng/singleplayer/scripts/main/main.sc>