趁 ChatGPT 订阅到期前,让 AI 写着玩的 Minecraft Java 版启动器。
面向 Windows 10/11 x64 的 Minecraft Java 版启动器,使用 C# / .NET 10 / Avalonia UI。当前版本 v0.1.1-alpha,仍在测试中,请备份重要存档。
作者 / 维护者:Zc345370669 · 官方仓库 · AI 辅助开发说明
- 完整模式六项导航:首页、个人游玩、整合包、模组管理、下载管理、设置。
- 精简模式在同一主窗口内切换,共享账号、实例、下载任务、启动状态和主题;分别保存窗口几何及最后模式。
- 实例隔离、复制、备份、导入和本地安装证据检查;目录存在本身不等于游戏可启动。
- 精简模式在同一个无缝组合框内选择已安装实例或选择版本、加载器并下载安装,不跳转完整模式,不使用第二套下载器。
- 离线账号与 Microsoft 正版账号,账号选择及添加复用共享状态。
- 下载队列、真实聚合进度、暂停/继续/取消、重试与恢复;唯一总百分比进度条。下方阶段连接线隐藏,完成节点和当前移动节点各自显示名称;Assets等名称精简,加载器名称来自真实阶段事件。
- Java 探测及管理、Modrinth 模组搜索/依赖检查/安装、整合包导入和同步。
- 共享浅色/深色及现有主题、Lucide 图标、自动隐藏滚动条和自适应组合框。
这些功能的自动化测试不等于验证了所有Minecraft版本、加载器组合或真实Windows设备。
从官方仓库实际提供的发布文件中下载Windows x64包,完整解压后运行 XGLauncher.exe。源码包不包含EXE。自包含发布不要求另装.NET桌面运行时,但游戏仍需要兼容Java和相应资源。
初次使用可在精简模式实例组合框内选择版本与加载器安装,或在完整模式管理实例。只有必要文件、Java与安装凭据通过检查后,实例才进入可启动列表。不要把旧数据目录直接覆盖到新位置;迁移和备份使用现有入口。
数据基于程序位置或已有工作区配置解析,实际位置以设置为准,不能依赖当前工作目录。游戏存档、模组、账号缓存、下载缓存和日志属于用户数据,不应提交到GitHub。
Microsoft 登录沿用MSAL系统浏览器授权、Xbox/XSTS、Minecraft Services、所有权与档案校验。桌面应用的公开Client ID可以公开,不使用Client Secret。Windows凭据由既有MSAL安全缓存处理,账号索引只保存元数据。
Minecraft Services HTTP 403 的真实根因尚未确认,本次没有修复或绕过正版认证。 浏览器完成页不代表Minecraft正版验证已全部通过。离线账号只用于适用的单机或允许离线会话的环境,不绕过正版或服务器认证。
- 目标运行平台:Windows 10/11 x64。
- 源码SDK:
global.json固定 .NET SDK 10.0.404;Avalonia 11.3.23;依赖由锁文件固定。 - 运行游戏:需要对应版本的Java,可由现有Java管理流程选择或准备。
- Windows安装程序构建:PowerShell及 NSIS 3.11,脚本会验证版本。
- 本地安全/许可证测试:Python 3(仅标准库)。
以下命令针对解压的干净源码包(不含.git和构建输出);Git检出请先按构建说明导出已跟踪快照进行扫描。
python scripts/scan-public-source.py . --report public-scan.json --strict-layout
python -m unittest discover -s tests -p '*tests.py' -v
dotnet restore XG-Launcher.sln --locked-mode
dotnet build XG-Launcher.sln -c Release --no-restore
dotnet test XG-Launcher.sln -c Release --no-build --no-restore先扫描干净源码,再构建;bin/obj不属于公开源码。两个.NET测试项目为可执行回归套件,现有 Directory.Build.targets 在 dotnet test 的VSTest目标后调用它们,不能用空测试适配器的退出码代替这些PASS记录。也可分别执行 dotnet run --project tests/XG.Tests -c Release --no-build 与 dotnet run --project tests/XG.UI.Tests -c Release --no-build。
Windows完整发布:
pwsh ./build-windows.ps1输出 dist/win-x64/、便携ZIP及NSIS安装程序。Linux可用 XG_DOTNET=dotnet bash scripts/publish-portable-windows.sh <输出目录> 交叉发布自包含Windows x64程序。更多说明见 构建与验证。
GitHub Actions仅由手动操作或PR触发,执行扫描、测试、Windows发布及构建产物上传,不会自动创建Release、Tag或推送仓库。本次未在GitHub上实际运行工作流。
| 目录或文件 | 内容 |
|---|---|
src/XG.Core/ |
游戏、实例、Java、认证、下载与Modrinth服务 |
src/XGLauncher/ |
共享模型、完整/精简视图和Avalonia控件;界面由C#构造,无独立AXAML文件 |
tests/ |
.NET核心/无头UI回归,以及Python安全与许可证测试 |
tools/LocalizationAudit/ |
既有本地化源码检查工具 |
scripts/、build-windows.ps1 |
安全扫描、验证与发布脚本 |
.github/workflows/ |
Windows x64 CI配置 |
licenses/、licensing/、third-party/ |
第三方原文、来源记录、历史授权与原生配套源码 |
docs/ |
构建、注释规范、已知限制及历史README |
Windows GUI、真实游戏启动、真人账号登录、安全缓存、原生DPI/多显示器仍需实机验证;Linux无头截图和交叉发布不能替代这些检查。Windows11圆角依赖DWM实际合成能力;Windows10保留兼容直角路径,毛玻璃不受支持时回退。详见 已知问题 和 403记录。
项目自有代码和文档采用 标准 MIT License,完整正文见 LICENSE。允许修改、商业使用、销售、再分发和闭源衍生;没有额外禁售、强制开源或强制界面署名条件。衍生版本可以更名并使用自己的作者信息,建议在README注明基于本项目修改;该建议不增加MIT授权条件。分发仍需保留适用版权和许可文本。
第三方并不因此成为 MIT:Lucide ISC及其继承的Feather MIT、Avalonia、.NET、MSAL、CmlLib及原生库分别遵守原许可。MPL-1.1原生GIF相关原文与未修改对应源码随包保留,见 第三方声明、原生合规说明。系统字体仅按名称引用,未附带字体文件。历史GPL及其他已有效授予的权利不撤销,原文和记录继续保留在 licensing/history/。
正式XG Logo来源、Lucide固定提交/文件散列及其他资源说明保留于现有来源记录;不把第三方资源或全部AI输出声明为项目独占原创。
本项目不是Mojang或Microsoft官方产品,与其没有官方隶属或赞助关系。Minecraft、相关商标和第三方内容归各自权利人所有。
启动检查、关于页点击版本号检查与安全更新协议见 GitHub 自动更新。发布 ZIP 为 XG-Launcher/XGLauncher.exe,许可和对应源码材料嵌入 EXE,可在关于页导出。发布仍需人工审核,未自动创建 Release 或合并 main。