Skip to content

About

趁 GPT 订阅到期前,靠 AI 瞎折腾出来的 Minecraft Java 版启动器。

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XG Launcher(瞎搞启动器)

趁 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 与离线账号

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。

About

趁 GPT 订阅到期前,靠 AI 瞎折腾出来的 Minecraft Java 版启动器。

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages