游戏启动不了 / 一直是黑窗口
PocketRolesStarPocket Client安装、启动与问题请按顺序检查
- 首次启动（以及游戏更新后的第一次启动）会停留在黑色控制台窗口 1〜3 分钟。这是 BepInEx 在生成必要文件（interop），请不要关闭。
- 确认 Steam 已经启动。Steam 没有运行时，游戏会立刻退出（P-01）。
- 确认 Among Us 没有已经在运行（任务栏 / 任务管理器）。不能同时启动两个（P-03）。如果在运行，请先关闭，再点击“启动”。
- 杀毒软件有时会隔离 BepInEx 的 winhttp.dll。请不要急着点“允许”或“排除”，也不要把整个文件夹加入排除列表。先确认文件是从官方页面下载的（确认下载的文件是原版），然后在启动器里点击“检查更新”→“启动”（使用 StarPocket Client 时，再按一次“安装”或“修复”）。
- 如果 Among Us 刚更新过，可能需要等待模组的适配版本（如何更新）。
- 在 32 位的 Windows 上，从 2026.9.29 起 Among Us 本身已无法运行。
没有出现职业（模组已停用）
如果 Among Us 的版本与 PocketRoles 支持的版本不同，在适配版本发布之前模组会自动停用。游戏本身能启动，但不会出现职业。此时画面左上角会显示 (version mismatch)，房主的聊天里也会出现通知。
Among Us 从 2026.9.29 起变为 64 位。如果还装着 32 位的 BepInEx，模组会完全不工作，而且不会报任何错误（游戏照常启动，因此很难发现）。如果游戏左上角没有显示“PocketRoles v0.5.6”，请更新到 PocketRoles v0.5.6，就会换成 64 位的 BepInEx（原来的启动器按“检查更新”→“是”，StarPocket Client 按“检查更新”→“更新”（v1.1.2 按“修复”也可以）。如何更新）。
画面上出现代码时
- P-14 找不到 BepInEx → 点击“修复”。
- P-24 无法加载 PocketRoles → 关闭游戏，点击 StarPocket Client 的游戏按钮（已变成“修复”）。
- R-44 BepInEx 的启动部件不对 → “修复”后重新启动游戏。
- 其他代码可以在错误代码一览里查找。
StarPocket Client 打不开时
StarPocket Client 使用 Microsoft Edge WebView2 运行时显示界面。没有安装时，会显示打开 Microsoft 官方页面的按钮和“再确认一次”（不会擅自安装）。Windows 11 自带该运行时。以前的启动器（PocketRoles Launcher.cmd）也可以继续使用。
仍然无法解决时
请在启动器里点击“生成报告 zip”，把生成的 zip 发送到问题报告的窗口。我们会查看日志（如何报告问题）。