﻿《らずべりー》简体中文补丁 v1.9——安装与启动说明
================================================

适用对象
--------
本补丁用于已经拥有并完整安装《らずべりー》日文原版的玩家。补丁集成了 Ver1.04
更新内容、中文脚本（含脚本中的分支选项）、中文运行模块，以及标题、设置、存读档
和确认框等核心中文界面。


一、安装前请先确认
------------------
1. 必须先把游戏完整安装或解压到硬盘。不要把补丁装进 ISO、压缩包、Disc1、Disc2
   或 update 文件夹。
2. 游戏目录应直接包含 raspberry.exe，并同时具有 pac、module 两个子文件夹，例如：

       D:\Games\RASPBERRY\raspberry.exe
       D:\Games\RASPBERRY\pac\
       D:\Games\RASPBERRY\module\

3. 建议使用简短路径，并避开 Program Files、Windows、桌面同步盘等受保护目录。
4. 先退出游戏；再打开任务管理器，确认 raspberry.exe 和 sydxmm.exe 均已结束。
5. 补丁兼容干净日文原版，并会同时部署官方 Ver1.04 核心文件和中文运行模块；
   已经更新到 Ver1.04 的原版也可直接安装。请勿把其他改版的 exe、sydxmm.exe 或
   update.ypf 混入同一目录。
6. 安装补丁前备份存档：复制整个“游戏目录\save”文件夹到别处。尤其是从
   Ver1.00 更新时，官方 Ver1.04 更新可能使旧存档失效；本补丁也不建议跨版本
   继续使用旧进度。


二、安装汉化补丁
----------------
1. 将补丁压缩包完整解压到一个临时文件夹，不要直接在压缩软件预览窗口中运行。
2. 双击补丁目录内的安装程序（或“安装汉化补丁”批处理文件）。
3. 选择“游戏根目录”，也就是 raspberry.exe 所在的文件夹，而不是 pac 或 module。
4. 等待文件检查、备份和写入全部完成。安装器会处理以下六项核心文件：

       raspberry.exe
       module\MSVCRT.DLL
       module\sydxmm.exe
       pac\dat_BN.ypf
       pac\dat_CG.ypf
       pac\update.ypf

5. 看到安装成功提示后再关闭窗口。若提示版本或目录不匹配，请检查是否选错
   文件夹、是否漏装 Ver1.04、文件是否曾被其他补丁修改，然后用干净原版重新安装。
6. 补丁生成的备份目录和安装日志请保留；卸载或排查问题时会用到。
7. 若已经安装过 v1.0、v1.1、v1.1.1、v1.2、v1.3、v1.4、v1.5、v1.6、v1.7 或 v1.8，可直接运行 v1.9 安装程序完成升级；最初的日文原版备份会
   继续保留，之后仍可通过卸载程序恢复。


三、正常启动方法
----------------
1. 从游戏根目录双击 raspberry.exe。sydxmm.exe 是运行模块，不要单独启动。
2. v1.9 已增加入口与失败分支双重免光盘处理，启动时无需装载 ISO 或插入 GameDisc 1。
3. 首次启动可能被安全软件询问，请允许本地程序运行。若文件被隔离，请恢复文件、
   将游戏目录加入信任列表，然后重新执行补丁安装。
4. v1.9 中文运行模块会将 CP936 文本显式转换为 Unicode 后绘制，不再依赖系统的
   “非 Unicode 程序语言”。简体中文或日语系统区域均可运行。
5. 不要把 v1.9 的 raspberry.exe、sydxmm.exe 与旧补丁或日文版文件混用。v1.9 会把
   中文脚本和中文界面直接写入基础资源包 dat_BN.ypf、dat_CG.ypf，不再只依赖
   update.ypf 的同名覆盖。若正文仍乱码或按钮仍为日文，通常表示启动了另一份游戏；
   重新运行 v1.9 安装程序，并确认选择了当前游戏目录。


四、片头影片（MCI）报错或黑屏
----------------------------
该旧引擎会调用 Windows 多媒体/MCI 组件。部分新系统会因影片解码、声音输出设备或
MCI 环境而报错。游戏正文资源本身通常没有损坏。遇到片头报错、黑屏或一启动就停在
影片阶段时，可先强制跳过片头：

1. 退出游戏，并备份游戏根目录中的 cfgm.dat（若存在）。
2. 让 cfgm.dat 成为恰好 2 字节的二进制文件，内容为：00 01。
3. 最简便的方法是在游戏根目录打开 PowerShell，执行：

       [IO.File]::WriteAllBytes((Join-Path (Get-Location) 'cfgm.dat'),[byte[]](0x00,0x01))

4. 再运行 raspberry.exe。此设置只跳过影片，不影响正文、语音和存档。
5. 如果 cfgm.dat 已经是 00 01，仍在 winmmbase.dll 中发生 0xc0000005（已知测试位置
   可显示为偏移 0x5273），请继续执行以下操作：
   （1）在 Windows“设置 → 系统 → 声音”中确认存在一个已启用的默认声音输出设备；
   （2）打开 services.msc，确认“Windows Audio”服务正在运行；
   （3）重启 Windows 后再试，不要只反复结束游戏进程；
   （4）避免在远程桌面、虚拟机未挂载声卡、禁用声卡或完全没有音频设备的环境运行；
   （5）最后再给 raspberry.exe 尝试“Windows XP（Service Pack 3）”兼容模式。

实机对照测试中，汉化运行时和完整原版 Ver1.04 运行文件配合官方 update.ypf 均出现
同类 winmmbase.dll 崩溃；即使 cfgm.dat 为 00 01 也可能发生。因此这种特定崩溃属于
当前 Windows 多媒体/MCI 环境问题，与汉化文本包无关。提交反馈时请明确写出故障模块
winmmbase.dll、异常代码和偏移。


五、双击后没有窗口，但后台留有进程
----------------------------------
请依次执行：

1. 在任务管理器中结束残留的 raspberry.exe、sydxmm.exe，再重新启动。
2. 检查 module\sydxmm.exe 是否存在，并重新执行补丁安装以恢复配套文件。原版旧模块
   或版本混搭也可能触发 0xc0000005，但该代码本身不能直接证明是汉化文件造成的；
   若故障模块明确为 winmmbase.dll，请优先按上一节排查 Windows 多媒体/声音环境。
3. 右键 raspberry.exe → 属性 → 兼容性，先清除“Windows 98/Windows Me”兼容模式。
   该模式在新系统上可能导致后台崩溃或 0xc0000005，不应作为首选。
4. 仍有问题时，再按顺序尝试：
   （1）勾选“禁用全屏优化”；
   （2）使用“Windows XP（Service Pack 3）”兼容模式；
   （3）以管理员身份运行。
   每次只改变一项，以便判断是哪项生效。
5. 若进程出现在片头阶段，按上一节写入 cfgm.dat 以跳过 MCI 影片。若已经是 00 01，
   仍报告 winmmbase.dll、0xc0000005 或偏移 0x5273，则检查默认声音输出设备和
   Windows Audio 服务，重启系统，并避免无音频设备的远程/虚拟环境。
6. 检查安全软件的隔离记录；不要从不明网站单独下载 sydxmm.exe 或 DLL 覆盖补丁文件。


六、文字、选项或字体显示异常
----------------------------
1. v1.9 启动时不再检查 GameDisc 1，完整安装或完整解压后可直接运行。
2. v1.9 重新设计了标题菜单、设置、存读档及确认框，修复日文轮廓残影、遮罩裁字及
   “是／否”普通状态不显示的问题；正文 66 张角色姓名牌也已汉化。
3. v1.9 重新绘制保存与读取页面的 90 张界面资源，包括标题、返回、确认框、页码、
   存档槽及普通/悬停状态；中文标题与遮罩同步生成，消除粉色碎块和日文轮廓。
4. v1.9 移除存档槽内遮挡正文的横线，改用均匀轻透底色；主界面、保存和读取确认框
   统一为暗红渐变面板，底板完整显示，不再透出游戏画面。
5. v1.9 修正 75 项存档日期编码，星期显示为中文；应用标题统一为 Raspberry  Ver1.04，
   点击关闭按钮后的退出询问显示为“确定要退出游戏吗？”。
6. 中文显示成日文乱码：常见原因是运行了日文版 raspberry.exe/sydxmm.exe、使用了
   日语区域模拟器，或六个核心文件版本不一致。退出游戏后重新安装补丁。
7. 方框、缺字：确认系统安装了“宋体（SimSun）”和“微软雅黑（Microsoft YaHei）”。
8. 选项文字错位、空白或在选择后停止：记录该选项前的一句对白、当前路线及存档，
   并按第九节提交反馈。


七、存档注意事项
----------------
1. 存档位于“游戏目录\save”。备份时请复制整个 save 文件夹，而非只复制单个编号
   存档；全局标志和系统数据也在其中。
2. 更新、重装、卸载前都建议备份 save。
3. 不同游戏版本、其他汉化版或经过修改的脚本可能与当前存档不兼容。遇到循环、
   跳错章节或读档即报错时，先把 save 临时移走，用新游戏验证。
4. 移走存档前先退出游戏。确认新游戏正常后，再逐步放回备份进行判断。


八、卸载与恢复日文原版
----------------------
1. 退出游戏并备份 save。
2. 运行补丁附带的卸载程序（或“卸载汉化补丁”批处理文件），选择安装时使用的同一
   游戏根目录。卸载器将从安装备份恢复 raspberry.exe、module\MSVCRT.DLL、
   module\sydxmm.exe、pac\dat_BN.ypf、pac\dat_CG.ypf 和 pac\update.ypf。
3. 卸载一般不删除 save；操作前仍应自行备份。
4. 若备份遗失，请从自己的日文原版重新安装，再应用官方 Ver1.04 更新。不要只恢复
   六个文件中的一部分，否则容易形成版本混搭。
5. 恢复纯日文原版后，文字编码需求也会恢复为 CP932/日语环境；该设置与汉化版的
   GBK/CP936 环境不同。


九、故障反馈
------------
反馈时请提供 Windows 版本、游戏路径、补丁版本、安装日志、错误提示截图、问题发生阶段，以及是否启用了兼容模式或区域模拟器。若问题可由特定存档稳定复现，可附上该存档并注明读取位置。


快速排错顺序
------------
结束后台残留进程 → 确认选中正确游戏根目录 → 重新安装补丁 → 清除 Win98 兼容模式
→ 写入 00 01 的 cfgm.dat 跳过片头 → 若仍报 winmmbase.dll 则检查默认声音设备和
Windows Audio、重启并避免无音频设备环境 → 检查中文区域与字体 → 用空 save
测试新游戏 → 收集日志和截图反馈。
