更新与故障排查
当 LeviLauncher 的安装、更新或启动行为不符合预期时，请优先参考这一页。
常见问题 Windows
启动器显示 Release 版本未获授权
一个微软账户只能在10台设备上登录微软商店，启动器会被算作一台单独的设备。
所以你需要在 Microsoft Store 设备管理 中将其它不需要的设备移除。
Gaming Services 缺失或损坏
- 使用启动器提供的引导进行安装或修复。
- 必要时回到 Microsoft Store 检查 Minecraft 基岩版的安装状态。
GameInput 缺失
- 按 LeviLauncher 提示安装所需 redistributable。
- 安装完成后，如有需要请重启启动器。
安装路径不可写
- 在 设置 → 基础设置 中把托管内容路径改到可写位置。
- 如果启动器在安装或自更新时要求提升权限，只在你确认可信时允许执行。
LeviLauncher 本体一闪即退或双击没反应
- 在 Windows 上，LeviLauncher 现在会以更保守的 WebView2 软件渲染模式启动，以降低部分显卡和驱动组合下的启动崩溃概率。
- 如果界面还没出现就退出，请先检查
%LOCALAPPDATA%\LeviLauncher\Logs\startup.log。 - 失败后可以先重试一次；如果仍然复现，提交 Issue 时请附上
startup.log。
某个版本无法启动
- 先测试该版本在无模组情况下能否启动
- 检查所需 Windows 组件是否仍然存在
- 确认该版本是否已经完整安装
- 试着建立一个干净的隔离测试环境复现问题
下载很慢或反复失败
- 切换镜像
- 稍后重试
- 如条件允许，改用本地包来源
Android 上的常见问题 Android
找不到 Minecraft 或版本不受支持
从 Google Play 安装或更新官方 Minecraft（1.21.80 或更高版本），然后重新打开 LeviLauncher。
导入版本无法启动
导入版本通常需要版本隔离。请在实例设置中启用后重试。
启动失败
从失败页面打开启动日志，先查看报告的原因，再调整设置。
数据迁移
启动器可能需要先迁移旧的数据目录。在迁移成功、并确认世界、资源包和设置都可用之前，不要删除旧目录。
更安全的恢复步骤
- 先备份重要世界。
- 移除最近新增的模组或资源包。
- 用一个干净的隔离版本做对照测试。
- 必要时重新安装受影响版本。
关于自更新 Windows
LeviLauncher 可以检查、下载并安装应用更新。若安装目录不可写，某些环境下可能需要管理员权限。
什么时候应该提 Issue
当满足以下条件时，建议到 GitHub 提交问题：
- 你能稳定复现问题
- 做过基础恢复步骤后仍然存在
- 问题看起来更像 LeviLauncher 自身，而不是一般 Windows 环境问题
提交时请尽量附带：
- Windows 版本
- LeviLauncher 版本
- 你的具体操作步骤
- 截图或日志（如果有）
问题反馈入口： GitHub Issues
Android 版的问题请附上 Android 版本、设备型号和启动日志，并提交到 LiteLDev/LeviLauncher-Android。