silksong-coop-mod 0.4.23 → 0.4.24

package/INSTALL.bat

@@ -1,16 +1,16 @@
-@echo off
-chcp 65001 >nul 2>&1
-title Silksong co-op (SSMP) installer
-
-rem Runs the real installer next to this file. -ExecutionPolicy Bypass applies to this one run only and changes
-rem nothing on the machine. pwsh is preferred when present, because it handles text encoding better.
-
-where pwsh >nul 2>&1
-if %errorlevel%==0 (
-    pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0install.ps1"
-) else (
-    powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0install.ps1"
-)
-
-echo.
-pause
+@echo off
+chcp 65001 >nul 2>&1
+title Silksong co-op (SSMP) installer
+
+rem Runs the real installer next to this file. -ExecutionPolicy Bypass applies to this one run only and changes
+rem nothing on the machine. pwsh is preferred when present, because it handles text encoding better.
+
+where pwsh >nul 2>&1
+if %errorlevel%==0 (
+    pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0install.ps1"
+) else (
+    powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0install.ps1"
+)
+
+echo.
+pause

package/INSTALL.txt

@@ -1,258 +1,258 @@
-丝之歌联机模组（SSMP 自制版）——一键安装
-==========================================
-
-这是 SSMP 联机模组的一个自制版本，比公开版多了「双人存档」：
-两个人共用一条流程，任务、世界变化、剧情道具会互相同步。
-
-重要：两个人必须装【同一份】这个压缩包，不能一个人用公开版。
-
-     【从这一版开始，版本不一致会被直接拦住。】
-     加入房间时会比对双方的版本，不一样就不让连，并且明确告诉你
-     「你们装的版本不同」，而不是连上之后表现出一堆对不上的怪事。
-
-     ※ 代价是：这一版【不认识任何旧版本】。
-       所以【两个人必须一起换成这一版】，只有一个人装的话，
-       你们会连不上——这是正常的，不是坏了。
-       这笔账只付一次，以后就不会再有「一个人更了一个人没更」还不知情的情况。
-
-     （顺带更正我之前在这里写错的话：我原先说「版本不一致配对时会提示」，
-       那时候是【不对的】，当时根本没有任何东西在比对版本。现在才是真的。）
-
-【这个包是完全离线的】模组加载器已经放在包里，
-安装过程不需要联网，不用梯子，也不受任何网站能不能打开的影响。
-
-
-一、怎么装（双击一下就行）
---------------------------
-
-1. 把这个压缩包【完整解压】到任意位置（比如桌面）。
-   不要只解压出单个文件，INSTALL.bat、SSMP 文件夹和
-   BepInEx_win_x64_5.4.23.4.zip 必须在一起。
-
-2. 双击 INSTALL.bat。
-
-3. 等它跑完，看到绿色的 Done 就好了。
-
-它会自己做这几件事：
-   - 找到你的 Silksong 安装位置（找不到会让你把路径粘进去）
-   - 先把你的存档备份成 zip，放在这个文件夹里的 save-backups\ 下
-     （只留最近 3 份，更旧的会自动删掉；它不会碰别的文件）
-   - 用包里自带的加载器装好（不联网）
-   - 把联机插件放进去
-   - 最后检查一遍有没有装成功
-
-窗口里的提示是英文的，因为 Windows 自带的 PowerShell 显示中文
-经常是乱码，英文反而不会出错。
-
-
-二、这个脚本安全吗
-------------------
-
-- 它只往【游戏目录】写东西，外加一个存档备份。
-  不改注册表、不改系统设置、不装任何后台程序、不联网。
-- 不需要管理员权限（除非你的游戏装在 C:\Program Files 里）。
-- 想卸载：把游戏目录里的 BepInEx 文件夹、winhttp.dll、
-  doorstop_config.ini、.doorstop_version、changelog.txt
-  删掉就完全干净了。
-
-包里那个 BepInEx_win_x64_5.4.23.4.zip 是 BepInEx 官方在 GitHub
-上发布的原版文件，没有改动过，大小 638,940 字节。
-
-有一点要提前说：BepInEx 这类模组加载器的工作方式，是在游戏
-exe 旁边放一个 dll，让游戏启动时连带加载它。这是所有同类
-加载器的通用做法，但这个手法和某些恶意软件相同，所以
-【杀毒软件有时会报毒】。看到告警是这个原因，不是脚本在干别的。
-
-真正的风险不在系统，在存档：模组有可能弄坏存档，
-所以脚本会先备份。
-
-
-三、怎么一起玩
---------------
-
-1. 【从 Steam 启动游戏】，不要直接双击 exe。
-
-2. 一个人开房：选 "Steam" 那一页，点 Create Lobby。
-   开完房不会直接进游戏，而是停在一个【等待室】里。
-
-3. 房主在等待室里点 INVITE FRIEND，会直接弹出 Steam 的邀请框，
-   不用自己去找 Steam 覆盖层。对方接受邀请就会进到同一个等待室。
-
-4. 两个人各自点一次 I'M READY。
-   名单上能看到对方是 READY 还是 NOT READY。
-   【两个人都 READY 之后】，两边才会同时打开各自的选存档界面。
-   反悔就再点一次取消。
-
-5. 进游戏后，屏幕上方会出现一行字，
-   写着「按 L 和 XXX 组成双人存档」。
-   两个人都按一下 L 就配对好了。
-   不想配对就别理它，它会自己消失。
-
-   【用手柄的话按下左摇杆（L3）】，和 L 是同一件事。
-   屏幕上那行字会自己判断你在用键盘还是手柄，显示你真正该按的那个。
-
-   （配对键原来是 J，这一版改成了 L。因为 J 是游戏自己
-     「打开背包并翻到笔记页」的默认键，按一下会同时干两件事。
-     L 在游戏的默认键位里没人用。）
-
-6. 之后这两个存档必须两个人都在线才能打开。
-   如果对方不来、或者两边一直停在「Waiting for XXX」不动，
-   你会被定住不能移动，屏幕上会写着在等谁。
-   【这时按 K】就能退出双人存档、自己单独玩。
-   注意：这只解开你这边，对方要自己也按一次 K。
-
-   ※ 不要去聊天框打 /coopsave off。被定住的时候聊天框打不开；
-     而且只要对方还在线，那条指令也只是【请求对方同意】，
-     并不会放你走。K 才是真正的出路。
-
-
-四、第一次玩的建议
-------------------
-
-* 两个人都【开新档】。
-  配对会检查双方已击败的 Boss 是否一致，老档大概率对不上。
-
-* 连接和等待室都已经实测跑通过（中国 ↔ 马来西亚，走 Steam 中继）。
-
-* 【之前卡在「Waiting for XXX」的原因已经找到并修掉了】
-  服务器把所有玩家的网络数据放在同一个拼包缓冲区里，而且是先拼字节、
-  后判断这包是谁发的。双人存档要同步的世界进度是全游戏唯一一个
-  大到需要拆包发送的数据，一拆包，两个人的数据就会被粘在一起，
-  连接的分帧从此错乱、五秒后超时重连，于是校验永远走不完。
-
-  这也解释了为什么配对、聊天、看到对方走路一直都正常——
-  那些包都很小，从来不需要拆。
-
-  现在每条连接各用各的缓冲区。
-  【这个修复已经实机验证通过】，两个人已经正常连上并一起玩过了。
-  万一还卡：按 K 脱身，然后把两边的日志都发回来。
-
-  备份脚本会自动做，位置见上面第一节。
-
-* 【从这一版开始，敌人和 Boss 才是真正同步的】
-  在这之前，控制这件事的开关默认是关的，而且没有任何界面能打开它，
-  所以你们其实是各打各的：同一只怪在你这边死了、在她那边还站着，
-  打完的记录也只记在动手的那个人身上。
-  现在这个开关被固定为常开，配置文件里存着的旧设置不再起作用。
-  【两个人都必须重装这一版】，只有一个人装是没用的。
-
-  顺带说一句：Boss 的击败记录本来就是各记各的，不会互相抄，
-  这是当初定好的规则（剧情进度共享，战绩和拾取各归各的）。
-  所以如果一个人已经打过、另一个人没打过，
-  那只怪在没打过的那个人的世界里还在，两个人可以一起再打一遍，
-  这次两边都会拿到记录。
-
-* 【茧：平时各看各的；但你死了之后，队友可以把你拉起来】
-  平时的规则没变：你只看得见【自己】的茧，对方也碰不到你的。
-
-  新加的是救人。你死掉之后【不会立刻回长椅】，会先在原地等一会儿，
-  最多 45 秒。这段时间里，你的茧会出现在【队友】那边，
-  她打【5 下】就能把你拉起来：
-  在你倒下的地方站起来，血量是你上限的【一半】（向下取整），
-  茧里的钱和丝也一起还给你，等于这一次没白死。
-
-  等的时候屏幕上有一行字，写着在等谁、对方已经打了几下。
-  不想等了就【按 K】，立刻回长椅、按原来的规则结算，
-  你的茧同时从队友那边消失。等满 45 秒没人来，也一样自动回长椅。
-  （注意：这里的 K 只是「不等了」，不会解除你们的双人存档。）
-
-  【两个人都死了，就都直接回长椅】，不会互相干等，
-  也不会出现谁站在那儿等一个同样躺着的人。
-
-  这一条是刚写的，【还没有实机验证过】。
-  真卡住不动了（按理说等满 45 秒一定会自己回长椅），
-  Alt+F4 强退就行，存档还停在上一次保存的地方。
-
-  这里原本藏着一个很隐蔽的问题，已经修掉：
-  两个人的茧在各自游戏里【名字完全一样】，而模组会把「打碎世界物件」
-  这类命中按名字转发给对方重放。于是她打她自己的茧，
-  你这边被打碎的是【你的】茧——而且和你们死在哪儿没关系，
-  隔着半个房间照样会中。茧里的钱是记在存档里的，
-  被这样打掉会直接结算掉、还会抹掉你那个茧的记录。
-  现在茧被排除在转发之外，对方攻击的副本也碰不到它。
-  你自己打自己的茧，一切照旧。
-
-* 【修掉了「后进房间的人，满屋子怪全定住」】
-  只要你走进一个对方已经清过的房间，那些怪在你这边会全部卡死不动。
-  原因是服务器只记得「这怪没血了」，却不记得「它死过」，
-  于是你这边的怪变成了一具零血的活尸：它每一帧都想死，
-  每一帧都被模组挡回去，一个房间能刷出七千多次，整屋子就此卡住。
-  现在补状态时会把这类怪真正结算掉一次，进门看到的是尸体而不是活尸。
-
-* 【昵称会记住了】
-  以前只有「直连 IP」和「直连开房」两条路会保存昵称，而你们用的是 Steam
-  开房 / 加入 / 房间列表，这几条一条都不保存 —— 所以不是你忘了填，
-  是它在你的用法下从来没存过。现在填一次就记住，下次自动带出来。
-
-* 【进游戏之后不用再碰键盘了】
-  配对（L）和放弃等待（K）这两个动作，手柄都可以【按下左摇杆】来完成。
-  选左摇杆是因为它是游戏唯一没占用的按钮 —— 扳机、肩键、四个面键、
-  右摇杆按下、旁边那两个键，游戏全都用掉了。
-  这两个动作不会同时出现（没配对时才问你要不要配对，配对了才谈得上放弃），
-  所以共用一个键不会冲突。
-  聊天键故意没给手柄绑：手柄本来就打不了字，绑了也只是开一个填不进去的框。
-
-  ※ 联机大厅（连接、房间列表、等待室）目前仍然要用鼠标键盘，这是你定的。
-
-* 【手柄在选存档界面按不进去，这一版尝试修了】
-  原因是模组会自己建一套界面输入系统，而负责「在菜单里把它关掉」的代码
-  是挂在场景切换上的 —— 但模组本身就是在主菜单里启动的，此后到进游戏
-  之前根本不会再切场景，所以它整个菜单流程都开着。现在它一建出来
-  就先判断一次当前场景。
-
-  顺便解释那个最奇怪的地方：为什么手柄能上下切换存档却按不进去，
-  键盘却可以。游戏判定「确认」时分成两支——
-  键盘那支除了确认键还认【跳跃键】，手柄那支【只认确认键】，没有替补。
-  所以确认信号一旦出不来，键盘还有后路，手柄直接没辙。
-
-  ※ 这一条【没有实机验证过】。如果还是按不进去，
-    把游戏目录下 BepInEx\LogOutput.log 发我：这一版特意在进选存档界面时
-    写了一行「Save selection is driven by ...」，那行字会直接说明
-    是谁在管这个界面，不用再猜。
-
-* 聊天框默认按 Y 打开，打 /help 可以看到所有指令。
-
-* 【修掉了「在聊天框打字会误触发快捷键」】
-  以前模组只屏蔽了游戏自己的操作，没屏蔽它自己的快捷键。
-  所以在聊天框里打一句带 k 的话（比如「ok」）就等于按了一次 K ——
-  配上新的救人机制，那就是当场放弃等救援、直接回长椅；
-  打带配对键的字则会发一次配对请求。
-  现在聊天框一打开，模组自己的快捷键就整个关掉，关掉聊天再恢复。
-  另外 Enter 以前在聊天关着的时候也会白触发一次，现在不会了。
-
-* 【模组界面跟着游戏语言走】
-  以前模组自己的字全是英文，游戏明明是中文的，
-  一到模组这儿就换语言。
-  现在游戏设成中文，联机界面、聊天里的提示、
-  等人和救人的提示都是中文；设成别的语言还是英文。
-  在游戏选项里中途换语言也会立刻跟着变，不用重开游戏。
-
-
-五、出问题的话
---------------
-
-游戏目录下 BepInEx\LogOutput.log 是日志，
-出问题把它发回来就能定位。
-
-如果是卡在「Waiting for XXX」，日志里这两句最有用：
-  Starting a check     —— 会列出三个存档 key，一眼能看出哪个对不上
-  Turned down a hello  —— 说明有一条握手消息被丢掉了，以及丢的原因
-
-
-六、这东西是谁写的
-------------------
-
-联机功能本身、以及这里几乎全部的代码，都是 Extremelyd1 写的
-（原项目：github.com/Extremelyd1/SSMP）。
-这一份只是在它上面加了「两个人共用一条流程」的双人存档，
-沿用和原作相同的 LGPL-2.1 许可证。
-
-※ 有任何问题请找我，【不要去原作者的 Discord 或 issues 页面】。
-  这些改动不是人家写的，人家既复现不了也没义务解释。
-
-包里还有两个别人的东西：
-  BouncyCastle.Cryptography.dll —— 第三方加密库，MIT 许可证，
-    版权归 The Legion of the Bouncy Castle Inc.，
-    完整条款见同目录下的 LICENSE-BouncyCastle.md。
-  BepInEx_win_x64_5.4.23.4.zip —— BepInEx 官方发布的原包，
-    一个字节都没有改过。
+丝之歌联机模组（SSMP 自制版）——一键安装
+==========================================
+
+这是 SSMP 联机模组的一个自制版本，比公开版多了「双人存档」：
+两个人共用一条流程，任务、世界变化、剧情道具会互相同步。
+
+重要：两个人必须装【同一份】这个压缩包，不能一个人用公开版。
+
+     【从这一版开始，版本不一致会被直接拦住。】
+     加入房间时会比对双方的版本，不一样就不让连，并且明确告诉你
+     「你们装的版本不同」，而不是连上之后表现出一堆对不上的怪事。
+
+     ※ 代价是：这一版【不认识任何旧版本】。
+       所以【两个人必须一起换成这一版】，只有一个人装的话，
+       你们会连不上——这是正常的，不是坏了。
+       这笔账只付一次，以后就不会再有「一个人更了一个人没更」还不知情的情况。
+
+     （顺带更正我之前在这里写错的话：我原先说「版本不一致配对时会提示」，
+       那时候是【不对的】，当时根本没有任何东西在比对版本。现在才是真的。）
+
+【这个包是完全离线的】模组加载器已经放在包里，
+安装过程不需要联网，不用梯子，也不受任何网站能不能打开的影响。
+
+
+一、怎么装（双击一下就行）
+--------------------------
+
+1. 把这个压缩包【完整解压】到任意位置（比如桌面）。
+   不要只解压出单个文件，INSTALL.bat、SSMP 文件夹和
+   BepInEx_win_x64_5.4.23.4.zip 必须在一起。
+
+2. 双击 INSTALL.bat。
+
+3. 等它跑完，看到绿色的 Done 就好了。
+
+它会自己做这几件事：
+   - 找到你的 Silksong 安装位置（找不到会让你把路径粘进去）
+   - 先把你的存档备份成 zip，放在这个文件夹里的 save-backups\ 下
+     （只留最近 3 份，更旧的会自动删掉；它不会碰别的文件）
+   - 用包里自带的加载器装好（不联网）
+   - 把联机插件放进去
+   - 最后检查一遍有没有装成功
+
+窗口里的提示是英文的，因为 Windows 自带的 PowerShell 显示中文
+经常是乱码，英文反而不会出错。
+
+
+二、这个脚本安全吗
+------------------
+
+- 它只往【游戏目录】写东西，外加一个存档备份。
+  不改注册表、不改系统设置、不装任何后台程序、不联网。
+- 不需要管理员权限（除非你的游戏装在 C:\Program Files 里）。
+- 想卸载：把游戏目录里的 BepInEx 文件夹、winhttp.dll、
+  doorstop_config.ini、.doorstop_version、changelog.txt
+  删掉就完全干净了。
+
+包里那个 BepInEx_win_x64_5.4.23.4.zip 是 BepInEx 官方在 GitHub
+上发布的原版文件，没有改动过，大小 638,940 字节。
+
+有一点要提前说：BepInEx 这类模组加载器的工作方式，是在游戏
+exe 旁边放一个 dll，让游戏启动时连带加载它。这是所有同类
+加载器的通用做法，但这个手法和某些恶意软件相同，所以
+【杀毒软件有时会报毒】。看到告警是这个原因，不是脚本在干别的。
+
+真正的风险不在系统，在存档：模组有可能弄坏存档，
+所以脚本会先备份。
+
+
+三、怎么一起玩
+--------------
+
+1. 【从 Steam 启动游戏】，不要直接双击 exe。
+
+2. 一个人开房：选 "Steam" 那一页，点 Create Lobby。
+   开完房不会直接进游戏，而是停在一个【等待室】里。
+
+3. 房主在等待室里点 INVITE FRIEND，会直接弹出 Steam 的邀请框，
+   不用自己去找 Steam 覆盖层。对方接受邀请就会进到同一个等待室。
+
+4. 两个人各自点一次 I'M READY。
+   名单上能看到对方是 READY 还是 NOT READY。
+   【两个人都 READY 之后】，两边才会同时打开各自的选存档界面。
+   反悔就再点一次取消。
+
+5. 进游戏后，屏幕上方会出现一行字，
+   写着「按 L 和 XXX 组成双人存档」。
+   两个人都按一下 L 就配对好了。
+   不想配对就别理它，它会自己消失。
+
+   【用手柄的话按下左摇杆（L3）】，和 L 是同一件事。
+   屏幕上那行字会自己判断你在用键盘还是手柄，显示你真正该按的那个。
+
+   （配对键原来是 J，这一版改成了 L。因为 J 是游戏自己
+     「打开背包并翻到笔记页」的默认键，按一下会同时干两件事。
+     L 在游戏的默认键位里没人用。）
+
+6. 之后这两个存档必须两个人都在线才能打开。
+   如果对方不来、或者两边一直停在「Waiting for XXX」不动，
+   你会被定住不能移动，屏幕上会写着在等谁。
+   【这时按 K】就能退出双人存档、自己单独玩。
+   注意：这只解开你这边，对方要自己也按一次 K。
+
+   ※ 不要去聊天框打 /coopsave off。被定住的时候聊天框打不开；
+     而且只要对方还在线，那条指令也只是【请求对方同意】，
+     并不会放你走。K 才是真正的出路。
+
+
+四、第一次玩的建议
+------------------
+
+* 两个人都【开新档】。
+  配对会检查双方已击败的 Boss 是否一致，老档大概率对不上。
+
+* 连接和等待室都已经实测跑通过（中国 ↔ 马来西亚，走 Steam 中继）。
+
+* 【之前卡在「Waiting for XXX」的原因已经找到并修掉了】
+  服务器把所有玩家的网络数据放在同一个拼包缓冲区里，而且是先拼字节、
+  后判断这包是谁发的。双人存档要同步的世界进度是全游戏唯一一个
+  大到需要拆包发送的数据，一拆包，两个人的数据就会被粘在一起，
+  连接的分帧从此错乱、五秒后超时重连，于是校验永远走不完。
+
+  这也解释了为什么配对、聊天、看到对方走路一直都正常——
+  那些包都很小，从来不需要拆。
+
+  现在每条连接各用各的缓冲区。
+  【这个修复已经实机验证通过】，两个人已经正常连上并一起玩过了。
+  万一还卡：按 K 脱身，然后把两边的日志都发回来。
+
+  备份脚本会自动做，位置见上面第一节。
+
+* 【从这一版开始，敌人和 Boss 才是真正同步的】
+  在这之前，控制这件事的开关默认是关的，而且没有任何界面能打开它，
+  所以你们其实是各打各的：同一只怪在你这边死了、在她那边还站着，
+  打完的记录也只记在动手的那个人身上。
+  现在这个开关被固定为常开，配置文件里存着的旧设置不再起作用。
+  【两个人都必须重装这一版】，只有一个人装是没用的。
+
+  顺带说一句：Boss 的击败记录本来就是各记各的，不会互相抄，
+  这是当初定好的规则（剧情进度共享，战绩和拾取各归各的）。
+  所以如果一个人已经打过、另一个人没打过，
+  那只怪在没打过的那个人的世界里还在，两个人可以一起再打一遍，
+  这次两边都会拿到记录。
+
+* 【茧：平时各看各的；但你死了之后，队友可以把你拉起来】
+  平时的规则没变：你只看得见【自己】的茧，对方也碰不到你的。
+
+  新加的是救人。你死掉之后【不会立刻回长椅】，会先在原地等一会儿，
+  最多 45 秒。这段时间里，你的茧会出现在【队友】那边，
+  她打【5 下】就能把你拉起来：
+  在你倒下的地方站起来，血量是你上限的【一半】（向下取整），
+  茧里的钱和丝也一起还给你，等于这一次没白死。
+
+  等的时候屏幕上有一行字，写着在等谁、对方已经打了几下。
+  不想等了就【按 K】，立刻回长椅、按原来的规则结算，
+  你的茧同时从队友那边消失。等满 45 秒没人来，也一样自动回长椅。
+  （注意：这里的 K 只是「不等了」，不会解除你们的双人存档。）
+
+  【两个人都死了，就都直接回长椅】，不会互相干等，
+  也不会出现谁站在那儿等一个同样躺着的人。
+
+  这一条是刚写的，【还没有实机验证过】。
+  真卡住不动了（按理说等满 45 秒一定会自己回长椅），
+  Alt+F4 强退就行，存档还停在上一次保存的地方。
+
+  这里原本藏着一个很隐蔽的问题，已经修掉：
+  两个人的茧在各自游戏里【名字完全一样】，而模组会把「打碎世界物件」
+  这类命中按名字转发给对方重放。于是她打她自己的茧，
+  你这边被打碎的是【你的】茧——而且和你们死在哪儿没关系，
+  隔着半个房间照样会中。茧里的钱是记在存档里的，
+  被这样打掉会直接结算掉、还会抹掉你那个茧的记录。
+  现在茧被排除在转发之外，对方攻击的副本也碰不到它。
+  你自己打自己的茧，一切照旧。
+
+* 【修掉了「后进房间的人，满屋子怪全定住」】
+  只要你走进一个对方已经清过的房间，那些怪在你这边会全部卡死不动。
+  原因是服务器只记得「这怪没血了」，却不记得「它死过」，
+  于是你这边的怪变成了一具零血的活尸：它每一帧都想死，
+  每一帧都被模组挡回去，一个房间能刷出七千多次，整屋子就此卡住。
+  现在补状态时会把这类怪真正结算掉一次，进门看到的是尸体而不是活尸。
+
+* 【昵称会记住了】
+  以前只有「直连 IP」和「直连开房」两条路会保存昵称，而你们用的是 Steam
+  开房 / 加入 / 房间列表，这几条一条都不保存 —— 所以不是你忘了填，
+  是它在你的用法下从来没存过。现在填一次就记住，下次自动带出来。
+
+* 【进游戏之后不用再碰键盘了】
+  配对（L）和放弃等待（K）这两个动作，手柄都可以【按下左摇杆】来完成。
+  选左摇杆是因为它是游戏唯一没占用的按钮 —— 扳机、肩键、四个面键、
+  右摇杆按下、旁边那两个键，游戏全都用掉了。
+  这两个动作不会同时出现（没配对时才问你要不要配对，配对了才谈得上放弃），
+  所以共用一个键不会冲突。
+  聊天键故意没给手柄绑：手柄本来就打不了字，绑了也只是开一个填不进去的框。
+
+  ※ 联机大厅（连接、房间列表、等待室）目前仍然要用鼠标键盘，这是你定的。
+
+* 【手柄在选存档界面按不进去，这一版尝试修了】
+  原因是模组会自己建一套界面输入系统，而负责「在菜单里把它关掉」的代码
+  是挂在场景切换上的 —— 但模组本身就是在主菜单里启动的，此后到进游戏
+  之前根本不会再切场景，所以它整个菜单流程都开着。现在它一建出来
+  就先判断一次当前场景。
+
+  顺便解释那个最奇怪的地方：为什么手柄能上下切换存档却按不进去，
+  键盘却可以。游戏判定「确认」时分成两支——
+  键盘那支除了确认键还认【跳跃键】，手柄那支【只认确认键】，没有替补。
+  所以确认信号一旦出不来，键盘还有后路，手柄直接没辙。
+
+  ※ 这一条【没有实机验证过】。如果还是按不进去，
+    把游戏目录下 BepInEx\LogOutput.log 发我：这一版特意在进选存档界面时
+    写了一行「Save selection is driven by ...」，那行字会直接说明
+    是谁在管这个界面，不用再猜。
+
+* 聊天框默认按 Y 打开，打 /help 可以看到所有指令。
+
+* 【修掉了「在聊天框打字会误触发快捷键」】
+  以前模组只屏蔽了游戏自己的操作，没屏蔽它自己的快捷键。
+  所以在聊天框里打一句带 k 的话（比如「ok」）就等于按了一次 K ——
+  配上新的救人机制，那就是当场放弃等救援、直接回长椅；
+  打带配对键的字则会发一次配对请求。
+  现在聊天框一打开，模组自己的快捷键就整个关掉，关掉聊天再恢复。
+  另外 Enter 以前在聊天关着的时候也会白触发一次，现在不会了。
+
+* 【模组界面跟着游戏语言走】
+  以前模组自己的字全是英文，游戏明明是中文的，
+  一到模组这儿就换语言。
+  现在游戏设成中文，联机界面、聊天里的提示、
+  等人和救人的提示都是中文；设成别的语言还是英文。
+  在游戏选项里中途换语言也会立刻跟着变，不用重开游戏。
+
+
+五、出问题的话
+--------------
+
+游戏目录下 BepInEx\LogOutput.log 是日志，
+出问题把它发回来就能定位。
+
+如果是卡在「Waiting for XXX」，日志里这两句最有用：
+  Starting a check     —— 会列出三个存档 key，一眼能看出哪个对不上
+  Turned down a hello  —— 说明有一条握手消息被丢掉了，以及丢的原因
+
+
+六、这东西是谁写的
+------------------
+
+联机功能本身、以及这里几乎全部的代码，都是 Extremelyd1 写的
+（原项目：github.com/Extremelyd1/SSMP）。
+这一份只是在它上面加了「两个人共用一条流程」的双人存档，
+沿用和原作相同的 LGPL-2.1 许可证。
+
+※ 有任何问题请找我，【不要去原作者的 Discord 或 issues 页面】。
+  这些改动不是人家写的，人家既复现不了也没义务解释。
+
+包里还有两个别人的东西：
+  BouncyCastle.Cryptography.dll —— 第三方加密库，MIT 许可证，
+    版权归 The Legion of the Bouncy Castle Inc.，
+    完整条款见同目录下的 LICENSE-BouncyCastle.md。
+  BepInEx_win_x64_5.4.23.4.zip —— BepInEx 官方发布的原包，
+    一个字节都没有改过。

package/README.md

@@ -1,17 +1,17 @@
-# silksong-coop-mod 0.4.23
-
-The files a player needs to install a two-player co-op build of **SSMP**, packaged so they can be fetched from
-a mirror that is reachable inside mainland China. This is not a Node library: nothing here is imported or run
-by `npm install`.
-
-## Install
-
-Download and unpack the tarball, then double-click `INSTALL.bat`. `INSTALL.txt` explains the rest, in Chinese.
-
-The BepInEx loader is included, so the install needs no network access at all.
-
-## Credit and licence
-
-The multiplayer mod is the work of [Extremelyd1](https://github.com/Extremelyd1/SSMP). This is a modified copy
-that adds a shared two-player save; please do not take questions about it to the original author. Distributed
-under the GNU LGPL 2.1 - see `LICENSE`. Built from https://github.com/Candy-649/SSMP at `e7272ef`.
+# silksong-coop-mod 0.4.24
+
+The files a player needs to install a two-player co-op build of **SSMP**, packaged so they can be fetched from
+a mirror that is reachable inside mainland China. This is not a Node library: nothing here is imported or run
+by `npm install`.
+
+## Install
+
+Download and unpack the tarball, then double-click `INSTALL.bat`. `INSTALL.txt` explains the rest, in Chinese.
+
+The BepInEx loader is included, so the install needs no network access at all.
+
+## Credit and licence
+
+The multiplayer mod is the work of [Extremelyd1](https://github.com/Extremelyd1/SSMP). This is a modified copy
+that adds a shared two-player save; please do not take questions about it to the original author. Distributed
+under the GNU LGPL 2.1 - see `LICENSE`. Built from https://github.com/Candy-649/SSMP at `78f4a74`.

package/UPDATE.bat

@@ -1,14 +1,14 @@
-@echo off
-rem Double-click this to pull the newest co-op build. It only replaces the plugin of an install that already
-rem works; run INSTALL.bat first if the mod is not installed yet.
-rem
-rem -ExecutionPolicy Bypass applies to this one run only and changes no system setting. pwsh is preferred
-rem because Windows PowerShell 5.1 mangles UTF-8 without a BOM.
-where pwsh >nul 2>nul
-if %errorlevel%==0 (
-    pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0update.ps1" %*
-) else (
-    powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0update.ps1" %*
-)
-echo.
-pause
+@echo off
+rem Double-click this to pull the newest co-op build. It only replaces the plugin of an install that already
+rem works; run INSTALL.bat first if the mod is not installed yet.
+rem
+rem -ExecutionPolicy Bypass applies to this one run only and changes no system setting. pwsh is preferred
+rem because Windows PowerShell 5.1 mangles UTF-8 without a BOM.
+where pwsh >nul 2>nul
+if %errorlevel%==0 (
+    pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0update.ps1" %*
+) else (
+    powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0update.ps1" %*
+)
+echo.
+pause