简易.hcb自由编辑功能的实现

简易.hcb自由编辑功能的实现

以《さくら、もゆ。-as the Night's, Reincarnation-》及其体验版为例

离民

摘要：FVP（Favorite View Points）是会社FAVORITE视觉小说游戏的核心引擎，其剧情与演出控制逻辑以字节码形式封装于.hcb脚本中。现有工具对.hcb的反编译结果可读性较差，或仅支持字符串级替换，难以实现剧情重构、跨版本内容移植等真正意义上的自由编辑。本文以《さくら、もゆ。-as the Night's, Reincarnation-》及其体验版为对象，提出并验证了一种轻量级自由编辑方法：在不完全解明全部指令的前提下，首先生成可读性更强的反编译中间表示，进而对照NS/PS4版的同义ks脚本进行交叉分析，并借助AI工具逆向识别关键功能函数及其参数语义，最终实现功能块的复用与重组。实验结果表明该方法可行，为FVP引擎游戏的二次创作提供了一条低门槛、高可行性的技术路径。

关键词：FVP；视觉小说；反编译；自由编辑；AI辅助

一、引言

视觉小说（Visual Novel）作为一种融合文字叙事与视听演出的交互媒介，其表现力高度依赖底层引擎的脚本系统。FVP引擎，全写为“Favorite View Points”，是会社FAVORITE专有的视觉小说类游戏引擎，代表作品有《星空のメモリア-Wish upon a shooting star-》《いろとりどりのセカイ》等。FVP引擎本身是闭源引擎，结构未公开，在游戏内容跨版本移植等方面存在一定的技术壁垒。

本文以FVP引擎作品《さくら、もゆ。-as the Night's, Reincarnation-》（下称《樱花，萌放。》）及其体验版为研究实例。两部版本分别于2019年1月及2018年12月发行，均采用FVP引擎。通过对比可以发现，FVP引擎的游戏在目录架构、资源封装与脚本调度上具有高度同构性——典型的游戏根目录包含主程序（.exe）、字节码脚本（.hcb）、若干资源封包（.bin）及视频文件夹，其中.bin封包内集中存放.hzc图片、.ogg语音和.wav音效，而演出、画面与剧情的控制流则完全由.hcb脚本定义。这一架构的稳定性意味着，针对任一作品所取得的解析与编辑方法，理论上可相对平滑地迁移至其他FVP游戏。

正因.hcb承载了游戏的核心逻辑，修改其内容即可实现从文本翻译到剧情重构的多层次定制。然而，现有工具尚不能同时兼顾编辑的自由度与操作的便捷性：akerou的fvp工具[1]及其社区扩展功能[2]虽支持完整的反编译与回封，但输出的底层栈操作序列可读性极差，编写与调试成本极高；而lilith��的拆解脚本[3]、FVP-Yuki[4]等工具则聚焦于字符串的提取与替换，仅能满足中文化需求，无法实现功能级重组。这些局限使得“借用FVP引擎进行自主创作”面临较高的技术门槛。

针对上述困境，本文提出并验证一种轻量级的自由编辑假设：在不完全解明.hcb全部指令的前提下，若能获得可读性更强的反编译中间表示，并引入多平台同义脚本作为参照，借助AI工具逆向识别关键演出函数的入参语义，即可通过对现有功能块的参数调整与重新组合，实现足够灵活的二次创作。为验证该假设，我们设计并实现了一套工具链——首先生成Lua风格中间表示以改善可读性，继而对照《樱花，萌放。》Nintendo Switch/PlayStation4版的.ks同义脚本进行交叉分析，结合大语言模型的静态辅助，完成了对话、背景、CG、立绘、音效与音乐等核心模块的逆向工程与高级封装。实验结果证实了假设的可行性，为FVP引擎游戏的同人创作与跨版本内容移植提供了一条低门槛、高可行性的技术路径。

二、现有研究工作

FVP引擎在运行时以目录下首个.hcb文件作为脚本入口（实际读取的扩展名字符串硬编码于可执行文件中，可手动修改）。.hcb文件采用自定义字节码格式，在2011年，amaranthf便完成了对指令种类及对应的具体含义的相关解析工作[5]。amaranthf的具体解析内容如表1所示。

表1.amaranthf对.hcb字节码指令含义的解析

依据上述内容，可以设计反编译.hcb脚本的工具。实际上，现在社区中已经有多种处理.hcb脚本文件的工具。具体而言，现有的.hcb文件解析及重合成工具大致有以下几种：akerou的fvp工具[1]及其社区升级版（升级版主要加入了gbk编码hcb的回封）[2]、lilith的拆解及回封py脚本[3]、较新的hzc图片与hcb脚本一体化解析GUI工具FVP-Yuki[4]等。其中，fvp工具及其扩展可以将.hzc字节码完全反编译并基于反编译内容构建新的.hzc脚本，然而反编译出的内容的可读性较差，如图1所示。

图1.fvp工具对《樱花，萌放。》的脚本Sakura.hcb的反编译结果

  图1展示了fvp工具对《樱花，萌放。》脚本的反编译片段，从中仅能观察到连续的push与call操作，但参数入栈与函数调用之间的逻辑关系无法直观呈现。读者只能借助经验猜测，例如pushstr指令可能与游戏内显示的对话文本存在关联。这种低可读性的输出使得基于反编译结果进行功能级重写极为困难，对编写者的逆向工程能力与耐心均构成相当大的挑战。

相对地，lilith的py脚本与FVP-Yuki则只针对脚本中字符串相关部分，只是实现中文化则足以胜任，无法编辑控制流与演出指令，因而难以支撑真正的自由创作。

综上可见，已有研究在.hcb脚本编辑上呈现出“完备性”与“可读性”难以兼得的困境：支持完整编译的工具反编译结果过于晦涩，而易于上手的工具又刻意阉割了功能以降低操作门槛。这一现状构成了对.hcb脚本进行函数级自由重组的实质性障碍。因此，本文认为，在开展自由编辑方法探索之前，有必要首先设计一种能够输出结构化、可读性更强的中间表示的反编译方案，进而在此基础上完成功能函数的识别与逆向分析。

三、实现方法

（一）可读性相对更好的反编译结果的获得

基于目前.hcb解析工具不够完善的现状，有必要设计新的解析工具，以更好理解.hcb的字节码在运行时的具体行为。为突破现有工具输出结果可读性不足的瓶颈，本研究设计并实现了一款新型反编译工具。该工具的开发依托于对已公开的FVP引擎文献与项目源代码的系统整合，并借助大语言模型进行辅助分析与代码生成。借鉴rfvp项目[6]将字节码转换为Lua风格表示的设计理念，本工具最终采用类似Lua的脚本语法作为反编译输出的中间表示（IR），其输出示例如图2所示。

图2.《樱花，萌放。》的脚本Sakura.hcb反编译结果（部分a） 注：fvp工具中将0x08看作pushtrue，现有资料则更多将其视为pushnil，将0x09视为pushtrue

  相较于fvp工具的结果，该工具得到的IR的可读性明显较好。在fvp工具反编译的结果中，读者只能看出pushstr、pushtrue、call function等操作，而不清楚这些操作之间的具体关联；而在新工具的输出中，读者可以直观地将连续的push操作与后续的call语句相关联，从而明确各入参与被调函数之间的对应关系。例如，通过对图2所示IR的语义分析，可轻易推断出游戏中文本显示的具体调用模式：首先压入字符串数据及四个辅助参数，继而调用以偏移地址命名的功能函数f_0004CEFD。这为后续的系统性函数功能逆向分析奠定了坚实基础。

（二）核心功能function的逆向分析与入参语义识别

借助可读性显著改善的IR，可对.hcb脚本高层逻辑进行宏观把握。通常，一部视觉小说的演出需求涵盖对话、背景、CG、立绘、角色名、语音、BGM、音效及选项界面等模块。基于此领域知识，可通过检索IR中的函数调用，初步定位与各类演出功能相关的候选函数。

对正式演出段代码的静态分析表明，除显示对话的f_0004CEFD外，脚本中密集调用了多个功能各异的函数，如f_000547D2、f_00002403、f_00055D3D及f_00000004等（如图3所示）。这些函数具有不同的参数数量与结构，暗示着彼此迥异的语义功能。

图3.《樱花，萌放。》的脚本Sakura.hcb反编译结果（部分b）

  在解析上述函数的具体语义时，我们面对两种传统路径：一是通过逐次修改入参并观测游戏运行时行为的变化来推断其作用，此方法耗时且盲目；二是直接阅读函数体内部的字节码定义以推演其逻辑，这要求分析者具备高超的逆向技能且效率低下，即便有AI工具的辅助亦是如此。

为克服此困境，本研究创新性地引入了第三种路径——多源同义脚本交叉验证。该方法的关键在于利用了《樱花，萌放。》Nintendo Switch/PlayStation4版本所采用的、基于TJS语言的.ks脚本。相较于晦涩的字节码，.ks脚本使用的TJS语言是高级脚本语言，其语意自明性远胜前者，可谓是解译.hcb的“罗塞塔石碑”。

图4.《樱花，萌放。》NS版脚本common1.ks的内容（部分b）

观察相同数字及字符串可知，图3的内容在ks脚本中的同义内容正是图4中的这一部分。通过将.hcbIR与同义.ks脚本逐段对比（如图3与图4所示），并结合游戏内的实际演出效果，各函数的语义得以迅速澄清。以图3片段为例，其对应的.ks脚本及游戏表现为：

• ①f_000547D2：在15000毫秒内淡出编号为56的循环音效，确认其与音效控制相关。

• ②f_00002403：在预设模式0下加载并显示特定CG图“KURO_e011a1”，揭示了每个独立CG资源均有专属的加载函数。

• ③f_00055D3D：执行一段持续2950+500=3450毫秒的转场效果。

• ④f_00000004：设定说话角色为“クロ”，并将其显示名称设为“？？？”，同时触发语音“01000010”。这表明在.hcb中，角色设定与语音播放由同一function统一调度。

• ⑤f_0004CEFD：显示文本“…………”，由于是对话内容，且不含其它引号，该函数会自动为输入文本添加引号“「”与“」”。

为进一步扩展分析广度，有必要截取其余部分来进行具体判断。此处选取了涉及音效、背景与 BGM 设置的另一个代码片段，如图5及图6所示。

图5.《樱花，萌放。》NS版脚本common1.ks的内容（部分b）

图6.《樱花，萌放。》的脚本Sakura.hcb反编译结果（部分c）

图5与图6的对比揭示了更多功能的对应关系：f_000547D2被用于播放序号56的音效，参数控制其在8000毫秒内渐强至85%音量；此后的f_00015543负责以默认参数展示背景图；f_00036848则用于播放特定BGM。分析亦发现，每首BGM与每张背景图均有其独属的加载函数。

在此交叉分析过程中，一个关键的“矛盾点”为逆向分析提供了更深层的线索：同为f_000547D2，为何在控制音效时长时，其入参既可出现在第二位置（停止音效时指定淡出时长），又可出现在第五位置（播放音效时指定淡入时长）？这一疑点揭示了该函数内部存在复杂的条件分支逻辑。此时，我们借助大语言模型对该函数的IR定义进行了静态逻辑分析。分析结果迅速澄清了其控制流：函数首先评估第三个入参，若其为nil，则进入“播放音效”分支；若不为nil，则转至“停止音效”分支。在播放分支中，再检查第二个入参是否为nil以决定是单次播放还是循环播放；而在停止分支中，第二个入参则被解释为淡出时长。这一案例充分证明了AI辅助在加速复杂函数逆向分析中的巨大潜力。

循此方法，通过系统性的交叉对照与AI辅助的静态分析，有如下重要的分析：

1. BGM：f_00036848(S0)类函数，由函数内部实现决定具体播放的BGM资源。
2. 语音与角色名：由统一的SPEAK函数控制，第一个入参为语音文件名；第二个入参决定角色显示名（设为-1时常显示为“???”）。
3. 对话文本：f_0004CEFD(S0,...,S4)，第一个入参为待显示的文本内容。
4. 对话框位置：f_000493AC(S0,S1)，S0为1时对话框居中，否则为常规位置。
5. CG：f_00002403(S0,...,S5)类函数，各入参分别控制复用旧布局、X/Y/Z坐标、旋转及后处理过渡时长。
6. 背景：f_00015543(a0,...,a9)类函数，其内部逻辑复杂，建议通过复用已有调用来实现，其中第七个入参与图片差分的选择有关。
7. 立绘：f_00018029(a0,...,a9)类函数，其本身预设的四个入参S0至S3分别指定角色、姿势、服装与表情。外部自由入参依次控制层次、预设站位、Z轴缩放、X/Y坐标及透明度等。
8. 选项：f_0006D041(S0,S1,S2)控制选项文本，后续通过判断全局变量G[103]的值实现分支逻辑。
9. 音效：f_000547D2，参数逻辑如前所述，高度灵活且由内部条件分支控制。

（三）高级脚本语法设计与编译工具实现

尽管直接编辑IR以生成字节码在技术上是可行的，但手工编写IR对内容创作者而言门槛依然偏高。为将底层实现细节与创作行为解耦，本研究设计了一套精简、易读的高级脚本语法。该语法采用“[标签,参数1,参数2,...]”的格式，将复杂的函数调用序列封装为语义明确的指令，并开发了配套的编译工具hcb_build.py，以实现从该高级脚本到.hcb字节码的自动转换。对于立绘载入、BGM设定等调用模式高度固定且并非必须通过call指向其本身所属function的函数，本工具对其进行了进一步的简化与合并。

该简易脚本的指令集部分设计如表 2 所示（例如 cg 用于加载 CG，dia 用于对话，bgm 用于背景音乐控制等）。通过这一高度抽象，创作者仅需一行指令即可表达原本需数十行 IR 代码才能完成的复杂操作，极大地降低了创作难度。

表2.现有实现的tag表一览

（四）跳转与选项功能的实现

1.跳转功能的实现

“跳转”是视觉小说中虽不必须但较为重要的控制逻辑，选项内容的实现尤其离不开跳转功能。在.hcb脚本中，有两类跳转方式。一类是无条件跳转，对应字节码为0x06；另一类是条件跳转，当栈顶为nil时方进行跳转，对应字节码为0x07。后者常见于各种变量设定相关的判断位置。基于此，可以产生实现jump指令的思路：在高级脚本中按需要添加跳转目标标签，对应好其偏移，调用时即可快速执行0x06的无条件跳转。

然而，此处存在问题：工具在处理脚本txt时是从上到下逐行处理的，若jump指令在jump目标之前，则我们应该如何让工具未卜先知，预先知道jump目标呢？此处，我们可以使用占位符来进行操作。

具体而言，在遇到jump指令时，我们先为jump目标分配一个绝对不会重复的占位符，并记录好占位符与对应目标的一一对应关系。之后，遇到该标记时，再添加一个目标与实际偏移的一一对应。最后，在写入新的.hcb脚本前统一进行一次替换，将占位符替换为实际的符号。实际使用的占位符从0xFFFFFFFF开始递减。由于.hcb文件中合法的偏移量远小于0xFFFFFFFF，且有可能产生此类数值的0x0A和0x0E在脚本构筑时实际上根本不会出现该内容——需要递出负数时，基本上0x0C，或是取负的0x19已经足够；sjis编码或是gbk编码中，连续出现0xFF的可能性基本为零。该占位策略在实践中被证明是安全且可靠的。这样，我们便可在不进行二次遍历的情况下完成脚本构筑。这一思路与汇编技术中的延迟重定位相似。

2.选项功能的实现

选项交互是视觉小说的核心功能之一。通过对原版脚本的对照分析，我们总结出FVP引擎中选项菜单的固定实现模式，其流程可归纳为以下步骤：

1. 选项基底文字：调用函数f_0004CF23，传入一个提示性字符串，显示选项栏目的固定头部。

2. 枚举选项：对每一个选项，调用函数f_0006D041，传入选项文本，依次注册。

3. 结束注册：调用函数f_0006D13F，告知引擎选项列表已完整，此后游戏将等待玩家输入。

4. 分支判断：玩家做出选择后，引擎会将所选序号（从1开始）写入全局变量G[103]。脚本后续通过一系列比较与跳转实现分支：

   0F 67 00 调出全局变量G[103]

   0C i 指定检定值（实际脚本中，G[103]的最大检定值为5）

   22 判断是否相等

   07 xx 若不相等，跳转到下一处判定

   xx 若相等，继续进行相关内容

基于上述观察，以及上一部分对跳转功能的实现我们可以设计sel指令的三个分支。分别为start，op，end三部分，对应选项开始、选项条目和选项结束。工具会自动生成完整的函数调用序列、比较链以及跳转重定位信息。创作者只需为每个选项提供目标标签，即可实现多分支剧情。

通过上述扩展，当前高级脚本已能够支持线性叙事中的条件分支与循环跳转，以及包含复杂交互的选项菜单，为二次创作提供了接近原生脚本的表达能力。

（四）成果实际运行测试

为实证检验上述方法与工具链的有效性，此处尝试利用所设计的高级脚本，对《樱花，萌放。》游戏原作中的一个“名场面”进行还原。原本的游戏场景如图7所示。

图7.《樱花，萌放。》原作截图

图8展示了为重现该场景而编写的高级脚本，该脚本按顺序设定了背景、角色、角色名与对话。经hcb_build.py编译生成新的.hcb文件并替换至游戏目录后，运行游戏主程序所得的实时渲染结果如图9所示。

图8.还原“名场面”所用的脚本

图9.脚本运行结果截图

运行截图中的窗口标题明确标示了此为新编内容，以区别于原作。实验结果显示，尽管因场景整体缩放等高级演出指令尚未完全解析，导致在背景尺寸等细节上与原作存在细微差异，但画面的整体构成、角色站位与对话内容均已得到相当程度的忠实还原。此结果成功验证了“在未完全理解全部指令的情况下，通过复用与重组现有功能块实现自由编辑”这一核心假设的可行性。

此外，选项与跳转功能的实现也需要验证。为验证新增功能的效果，此处设计了一个简短的带有循环功能的选项，如图10所示。

图10.测试选项功能的高级脚本

在游戏中，其实际效果如图11所示。

图11.脚本内容对应的界面

经过实际测试，该脚本满足对选项功能的预期，充分说明新增内容的可用性。至此，我们就实现了视觉小说所需的基本功能。

四、总结与展望

本文总结了社区内对fvp引擎的知识，借助大语言模型的编程及生成能力，开发了能输出 Lua 风格中间表示（IR）的新型反编译工具。相较于传统 fvp 工具输出的纯栈操作序列，该工具生成的代码清晰地呈现“参数入栈-函数调用-结果返回” 的完整执行流程，使操作者能直观识别基础功能模块的调用模式，为后续的函数解析奠定了关键基础。

其后，研究创新性地引入《樱花，萌放。》NS/PS4 版的.ks脚本作为“罗塞塔石碑”。通过交叉对照相同剧情片段的.hcb字节码与.ks脚本，结合游戏运行时的实际表现与AI对函数内部逻辑的静态分析，我们在无需逐行解析全部指令的前提下，快速完成了对话显示、角色语音、CG 载入、背景切换、立绘控制、BGM/音效播放等重要演出功能的逆向工程，对各功能函数的入参数量、数据类型与语义含义有了较为清晰的认知。在此基础上，我们设计了一套基于标签的简易高级脚本语法，将底层复杂的字节码调用封装为人类易读易写的指令，并开发了配套的编译工具hcb_build.py，实现了从高级脚本到.hcb 字节码的一键转换。最终通过对原作经典名场面的还原实验，验证了该方法的可行性——生成的脚本可正确运行，且在未能理解全部.hcb演出指令的前提下实现了较好的还原效果，基本可以满足二次创作的核心需求。此外，由于FVP引擎在《星空のメモリア》《いろとりどりのセカイ》等多部经典作品中保持了高度一致的架构，本研究的所有方法与成果理论上完全可以直接迁移至这些游戏。

当然，受限于研究时间与个人精力，本工作仍存在一定的局限性。首先，部分复杂交互功能尚未完全解析，包括立绘跳动、镜头缩放与平移等高级转场演出，以及存档读档、系统设置等底层系统函数。其次，当前的简易高级脚本仅支持线性及简单的选择支剧情的编写，缺乏变量、循环、条件判断等高级语法特性，难以实现复杂的剧情分支与状态管理。

基于现有成果与局限性，未来的工作可以从以下几个方向展开深入探索：

第一，核心功能的补全与深化。优先攻克变量设定与分支剧情逻辑的实现问题，之后可进一步逆向镜头控制等复杂演出功能以完善演出效果的还原度。

第二，工具可用性便捷性的提高。开发GUI图形化界面，同时实现简单的参数设定效果预览功能，便于操作者编译及调试。

[参考文献]

[1]akerou.fvp.[CP/OL].(2015-06-02)[2026-05-20].https://github.com/akerou/fvp

[2]neo_autism.就算是笨蛋笨蛋也能用的星空的记忆HD汉化版制作指南.[EB/OL].https://tieba.baidu.com/p/7354039956

[3]lilith.关于星空hd自制汉化的一些记录.[EB/OL].(2023-02-18)[2026-05-20].https://tieba.baidu.com/p/8270839659

[4]ArisuMika520.FVP-Yuki[CP/OL].(2026-04-17)[2026-05-20].https://github.com/ArisuMika520/FVP-Yuki

[5]amaranthf.FAVORITE引擎VM及脚本结构分析[EB/OL].(2011-09-26)[2025-02-17].https://bbs.sumisora.net/read.php?tid=11010281

[6]xmoezzz.rfvp[CP/OL].(2026-04-19)[2026-04-19].https://github.com/xmoezzz/rfvp

[致谢]

本文的研究工作深深受惠于FVP引擎同人技术社区的智慧开源与无私分享。感谢萧桀79的相关探索与分享，激发了笔者对FVP引擎的兴趣。感谢amaranthf对.hcb字节码指令集的先驱性解析[1]。感谢akerou开发的fvp工具[2]、lilith提供的Python拆解脚本[4]、ArisuMika520开发的FVP-Yuki图形化工具[5]以及xmoezzz的rfvp项目[6]；这些覆盖反编译、回封与中文化的工作，共同构成本文技术路线不可或缺的参照系与灵感来源。此外，本文在工具开发与复杂函数逻辑的分析过程中得到了大语言模型的有力辅助，并感谢LifeCheckpoint在AI工具的调度与运用上提供的悉心指导。最后，向所有在社区中为FVP引擎游戏倾注热情的探索者致以诚挚的敬意。