TYW Launcher

常见问题 ​

启动相关 ​

提示找不到 Java

先看「设置 → 启动 → Java」有没有扫描到。没有就手动指定 javaw.exe（Windows）或 java（Linux / macOS）的完整路径。也可以点「自动下载」让启动器装一个。

点启动后窗口一闪就没了

打开「日志」页看最后 50 行。常见原因：

  • Java 版本和游戏版本不匹配（1.17 要 16，1.20.5+ 要 21）。
  • Mod 与加载器版本不匹配。
  • 内存设太小或太大（建议 2048–8192 MB）。
  • 显卡驱动太旧。
界面白屏 / 卡在加载

删掉数据目录下的 cache 文件夹再开。还不行就看 logs/ 里最新的日志，通常是渲染层或字体问题。

启动很慢
  • 数据目录别放机械盘或网络盘。
  • 关掉「启动时检查更新」。
  • 版本特别多时，用搜索而不是滚动。

下载相关 ​

下载一直是 0%

换下载源（设置 → 下载 → 下载源），确认系统代理没有拦截。公司网络 / 校园网可能需要代理。

下载到一半失败

下载器会保留已完成的分块，重试只补缺失部分。多次失败就换源。

整合包导入失败

确认整合包是 CurseForge 或 Modrinth 格式（zip）。有些整合包带自定义启动脚本，需要手动把参数填进「自定义 JVM 参数」。

账户相关 ​

正版登录报 IP 异常

启动器会自动用直连重试一次。仍失败通常是网络环境问题，换网络或挂代理再试。

令牌过期

正常现象，启动器会自动刷新。刷新失败时重新登录一次即可。

平台相关 ​

Linux 打不开 / 缺少 .so

装齐依赖：libx11-6 libice6 libsm6 libfontconfig1 libgl1。Wayland 下会自动走 XWayland。

macOS 提示「无法验证开发者」

右键 → 打开，或到「系统设置 → 隐私与安全性」点「仍要打开」。也可以：

bash
xattr -cr "/Applications/TYW Launcher.app"
Apple Silicon 上闪退

确认下的是 arm64 包，不是 x64。Intel 包在 M 系列上要靠 Rosetta，容易出问题。

Android 读不到游戏目录

到系统设置里给启动器「所有文件访问权限」，Android 11 以上是单独的开关。

基岩版 ​

点了启动没反应
  • 确认 Microsoft Store 版基岩版已安装。
  • 确认已登录微软账户（游戏内登录无法被启动器代劳）。
  • GDK 版只下载不安装，请用 LeviLauncher 等工具。

内测与封禁 ​

内测码怎么拿

管理员按设备码发放。设备码在「设置 → 其他 → 启动器 → 复制识别码」。

被限制了怎么办

封禁提示里会显示设备码和原因（管理员没填就显示「管理员未填写原因」）。带设备码联系管理员。

其他 ​

数据能迁移吗

整个数据目录复制过去即可。跨平台迁移时注意 Java 路径要重设。

怎么完全卸载

删掉程序和数据目录。Windows 上再清一下 HKCU\Software\PCLDebug。

日志在哪

数据目录下的 logs/，按日期命名。反馈问题时附上最新一份。