从解压到进服，以及出问题时该看哪里。
从首页下载 zip 并解压到任意目录。这是自包含单文件版本（约 63 MB），机器上不需要装 .NET 运行时。
双击 MineLibLauncher.exe。程序没有代码签名，Windows SmartScreen 可能拦一次：点「更多信息 → 仍要运行」。配置写在 %APPDATA%\MineLib\config.json，不写注册表。
1.17 及以后需要 Java 17 / 21；1.12.2 及更早需要 Java 8。启动器会依次找：设置里指定的路径 → 官方启动器自带的 runtime → PATH → 常见安装目录。找不到会在启动页提示，也可以手动指定 javaw.exe。
「下载」页左侧选游戏版本（正式版 / 快照可切换，也能搜索），右侧填客户端名称、安装位置、要不要加载器，点「创建新客户端」。它会在 位置\名称 下建一个完整的游戏目录，和别的客户端完全隔离。
侧栏顶部的下拉就是客户端列表。切换后版本列表、模组目录、存档都会跟着换。
点「删除」分两步：先从启动器里移除，再单独问要不要连磁盘文件一起删（存档也在里面，不可恢复）。正在运行的客户端不允许删。
Fabric / Quilt：取官方 meta 的 profile json 写进版本目录，纯文本操作，秒完成，不需要 Java。
Forge / NeoForge：下载它们自己的官方安装器并运行 --installClient，需要 Java，会顺带准备 launcher_profiles.json。装的时候要下几百 MB 依赖，进度在右下角。
模组：到「模组」页搜索，筛选器默认填好当前版本的 MC 版本和加载器；选中项目后右侧列出可用文件，点「下载并放到 mods」。开了版本隔离就进版本目录的 mods，否则进游戏目录的 mods。
离线：起个名字即可，UUID 用 OfflinePlayer: 算法算，和原版一致。只能进开了离线验证的服务器。
外置登录：填 Yggdrasil API 地址（例如 https://littleskin.cn/api/yggdrasil）、用户名、密码。启动时自动注入 authlib-injector（首次会下载）。
微软正版：链路（MSA → Xbox Live → XSTS → Minecraft）已经实现，但微软目前只放行它自己批准的应用身份，自注册应用会返回 Invalid app registration。所以在拿到授权前，这个入口实际不可用。
「下载」页选版本 1.21.11（正式版），加载器按需选择，创建客户端。
这个服离线也能进，所以「账号」页填个离线名字就能玩；有正版账号也可以走外置登录或等微软授权。
进游戏后「多人游戏 → 添加服务器」，地址填 mc.yxzhou.com。有问题去交流群 1060667115 问。
先看「日志」页，或打开 游戏目录\logs\minelib-时间戳.log。最常见的是 Java 版本不对（老版本要 Java 8）、模组与游戏版本不匹配、内存不够。
通常是依赖库缺失。启动前会自动按版本 json 补齐；如果还是报，点「刷新」让启动器重扫，再看日志里缺的具体 jar。
1.7.10 这类 LWJGL 2 时代版本在现在的系统上可能报 Could not locate OpenAL library，属于老版本自身问题，不影响进游戏。
启动器支持命令行自检：MineLibLauncher.exe --selftest 会把加载器版本列表、Modrinth 检索、一次 Fabric 安装的结果写到 %TEMP%\minelib-selftest.txt，不开界面。
需要 .NET 8 SDK。
dotnet build -c Release
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true
代码在 GitHub，欢迎提 issue。