TerraNova Loader常见问题与排障
官网与版本
Q：从哪里下载最新版、确认版本号？ 打开官方下载页 https://tnloader.top/download/，页面会实时读取官方版本数据并展示最新版本、 通道、大小与 SHA-256；页面不可用时可直接访问 https://tnloader.top/releases/releases.json。
Q：安装包从哪里获取才安全？ 只从官方下载页或官方版本数据中给出的直链下载；不要使用非官方转存或网盘。安装前用 SHA-256 校验。
账号与登录（NexAuth）
Q：为什么打开 TN 先要求注册/登录？ TN 接入 NexAuth 网络验证：首次使用需要账号，未登录不能进入管理器，也不能启动游戏（fail-closed）。
Q：提示「用户名或密码错误」？ 检查用户名与密码大小写；连续多次失败会临时锁定，稍后再试。忘记密码请联系管理员重置。
Q：提示「账号已被封禁」？ 账号被管理员封禁，请联系管理员了解原因并申请解封。
Q：提示「绑定设备数量已达上限」？ 一个账号默认只能绑定有限台设备（当前策略通常为 1 台）。请在旧设备上退出登录，或联系管理员踢下线/解绑设备后再登录。
Q：提示「该应用已关闭注册」？ 注册开关由平台配置决定（NexAuth 应用策略），客户端会自动跟随（关闭时登录页隐藏注册入口）； 关闭期间需管理员在 NexAuth 后台建号或重新开启注册，无法自助注册；不需要更新客户端。
Q：提示网络错误 / 无法连接验证服务器？ 登录与心跳都必须联网。请检查网络（代理/蜂窝/Wi-Fi）、稍后重试；离线时无法进入管理器（这是有意的 fail-closed 行为）。
Q：如何退出登录或换账号？ 管理器右上角提供「退出登录」按钮，点击后返回登录页；换机前建议先在旧设备退出，避免触发设备数量上限。
安装/启动
Q：安装被拦截？ 允许文件管理器「安装未知应用」；若系统提示版本冲突，先卸载旧测试包（卸载会清应用数据，请先备份 tnl_mods 与日志）。
Q：启动闪退或停在启动页？ 先在管理器查看错误卡片，然后取 boot.log： /sdcard/Android/data/com.terranova.loader/files/logs/boot.log。 常见原因：存储权限未授予、残留旧运行时目录、目标游戏版本不匹配。
Q：为什么有两个进程？ :main 是管理器，:game 承载游戏与运行时。两者都写 boot.log，用 proc= 区分。
模组
Q：导入成功但模组不出现？ 检查 tnmod.json 的 targetGame 是否匹配当前游戏版本；版本不匹配会被安全禁用并在日志写 TARGET_GAME。
Q：模组被禁用？ 日志会给出原因码：id 重复、依赖缺失/循环、未知 capability、容器校验失败、入口缺失等。按日志修正后重新导入。
Q：能直接放目录调试吗？ 可以：把解包后的目录放进 /sdcard/Android/data/com.terranova.loader/files/tnl_mods/<目录名>/，重启管理器。
Q：更新模组会丢配置吗？ 覆盖同 id 模组不会自动迁移模组数据；配置由模组自身 ModConfig 管理。
游戏内菜单（ImGui）
Q：游戏里怎么打开 TN 菜单？ 进入游戏后，屏幕左侧有悬浮的 TN 圆形按钮（可拖动）；点按打开菜单，返回键关闭。 菜单为官方原生界面（ImGui），不依赖系统键盘或悬浮窗权限。
Q：0.11.5 的内置菜单有哪些功能？ release 默认内置完整菜单（0.11.3/0.11.4 曾移除，0.11.5 起恢复）：物品/NPC 9×9=81 格/页 分页网格（搜索/分类/收藏/最近/分页，tap 按当前数量刷取、长按收藏）、功能（玩家/世界/事件分组）、 世界（时间/地图/难度）、多人（命令历史/发送状态）、安全面板（模组配置/日志/关于/重启灰置）、菜单设置 （缩放 0.7–2.0 或自动、不透明度、恢复默认、清空数据）。设置保存在应用私有 tnl_menu.json。
Q：菜单文字/格子太小？ 菜单内「设置 → 外观」可调 UI 缩放（0.7–2.0）或开启自动；对全部面板与悬浮按钮生效。
Q：搜索时没有键盘？ 菜单已接入 Android 系统输入法（聚焦搜索/命令输入即弹出）；若系统键盘不可用，可用输入框旁的 「屏幕键盘」备用输入。
Q：0.11.7 的材质包状态行怎么看？ 安全面板「材质包状态」行显示 hook/stage/index/index... applied/fallback 与 tpl(raw/image/batch/ok/firstFail)： hook=installed + index>0 + applied 递增表示替换链路工作；tpl(raw=…) 是各上传路径失败计数， firstFail 是首个失败原因。若材质包替换后渲染异常（UI 贴图错位/发暗），把状态行与异常资源名反馈给管理员 （0.11.7 起材质包走 TPL 造图链路 + 合批字段；UI 贴图合批判定为启发式）。
Q：0.11.6 修了什么菜单问题？ 修复真机出现的 ImGui assert 覆盖层（Missing PopStyleVar、窗口边界扩展报警）与关闭菜单后的白色竖滚动条； 安全面板新增「材质包状态」一行（hook 阶段/解析/索引/命中统计），材质包异常时先看这里再查 boot.log。
Q：开发者构建还需要单独获取吗？ 0.11.5 起 release 已内置开发者面板，无需单独开发者构建；--no-dev-menu 只是内部诊断通道， 不公开发布。
Q：商店地址改不了/设置里没有商店设置？ 自 0.11.5 起商店地址固定为 http://119.45.125.36:18080/store，客户端已移除商店设置入口（不再支持改源）。
画面/性能
Q：部分贴图变成占位/紫色？ 说明资产超出预算进入降级或纹理缺失。查日志 content budget 与 asset 相关行；减少同时启用的高纹理量模组。
Q：卡顿？ 确认未同时在后台运行其他大型应用；测试通道的构建性能弱于 release 通道。
日志与反馈
提供以下信息能大幅加快定位：
boot.log最后 100 行（含proc=）；- 出问题的模组
id与版本、targetGame配置； - 设备型号、Android 版本、TN 版本号。