macOS · Windows · Linux  |  v1.3.2  |  约 10 MB

GlassMC

液态玻璃 · MINECRAFT 启动器

装版本、装模组、开游戏,
三次点击的事。

玻璃是窗口本身向系统申请的毛玻璃,不是在网页里堆一层滤镜假装。 选一个版本点安装,剩下的下载、补依赖、配 Java、拼启动参数,它自己来。

三个平台都会被系统拦一次 —— 怎么放行 →

glassmc — launch
$ glassmc launch --version 新蒸程1.7
[glassmc] 继承链深合并 3 层 · NeoForge 21.1.236
[glassmc] classpath 100 项 · 缺失 0 · 占位符全部展开
[glassmc] 注入 authlib-injector · 皮肤已同步
[glassmc] 内存 12288 MB · JDK 21.0.5 (arm64)
[minecraft] Backend library: LWJGL
[minecraft] OpenAL initialized
[minecraft] Game took 59.164 seconds to start
$
393可装版本
4模组加载器
3操作系统

下载

GlassMC 1.3.2 · macOS 15+ · Windows 10+ · Linux · GPLv3 开源

Linux 绿色版是 GlassMC-linux.tar.gz; Release 页有全部资产和 SHA-256。 装完第一次打开会被系统拦一下,放行方法在下面。

不想先下载? 在线体验版跑在浏览器里,八个页面都能点,示例数据,不装游戏、不连账号。
打开体验页 ↗
FEATURES

从下载到进服,中间都不用手动

不用装 Java,不用手拼参数,不用配内网穿透。

01

全版本安装

正式版 + 快照共 393 个。清单、版本 JSON、客户端 jar、依赖库、资源对象一路下完,逐项校验 SHA1,已有的跳过。

02

加载器与 Java

Fabric、Quilt、Forge、NeoForge 一键装;JDK 8 / 11 / 17 / 21 按版本自动配,从清华镜像下,不用碰环境变量。

03

三种登录,皮肤跟着走

离线 / 微软正版 / 外置登录。皮肤站登录后游戏里就是你的皮肤,还带一个在线皮肤库。

04

模组与整合包

本地模组开关、缺失依赖提示、Modrinth 搜索安装;整合包能导入,也能导出成 .mrpack 分享。

05

从别的启动器搬家

自动扫描 HMCL、官方启动器、Prism / MultiMC。版本、模组、存档、账号一起复制,原目录不动。

06

陶瓦联机

不用公网 IP、不用端口映射。生成一串邀请码发给朋友,对方粘进去就能进你的世界。

PLATFORMS

三个平台,同一套代码

数据目录、毛玻璃档位、进程托管都按平台分支,下面写的是真实状态。

MACOS 15+ · UNIVERSAL

macOS

Apple Silicon 与 Intel 共用一个包。无边框窗口 + 系统毛玻璃,圆角是真的圆角。 装机、装版本、进游戏整条链路都在真机上跑过。

真机全流程直接用 dmg
WINDOWS 10 1809+ / 11 · X64

Windows

NSIS 安装包,快捷方式和卸载项齐全,卸载时会问要不要连数据一起删。 毛玻璃优先 Mica,退 Acrylic,都不行降级磨砂。

安装/运行已验证wine 下走完整流程
DEB · TAR.GZ · WEBKITGTK 4.1

Linux

Ubuntu 26.04 原生编译,依赖自检无缺失。虚拟显示里跑完整条链路: 八个页面正常渲染、真实下载 1.21.11、启动进到主菜单。

安装/启动已验证Xvfb 里跑完整流程
INSTALL

三步装上,两分钟开玩

三个平台的包都会被系统拦一次,放行方法各不相同。

⚠
首次打开会被系统拦下。这个包没有 Apple 开发者签名,会提示「无法验证开发者」或者「已损坏」。 属于正常现象,按下面任一方法放行一次,之后不再询问。
  1. 下载并拖进「应用程序」。双击 GlassMC.dmg,把图标拖到旁边的 Applications 文件夹。
  2. 第一次打开时放行一次。双击 GlassMC 被拦下时点「完成」,再按下面方法一或方法二操作。
  3. 开始用。登录账号 →「安装」页挑个版本点安装 → 回「版本」页点启动。
打不开怎么办 二选一
方法一 · 系统设置里点「仍要打开」推荐
  1. 双击 GlassMC,看到「Apple 无法验证此 App 是否包含恶意软件」,点 完成。
  2. 打开 系统设置 → 隐私与安全性,向下滚到「安全性」区域。
  3. 看到 “GlassMC” 已被阻止使用… 那一行,点旁边的 仍要打开,输入开机密码。
  4. 再双击一次 GlassMC,弹窗里出现 打开 按钮,点它。以后就正常了。

如果提示的是 「GlassMC 已损坏,应该将它移到废纸篓」,处理方式完全一样:先去系统设置放行一次再打开。不要点「移到废纸篓」——它没坏,只是没签名。

方法二 · 终端一行命令
$ xattr -dr com.apple.quarantine /Applications/GlassMC.app

打开「终端」粘贴回车即可。这条命令只去掉 macOS 给下载文件打的「待检查」标记,不改应用内容。装在别处就把路径换成实际位置。

⚠
SmartScreen 会拦一次。提示「Windows 已保护你的电脑」,点「更多信息」再点「仍要运行」就能装。 安装到 C:\Program Files\GlassMC,需要管理员权限,UAC 会再弹一次。
  1. 下载并运行安装包。双击 GlassMC-Setup.exe,UAC 弹窗点「是」。安装向导有简体中文。
  2. 被 SmartScreen 拦下时放行。点「更多信息」→「仍要运行」,只需一次。
  3. 开始用。开始菜单或桌面打开 GlassMC → 登录账号 →「安装」页挑版本 → 「版本」页启动。
打不开怎么办 二选一
方法一 · 在 SmartScreen 窗口里放行推荐
  1. 双击 exe,出现蓝底的「Windows 已保护你的电脑」。
  2. 点窗口里的 更多信息,下面会展开出 仍要运行 按钮。
  3. 点 仍要运行,UAC 点 是,安装向导就出来了。

如果窗口里没有「更多信息」而只有「不运行」,说明文件被系统策略挡住了:右键 exe → 属性 → 底部勾选 解除锁定 → 确定,再双击。

方法二 · PowerShell 解除文件锁定
> Unblock-File "$HOME\Downloads\GlassMC-Setup.exe"

文件从网上下载后会带一个「来自其他计算机」的标记,这条命令只去掉这个标记,不改安装包内容。路径按你实际下载的位置改。

装好后窗口一片空白?

GlassMC 的界面跑在 WebView2 上。Windows 11 自带,Windows 10 大多随 Edge 装好了;如果打开后只有一块空白,去微软官网搜 WebView2 Evergreen Bootstrapper 装一次即可。启动器本身不需要 .NET,也没有其他运行时依赖。

⚠
需要 WebKitGTK 4.1。Ubuntu 22.04+ / Debian 12+ 自带,deb 会替你检查。 另外窗口模糊取决于桌面合成器:KWin 开了 blur 才有真玻璃,GNOME 默认没有,会自动降级成磨砂。
  1. 装 deb 包。在下载目录执行下面的命令,./ 不能省,否则 apt 会去软件源里找包名。
  2. 从应用菜单启动。装完菜单里直接就有 GlassMC,图标和分类都已注册,不用注销重登;终端里输 glassmc 也行。
  3. 开始用。登录账号 →「安装」页挑版本 →「版本」页启动。
$ sudo apt install ./GlassMC.deb

卸载 sudo apt remove glassmc。游戏数据在 ~/.local/share/GlassMC,卸载不会动它,重装回来接着用。

其他发行版 · 用绿色版

Fedora、Arch、openSUSE 这些没有 apt,下 GlassMC-linux.tar.gz,解压后直接运行:

$ tar xzf GlassMC-linux.tar.gz && ./glassmc

这样会把 glassmc 解压到当前目录。想全局可用就 sudo mv glassmc /usr/local/bin/。绿色版不会自动补依赖,缺库时看下一节。

打不开怎么办 二选一
方法一 · 补上运行库推荐
$ sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0

报错是 error while loading shared libraries 就是缺库,装完再启动一次。Fedora 上是 sudo dnf install webkit2gtk4.1,Arch 上是 sudo pacman -S webkit2gtk-4.1。

方法二 · 手动给执行权限
$ chmod +x glassmc && ./glassmc

部分文件管理器解压时会丢掉可执行位,表现是「双击没反应」或 Permission denied,加一次权限就好。

系统要求与数据目录
macOS 15+Apple Silicon 与 Intel 共用一个包~/Library/Application Support/GlassMC
Windows 10 1809+ / 11x64,需要 WebView2%APPDATA%\GlassMC
Linux主流发行版,需要 WebKitGTK 4.1~/.local/share/GlassMC

Java 不用自己装,启动器按版本自动配 8 / 11 / 17 / 21。整个数据目录拷走就是完整备份,卸载时删掉它即可,不会在系统别处留东西。

COMMUNITY

这是开源项目,不是一个人的作品

代码、文档、测试设备,都可以来自别人。

ISSUE

报一个问题

能复现的 bug 是最有价值的贡献。表单会问你要日志、版本号和系统版本,填全了通常几天内就能定位。

新建 issue →按表单填
DISCUSSION

问一句、聊两句

「这个整合包能不能跑」「皮肤站怎么填」这类问题去 Discussions,不问也能看看别人踩过什么坑。

进入讨论区 →不需要开 issue
PULL REQUEST

直接改代码

Rust 后端加纯静态前端,没有构建步骤。标注 good first issue 的都是半天能做完的小事,第一次提 PR 也欢迎。

怎么参与 →GPLv3 开源

贡献者名单在 GitHub 上; 参与即表示同意贡献者行为准则。

FAQ

遇到问题先看这里

七条最常被问到的。

Q1提示「GlassMC 已损坏,无法打开」怎么办?

去「系统设置 → 隐私与安全性 → 安全性」里点「仍要打开」。先双击一次 GlassMC,弹提示时点「取消」;打开系统设置 → 隐私与安全性,向下滚到「安全性」,会看到一行 “GlassMC” 已被阻止使用…,点右边的 仍要打开,输入密码;再双击 GlassMC,弹窗里出现 打开 按钮,点它即可。

如果「安全性」里始终没有这一行,用上面的 xattr 命令放行一次;仍然不行就是 dmg 没下完整,重下一遍。不要点「移到废纸篓」,文件没坏。

Q2启动游戏时报 Java 相关的错误?

去「安装 → Java 环境」看有没有可用运行时。没有就点安装,选 17 或 21(1.17 及更新用 17/21,1.16 及更早用 8)。导入来的实例也可以选「使用实例自带的 Java」。

日志里出现 UnsupportedClassVersionError,就是 Java 版本比游戏要求的低,换更高的。

Q3内存该给多少?

8 GB 内存给 4 GB,16 GB 给 6~8 GB,大型整合包可以到 8~12 GB。别全给游戏,否则系统本身会卡。判断标准:游戏里按 F3 看右上角内存占用,长期贴着上限就该加。

Q4皮肤站登录了,游戏里还是默认皮肤?

确认启动的实例用的是那个皮肤站账号。外置登录会在启动时注入 authlib-injector,日志里应该出现 Authentication server: 你的皮肤站地址 和 Httpd is running。

看不到的话:去「设置 → 外置登录」确认注入器已就绪,点一次下载,再重启启动器启动游戏。

Q5以前 HMCL 的整合包和存档能直接用吗?

能。左侧「导入」会自动扫描 HMCL、官方启动器、Prism / MultiMC 的目录,选一个点导入,账号、版本、模组、存档都复制过来,原目录不受影响。

HMCL 的版本隔离实例(versions/xxx/ 里带 mods 和 saves 的那种)会被识别成隔离实例,启动时 --gameDir 指到该目录,不会串档。

Q6Windows / Linux 真的能用吗?

Windows:交叉编译出的是 PE32+ 可执行文件,只依赖系统 DLL 和 WebView2Loader.dll。装进 wine 走完了「静默安装 → 从 Program Files 启动 → 卸载无残留」。真实 Windows 上的窗口长什么样还没看到。

Linux:Ubuntu 26.04 原生编译,在 Xvfb 里跑了一遍完整流程——八个页面正常渲染、真实下载 1.21.11(62 个文件 + 4591 个资源对象,0 失败)、启动进到主菜单。窗口模糊没看到:测试环境没有合成器,档位落在「磨砂」。

最可能出问题的是 glass.rs(Mica / Acrylic 版本差异、合成器行为)和 game.rs(进程组管理、Windows 控制台窗口)。遇到了欢迎提 issue。

Q7能不安装先看看界面吗?

可以,glassmc.shuan.uk/web 是同一套前端跑在浏览器里,八个页面都能点,安装、启动、联机走的是示例数据。

它只是让人先看一眼界面:真的下版本、开游戏还是得装桌面版。