Lua 0.17.1 Alpha

Lua · 未央 0.17.1 Alpha

这是 0.10.2 之后的首个公开版本，汇总了 0.10.3～0.17.1 的全部更新：

• 0.10.3 / 0.10.4：修复世界恢复的目录竞争与中断保护、macOS 内存重复计数；加固更新器下载、磁盘校验和任务互斥。
• 0.11.x：世界数据包列表与 ZIP 预览、Modrinth 数据包搜索与版本选择，并可在完整备份后安装到指定世界（同名不覆盖）。
• 0.12.x：模组详情（名称、ID、版本、作者、许可、依赖），支持本地模组导入与冲突检查。
• 0.13.0：整合包安装前预览文件，可选下载可跨页勾选，失败重试保留选择。
• 0.14.0：本地皮肤收藏，Classic/Slim 二维预览、标签搜索、改名和导出。
• 0.15.x：原生/融合标题栏、窗口大小与位置记忆、多屏纠正，macOS 界面缩放 90～125%。
• 0.16.0：实例库列表/网格视图、紧凑密度、排序与分页。
• 0.17.x：全局设置搜索与定位，以及下文的实例设置搜索。

各版本详情见源码 docs/releases/ 与 CHANGELOG.md。

---

实例设置页新增本页搜索，可用“名称”“Java”“内存”“JVM”“全屏”“继承”等关键词查找8项设置和2项恢复操作。点击结果只定位真实控件；高级结果可以展开原有高级区域，条件设置先定位来源或模式选择器。搜索不会改值、保存、检测Java，或替玩家执行恢复操作。

搜索仅使用固定描述，不读取路径、JVM内容、实例名称或其他实例资料。每次关闭或切换实例设置会清空搜索词，原来按实例保留的未保存草稿继续保留，包括当前继承模式下暂未使用的输入值。查询改变、切换实例、弹窗和保存错误会使旧定位失效，原验证错误焦点优先。

完整1204项测试、85项独立验证（82项Node和3组DOM）、构建与本地未签名macOS ARM64包核对通过。生产Electron/真实Core与原创文件另验10处定位、11个无额外调用或存储写入阶段、6个高缩放布局和双实例草稿；未登录、运行Java或游戏。系统键盘、辅助技术、Windows/Linux及本提交三平台CI/公开发行另验。用法见源码 docs/INSTANCE_SETTINGS_SEARCH.md。

发行后可从Release Assets下载Windows x64 EXE、macOS ARM64 DMG/ZIP或Linux x64 AppImage；公开版本以实际Release为准，本地完成不等于已发布。安装包尚未代码签名或公证。

Minecraft是Mojang的商标，本项目与Mojang、Microsoft无关联。

Lua 0.10.2 Alpha

Lua · 未央 0.10.2 Alpha

修复

• Mac 上游戏内存分配过低：自动内存现在按活动监视器的口径计算可用内存。macOS 会把空闲内存拿来做文件缓存，这部分需要时会立即释放，以前被当成已占用，导致 16 GB 的 Mac 运行 1.21.1 只分到 1–1.8 GB。现在会恢复到推荐的 4 GB（1.18 及以上原版），同时仍为系统保留余量。
• 更新提示更清楚：更新说明不再显示 Markdown 符号；Mac 上打开安装包后，对话框会提示把 Lua 拖进「应用程序」替换，不再一直显示「正在下载」。

实测

• macOS（Apple 芯片）：正式安装包覆盖安装保留登录；正版启动原版 1.21.1 成功，「多人游戏」「Realms」可用；重启后无需重新登录；从 0.10.0 通过启动器内「检查更新」下载、校验并打开 0.10.1 安装包成功。

安装

已安装 0.10.0 或更新版本的用户可以在启动器内更新（设置 → 检查更新）。也可以在本页 Assets 下载：Windows（Lua-Setup-0.10.2.exe）、macOS（.dmg / .zip，Apple 芯片）、Linux（.AppImage）。安装包暂未签名，首次运行时 Windows 可能提示「未知发布者」，点「更多信息 → 仍要运行」即可。

Minecraft 是 Mojang 的商标，本项目与 Mojang、Microsoft 无关联。

Lua 0.10.1 Alpha

Lua · 未央 0.10.1 Alpha

修复

• macOS 游戏内存分配过低：自动内存在 Mac 上经常只分配 1 GB（例如 16 GB 的 Mac 运行 1.21.1 只拿到 1024 MB），容易卡顿。原因是 macOS 会把空闲内存用作缓存，之前只统计了完全空闲的部分。现在按活动监视器的方式计算可用内存，Mac 上会恢复到推荐的 4 GB（1.18 及以上原版），同时仍为系统保留余量。

实测

• 在 macOS（Apple 芯片）上用正式安装包覆盖安装后保留登录；正版启动原版 1.21.1 成功，「多人游戏」和「Realms」可用；重启启动器后无需重新登录即可再次启动。

安装

已安装 0.10.0 的用户可以在启动器内更新（设置 → 检查更新）。也可以在本页 Assets 下载：Windows（Lua-Setup-0.10.1.exe）、macOS（.dmg / .zip，Apple 芯片）、Linux（.AppImage）。安装包暂未签名，首次运行时 Windows 可能提示「未知发布者」，点「更多信息 → 仍要运行」即可。

Minecraft 是 Mojang 的商标，本项目与 Mojang、Microsoft 无关联。

Lua 0.10.0 Alpha

Lua · 未央 0.10.0 Alpha

新功能

• 国内下载加速：新增「设置 → 下载源」。可选「自动（官方优先，失败或超时自动换镜像）」「国内镜像优先」「只用官方服务器」，镜像使用社区提供的 BMCLAPI。时区为中国大陆时默认使用镜像。游戏本体、运行库、资源文件、Java 以及 Fabric / Forge / NeoForge 都会走所选下载源，所有文件下载后仍按官方校验值核对。
• 自动更新：启动后检查 GitHub 上的新版本，有更新时左下角会提示，可查看更新说明。
  • Windows：一键下载安装程序并更新。
  • Linux：AppImage 直接替换并重启。
  • macOS：下载后打开安装包。
  • 安装包都会核对 GitHub 公布的 SHA-256。可以在设置中关闭自动检查，或手动「检查更新」。

其他

• 新增隐私政策：Lua 没有统计和遥测，只在你操作时连接 Minecraft、模组站和 GitHub。
• 为 Windows 代码签名做好准备：CI 已预留 SignPath 开源免费签名和 Microsoft Store（MSIX）打包，配置后自动生效。详见 代码签名说明。

安装

在本页 Assets 下载：Windows（Lua-Setup-0.10.0.exe）、macOS（.dmg / .zip，Apple 芯片）、Linux（.AppImage）。从 0.10.0 开始，之后的版本可以在启动器内更新。安装包暂未签名，首次运行时 Windows 可能提示「未知发布者」，点「更多信息 → 仍要运行」即可。

Minecraft 是 Mojang 的商标，本项目与 Mojang、Microsoft 无关联。

Lua 0.9.0 Alpha

Lua · 未央 0.9.0 Alpha

新功能

• 地图预览：在「实例内容 → 世界」选中一个世界，就能看到俯视地图。支持主世界 / 下界 / 末地，拖动平移、滚轮缩放，标出出生点和玩家位置。兼容 1.18+ 新存档、1.13–1.17 存档以及更早的旧存档；只读取，不修改世界。
• 恢复世界：已完成的备份可以一键「恢复」为新世界，可以恢复到任意实例；逐个文件校验，永不覆盖现有世界。
• 导入世界 / 地图：直接导入网上下载的地图 ZIP（自动找到 level.dat 所在文件夹，兼容中文 GBK 文件名）或 Lua 导出的世界 ZIP。
• 旧版本与快照：下载页可以选正式版、快照和远古版本（Beta / Alpha）。支持旧版启动参数、旧资源布局和 Java 8；Apple 芯片的 Mac 会自动用 Rosetta 2 运行没有原生库的旧版本。Fabric 支持 1.14 及之后的版本和快照。
• 崩溃分析：游戏异常退出时自动读取日志和崩溃报告，用中文说明可能原因（内存不足、Java 版本不对、缺前置模组、模组冲突、显卡驱动等）和解决办法。启动器在后台时会发系统通知。
• 实例管理：复制实例（先备份一份再试新模组）、删除实例（移到回收站 / 废纸篓，可以找回）、快速打开崩溃报告。

界面与体验

• 下载页改为左侧版本浏览器（类型筛选、搜索、发布日期），不兼容的加载器会直接说明原因。
• 设置页新增「启动器」分区：外观切换、启动游戏后自动最小化。
• 账户页登录后更简洁，可以直接切换账户。
• macOS 使用沉浸式标题栏；Windows 使用与界面一致的标题栏按钮。

Windows 优化

• 安装程序改为可选择安装位置，自动创建桌面和开始菜单快捷方式，中文安装界面。
• 自动识别更多 Java：注册表、Adoptium / Zulu / Microsoft / Corretto / Liberica 等安装目录，以及官方启动器自带的运行时。
• 任务栏与系统通知使用独立的应用标识。

安装

在本页 Assets 下载：Windows（Lua-Setup-0.9.0.exe）、macOS（.dmg / .zip，Apple 芯片）、Linux（.AppImage）。安装包尚未代码签名 / 公证，首次打开时系统可能需要确认。

已知限制

• Forge / NeoForge 仍只支持 1.20.1 及之后的正式版。
• 地图预览为近似颜色，不渲染生物群系色调和方块细节。
• 旧版本的真实启动尚需更多实机验证，遇到问题请到 GitHub 反馈。

Minecraft 是 Mojang 的商标，本项目与 Mojang、Microsoft 无关联。

Lua 0.8.0 Alpha

Lua · 未央 0.8.0 Alpha

这一版把 0.5～0.7.1 积累的本地功能一次性公开发布，并带来全新界面、正版登录接入和世界 ZIP 导出。

亮点

• 全新界面：夜色侧栏与「启动台」首页——选中的实例、账户、Java 和内存一屏可见，月光色的大按钮直接启动；实例列表双击即可开玩。支持浅色 / 深色 / 跟随系统三种外观。
• 正版登录已开放：Minecraft 官方 API 接入申请已通过审核。使用 Microsoft 账户登录后会验证 Java 版所有权与游戏档案，账户头像显示你的正版皮肤。未登录时启动按钮会引导你先登录。
• 世界导出为 ZIP：在实例内容 → 世界中，对已完成的备份点击「导出 ZIP」。导出时重新校验每个文件，生成标准 ZIP（大于 4 GB 自动使用 ZIP64），写完再完整解压校验一遍才保存；可以直接用系统解压工具打开。
• 0.5～0.7.1 合并发布：实例独立的 Java / 内存 / JVM 参数 / 窗口设置；模组、资源包、光影、世界清单；资源包与光影下载；单个模组启用 / 禁用；世界信息与种子查看；完整世界备份。

安装

在本页 Assets 下载对应平台的安装包：Windows（.exe）、macOS（.dmg / .zip，Apple 芯片）、Linux（.AppImage）。安装包尚未代码签名 / 公证，首次打开时系统可能提示来自未知开发者。Lua 不捆绑游戏、模组或整合包，游戏文件从官方来源下载。

已知限制

• 支持 Minecraft 1.20.1 及以后的正式版；旧版本、快照与 Quilt 尚未支持。
• 世界备份目前只能导出 ZIP，还没有「从备份恢复」，需要恢复时请手动解压到 saves 目录。
• BBSMC 资源站为实验性接入，部分文件需要到官网下载。

完整变化见 CHANGELOG。源码以 MIT 许可开源。Minecraft 是 Mojang 的商标，本项目与 Mojang、Microsoft 无关联。

Lua 0.4.0 Alpha

Lua 0.4.0 Alpha · 未央

本次补齐 Java 自动下载与安装。自动管理会按游戏的官方清单选择所需版本和架构，优先复用已有 Java；缺失时下载安装。原版、Fabric、Forge、NeoForge 和整合包共用此流程。

新增与修改

• 设置页可提前下载 Java 17、21、25，查看本机和 Lua 托管的运行时；下载页同步展示真实任务进度、取消与重试。
• 手动 Java 路径可浏览选择，切换自动模式后保留上次手动值；无效路径、错误主版本或架构会报错。
• 下载清单及文件逐项验证大小和 SHA-1，保留第三方许可；权限与真实版本探测完成后原子提交，损坏版本单独修复。
• 共享同一下载，取消一个使用者不影响其他使用者；重启后可复核并复用已完成的运行时。
• 设置草稿切页保留；修复重试按钮误提交、弹窗命名/焦点和下载标签键盘操作。
• 凭据获取、Java 准备与退出时的启动取消保护，防止迟到结果再次启动游戏。

验证与审查

• 本地 201 项确定性测试、类型检查和生产构建通过；三平台 CI 针对发布提交执行，全部通过才公开安装包。
• macOS ARM64：官方 Java 17.0.15、21.0.7、25.0.1 真实下载、完整校验与版本探测通过；重建管理器后的无网复用和损坏修复通过。
• 隔离目录强制禁用系统 Java 后，Minecraft 1.20.1 原版及 Forge 47.4.0 真实安装通过；Forge 的 5 个 JVM 处理器使用新托管 Java，生成文件通过校验。
• 独立审查发现的目录接线、提交取消、凭据等待和前端状态竞态已修复并回归。详见仓库开发日志及审查记录。

当前限制

• Minecraft API 申请仍待批准，当前不能完成正版登录并启动游戏。 本轮未进行真实完整登录或游戏运行验证，没有离线入口或失败回退。
• 运行时按 Mojang 实际提供的系统/架构选择；Linux ARM64 等缺包组合需手动配置。其他平台的实际 Java 执行与游戏体验仍需实机验证。
• 任务历史限本次进程；已完成运行时可跨重启复用，未完成文件不提供字节级续传。
• BBSMC 为实验接入，某些文件受站点验证或外链限制。
• 游戏范围仍为 Minecraft 1.20.1 起的受支持正式版。旧版、快照、Quilt、更多整合包格式、皮肤披风与联机仍在路线中。
• Windows 代码签名和 macOS 公证尚未配置，安装包继续标注 Alpha。

源码免费开源：XQGGCN/lua-launcher。运行时和下载资源分别保留其自身许可，Lua 不随安装包捆绑游戏或第三方模组。

Lua 0.3.0 Alpha

Lua 0.3.0 Alpha · 未央

这是开发预览版，可用于体验界面、下载游戏、管理实例与安装模组。

目前仍不能完成正版登录并启动游戏。 Lua 自有应用的 Minecraft API 接入申请已提交，尚未获批；实测 Microsoft 和 Xbox / XSTS 验证通过，但 Minecraft 登录接口仍返回 403。本版本只保留 Microsoft 在线账户，没有离线入口或登录失败后的离线回退。下载安装包、赞助项目或重新登录不会解除这项上游限制。

本次更新

• 新增 Forge 与 NeoForge 版本选择、固定版本安装，以及对应 .mrpack 整合包支持；保留原版与 Fabric。游戏范围为 Minecraft 1.20.1 及之后的正式版本，具体加载器版本以官方列表和安装结果为准。
• 加载器使用官方 Maven 安装器和依赖，验证文件哈希，在实例独立目录执行客户端安装处理器；失败或取消不会将半成品标记为可启动。
• 新增自动内存分配，并保留手动设置。启动时根据当前可用内存限制实际分配；内存不足时显示明确提示。
• 模组页面新增功能分类筛选，可搭配 Modrinth / BBSMC 来源、加载器和游戏版本寻找资源。
• 模组安装按 Fabric、Forge、NeoForge 分别检查兼容性，同一来源的必需依赖一并校验安装；不同加载器的模组不会直接混装。

验证范围

• macOS ARM64 / Java 17 已完成真实官方安装处理器验证：Minecraft 1.20.1 + Forge 47.4.0、Minecraft 1.20.2 + NeoForge 20.2.93，生成文件通过校验。
• 自动测试覆盖版本绑定、启动参数与类路径、下载校验、取消、回滚、账户并发和内存分配。模拟进程测试不代表实际游戏运行成功。
• Windows、macOS、Linux 安装包由同一提交的构建与测试任务生成。当前纯在线版的完整游戏启动，以及 Windows / Linux 的实际游玩仍待验证。

下载与限制

• Windows 下载 .exe；macOS 下载 .dmg 或 .zip；Linux 下载 .AppImage。请选择与系统和文件名标注的架构匹配的版本。
• 安装包尚未进行 Windows 代码签名或 macOS 公证，系统可能显示来源或开发者未验证的提示。
• BBSMC 接入仍为实验性：搜索和版本查询已实测，当前测试网络的 CDN 下载会返回安全验证网页，Lua 会拒绝将其当作模组安装。需要登录、购买、网盘或外部链接的资源须前往官网获取，不绕过站点验证或访问限制。
• 需要自行安装匹配的 Java；暂不支持自动安装 Java、Quilt、旧版 Minecraft、快照、CurseForge 格式整合包或自动更新。
• 本项目是独立启动器，与 Minecraft、Mojang、Microsoft、Forge、NeoForge、Modrinth、BBSMC 均无官方关联，不随安装包分发游戏客户端或第三方模组。

源码与问题反馈：XQGGCN/lua-launcher。Forge 与 NeoForge 来自各自官方项目；也欢迎支持 Forge 与 NeoForged。