功能说明
版本与实例
- 版本：游戏本体，按
versions/<名称>/存放。 - 实例：一个版本的独立运行环境，Mod、配置、存档可以各自分开。
- 新建实例时可以选「复制现有版本」，只复制必要文件，不复制存档。
版本列表支持搜索、按类型筛选、右键菜单（打开目录、重命名、删除、导出启动脚本）。
下载
| 页签 | 内容 |
|---|---|
| 原版游戏 | 正式版、快照版、旧版本、基岩版（正式 / 预览） |
| Mod | 按加载器与游戏版本筛选 |
| 整合包 | 支持 CurseForge / Modrinth 整合包 |
| 资源 | 资源包、光影、世界 |
下载源可以在「设置 → 下载」里选，支持官方源、镜像源和自定义源。并发数与限速也在那里调。
账户
- 微软正版：设备码登录，令牌自动刷新，支持多账户切换。
- 离线：仅本地用户名。
- 第三方：填认证服务器地址，兼容主流皮肤站协议。
Java 管理
- 自动扫描：注册表（Windows）、
/usr/lib/jvm（Linux）、/Library/Java（macOS）。 - 自动下载：按游戏版本推荐，桌面端下 Microsoft OpenJDK。
- 每个实例可以单独指定 Java，互不影响。
基岩版
- 与 Java 版共用版本列表与启动按钮。
- 安装目录：
versions/基岩版 <版本号>/，安装包放在该目录的bedrock/子目录。 - 启动前检查：系统是否已安装、是否已登录微软账户。
- GDK 版只下载不安装。
更新
- 正式版 / 快照版支持自动更新，下载在后台进行，不阻塞界面。
- 更新失败不会用不完整文件替换程序。
- 更新完成后首次启动会弹一次「更新日志」，内容来自客户端内置记录。
- 内测版没有自动更新。
服务端相关
连上官方服务端后会拿到：
- 公告：同一通道同一条公告只自动弹一次，改了内容才会再弹。
- 封禁：被服务端封禁时用系统原生错误框提示，显示设备码与管理员填写的原因。
- 云端设置：部分开关由服务端统一下发。
没网或连不上服务器不算错误：不弹框、不上报，只在左下角提示。
拓展
「设置 → 拓展」管理已安装的拓展：
- 导入：点「导入拓展」多选，或直接把
.tmlext/.jar拖进窗口。 - 每个拓展都能看「详情」、启用 / 禁用、卸载（二次确认）。
- 启用前确认权限清单；上次处于启用状态的拓展，下次启动自动拉起。
- 刷新列表、打开拓展目录，状态与信任记录写进
trusted.json（含 SHA-256）。 - 卡片上能看到状态徽标、权限与运行时，缺运行环境会直接标出来。
设置项速查
| 分组 | 常用项 |
|---|---|
| 启动 | Java、内存、窗口大小、JVM 参数、游戏参数 |
| 下载 | 下载源、并发数、限速、缓存目录 |
| 界面 | 主题、配色、语言、动画 |
| 其他 | 内测版体验、日志、数据目录 |
| 拓展（独立页面） | 导入、权限确认、启用 / 卸载 |
快捷键
| 按键 | 作用 |
|---|---|
F5 | 刷新当前页数据 |
Ctrl + F | 搜索版本 / 实例 |
Ctrl + , | 打开设置 |
F12 | 打开日志（调试用） |