你的网页应用,运行在 Minecraft 中。
WebGUI 在游戏中打开真正的网页——作为全屏界面,或作为游戏画面之上的透明叠加层。不是换皮的库存界面,也不是另一个需要学习的 UI 框架:而是由真正的 Chromium 渲染的真实 HTML、CSS 和 JavaScript。
如果你能构建一个网站,你就能构建 Minecraft 的界面。
人们用它构建什么
- 服务器商店:看起来像在线商店,带有图片、搜索功能和购物车
- 任务日志和百科全书:拥有真实的排版和布局
- 实时地图:使用 Leaflet 或你自己的 Canvas,跟随玩家移动
- HUD 叠加层:团队得分、计时器、血条、小地图等,绘制在世界之上
- 管理面板:供工作人员使用,与你已经在浏览器中运行的仪表板相同
- 自定义死亡屏幕:显示是谁杀了你,并让你重生
- 启动菜单和大厅屏幕,带有你服务器的专属品牌标识
- 完整的内置应用:任何你原本会构建为 Web 应用的东西
为什么感觉不同
你已经使用的东西都能正常工作。React、Vue、Svelte 或纯 JavaScript。Tailwind。你的组件库。你的动画、你的 API、你的 WebSocket。你在浏览器中进行开发并使用热重载,然后将模组指向该页面——它在游戏中的外观与在浏览器中完全相同。
这个页面不仅仅是装饰。它知道谁正在查看它以及周围发生了什么——玩家的名称、生命值、饥饿值、位置、朝向、准星下的方块或生物——随着玩家的移动而实时更新。并且它可以交互:页面上的点击变成服务器上的事件,所以商店可以真正售卖商品,按钮可以真正执行命令。
// 这就是整个集成代码
window.webgui.on('client', player => {
document.title = `${player.username} — ${player.health} HP`;
});
window.webgui.postToGame({ channel: 'shop:buy', item: 'diamond' });
对于 React、Vue 和 Svelte,有一个包含现成 hooks 和 stores 的包:
npm i @webgui/client
你甚至不需要 Web 主机
将文件放在服务器的文件夹中,并将模组指向它们。它们通过玩家已经使用的同一连接传输——无需域名、无需托管费用、无需打开端口,即使在 NAT 后面也能工作。编辑一个文件,运行一条命令,玩家打开的页面就会在他们面前刷新。
更喜欢使用自己的主机?没有任何变化:https:// 地址的工作方式与往常一样,两者可以自由混合使用。
面向服务器所有者
打开一个页面只需一条命令:
/webgui gui @a https://your-site.example/shop
/webgui hud @a webgui:/hud.html
页面也可以绑定到实体上,因此右键点击村民即可打开以该村民上下文为基础的商店。模组打开的每个 URL 都携带签名令牌,因此你的后端无需登录界面就能知道是哪个玩家在请求。没有安装模组的玩家会被告知他们缺少了什么,而不是安静地看到空白。
兼容性
| Minecraft | Loader |
|---|---|
| 26.2 · 26.1.2 | NeoForge |
| 1.21.5 – 1.21.11 | Fabric · NeoForge |
| 1.21 – 1.21.1 | Fabric · NeoForge |
| 1.20.1 | Fabric |
Minecraft 26 目前仅支持 NeoForge —— Fabric 正在等待 26.x 的 Yarn 映射。
安装: 在 Fabric 上你需要 Fabric API,仅此而已——浏览器随 jar 包一起分发。在 NeoForge 上,请同时添加 Rinku;启动器会自动识别它们。Chromium(约 150 MB)会在首次启动时自行下载。需要 Java 21,或 Minecraft 26 所需的 Java 25。
链接
- 文档 — — 指南、完整 API 和可粘贴的示例
- GitHub — — 问题反馈和源代码
- npm —
Your web app, running inside Minecraft.
WebGUI opens a real web page in the game — as a full-screen interface or as a transparent overlay on top of gameplay. Not a reskinned inventory, not another UI framework to learn: actual HTML, CSS and JavaScript, rendered by actual Chromium.
If you can build a website, you can build a Minecraft interface.
What people build with it
- Server shops that look like an online store, with images, search and a cart
- Quest journals and codexes with real typography and layout
- Live maps — Leaflet or your own canvas, following the player as they walk
- HUD overlays — team scores, timers, health bars, a minimap, drawn over the world
- Admin panels for staff, with the same dashboard you already run in a browser
- Custom death screens that say who killed you and let you respawn
- Launch menus and lobby screens with your server's own branding
- Entire in-game apps — anything you would otherwise build as a web app
Why it feels different
Everything you already use keeps working. React, Vue, Svelte or plain JavaScript. Tailwind. Your component library. Your animations, your API, your WebSocket. You develop in a browser with hot reload, then point the mod at the page — and it looks exactly the same in the game.
The page is not a decoration, either. It knows who is looking at it and what is happening around them — the player's name, health, food, position, where they are looking, which block or mob is under the crosshair — updated as they move. And it can talk back: a click in the page becomes an event on the server, so a shop can actually sell, and a button can actually run a command.
// This is the whole integration
window.webgui.on('client', player => {
document.title = `${player.username} — ${player.health} HP`;
});
window.webgui.postToGame({ channel: 'shop:buy', item: 'diamond' });
For React, Vue and Svelte there is one package with hooks and stores ready to go:
npm i @webgui/client
You don't even need a web host
Put your files in a folder on the server and point the mod at them. They travel down the same connection the player is already on — no domain, no hosting bill, no port to open, works behind NAT. Edit a file, run one command, and the page a player has open refreshes in front of them.
Prefer your own host? Nothing changes: an https:// address works exactly as it always did, and the two mix freely.
For server owners
Opening a page is one command:
/webgui gui @a https://your-site.example/shop
/webgui hud @a webgui:/hud.html
Pages can also be bound to an entity, so right-clicking a villager opens your shop with that villager's context. Every URL the mod opens carries a signed token, so your backend knows which player is asking without a login screen. Players without the mod are told what they are missing instead of quietly seeing nothing.
Compatibility
| Minecraft | Loader |
|---|---|
| 26.2 · 26.1.2 | NeoForge |
| 1.21.5 – 1.21.11 | Fabric · NeoForge |
| 1.21 – 1.21.1 | Fabric · NeoForge |
| 1.20.1 | Fabric |
Minecraft 26 is NeoForge-only for now — Fabric is waiting on Yarn mappings for 26.x.
Installing: on Fabric you need Fabric API, and that is it — the browser ships inside the jar. On NeoForge, add Rinku alongside it; launchers pick it up automatically. Chromium (~150 MB) downloads itself on first launch. Java 21, or Java 25 for Minecraft 26.
Links
- Documentation — — guides, the full API, and examples you can paste
- GitHub — — issues and source
- npm —
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
下载 WebGUI
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WebGUI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
2.0.0 - 2026-10-13
此次大版本更新仅出于一个原因:WebGUI 不再依赖其他模组。页面 API 未发生更改,网络协议也保持一致,因此现有页面仍可正常运行,且 2.0.0 版本的客户端仍可与 1.8.x 版本的服务器通信。
新增
- Fabric 支持 Minecraft 26.2,双加载器均支持 26.3。 26.3 作为测试版发布:游戏本身仍处于快照阶段,它用 SDL 替换了 GLFW,并将 GPU API 从
blaze3d中移出,因此本模组中涉及窗口和屏幕的部分在这些新机制下进行了适配。
更改
- 内置更新检查并始终运行。 服务器在启动时会向 Modrinth 询问是否存在与其 Minecraft 版本和加载器兼容的更高版本 WebGUI;若无法访问 Modrinth,则回退到 GitHub Releases。此前,除非操作员发现
updateCheckUrl并自行配置端点(但几乎无人这样做),否则不会执行任何操作。- 操作员加入时也会在聊天栏收到通知,这样更新信息不仅存在于启动日志中。设置
updateNotifyInChat为false可保留控制台提示而取消聊天栏通知。普通玩家永远不会收到此类通知。 updateCheckUrl已移除。 地址现在由模组固定。配置文件中若仍包含该键值并非错误,而是会被忽略。
- 操作员加入时也会在聊天栏收到通知,这样更新信息不仅存在于启动日志中。设置
- 页面 URL 现在必须指定模组将打开的方案:
webgui://、https://、http://、wss://或ws://。其他方案将被拒绝,并在日志中输出一行提示,而非交由浏览器处理——因为 URL 可能来自服务器,file://会读取玩家磁盘,而javascript:会在当前打开的任何页面内执行代码。webgui:name.html和webgui:/name.html过去与webgui://name.html含义相同,现在不再如此。统一一种拼写更易于校验。使用旧格式的配置文件需改为双斜杠形式。
- 服务器现在同时启动 HUD 页面和全屏页面。 首次启动时,会在
index.html旁创建config/webgui/web/hud.html:这是一个位于角落的小卡片,标明按键功能——F6 打开主菜单,` 与覆盖层交互,F12 打开开发者工具——并链接至 webgui.space。它不绘制自身背景,这正是叠加在世界之上的覆盖层所需的行为。- 默认情况下加入服务器时即显示此 HUD:
autoHudUrl指向该页面,且除非配置另有说明,否则autoHudOnJoin默认为开启状态。若服务器之前已设置过任一选项,则保留其原有设置。
- 默认情况下加入服务器时即显示此 HUD:
- 模组的设置界面现提供自解释说明。 每个选项均有工具提示,说明其作用及性能开销,遵循游戏视频设置的风格理念;此外还有两个设置项被移至界面中,而非仅存在于配置文件中:
- 询问下载保存位置。 关闭时,文件存入
webgui-downloads/目录,文件名会在聊天栏显示;开启时,每次下载都会弹出系统保存对话框。引擎原本就支持此功能,但模组此前未提供选项。 - 允许页面自主播放声音。 默认关闭,与之前一致:视频和音频需等待用户点击才会播放,如同浏览器对待用户未主动打开的标签页。
- 页面帧率 原先仅在配置文件中存在;现在与其他设置一样成为独立选项。
- 界面曾提示所有人需在启动器中添加
--remote-debugging-port=9222。这适用于旧版浏览器库,其命令行参数在模组加载前就已固定;新版模组从内部获取端口号,因此该建议针对的问题已不存在。调试器地址仅在监听时显示,且仅在开发者工具开启时可见。
- 询问下载保存位置。 关闭时,文件存入
- 页面滚动起始偏移量从 7 档改为 25 档, 设置上限提升至 40 档。选择 7 档是为了修复滚轮几乎无反应的问题,但在长页面上仍显得缓慢。已保存该设置的客户端将保留其原有值;无论如何,该设置均可在模组设置界面中找到。
- 主菜单快捷键不再打开
example.com。 安装模组后在主屏幕按下该键时,玩家原本看到的是这个占位符,因为此时服务器尚未发送任何设置。现在改为打开 webgui.space,至少能说明该按键的用途。 mainMenuUrl默认指向服务器自身的页面。 全新服务器会在配置中写入webgui://index.html,这是它同时创建的起始页面,因此首次启动时按下主菜单快捷键即可看到服务器内容,而非example.com。若配置文件已存在该设置,则不做修改。- WebGUI 不再需要其他模组即可运行。 嵌入式浏览器现已集成于 WebGUI 内部,不再由独立的库模组提供,因此安装 WebGUI 只需一个文件。Chromium 本身仍在首次启动时按机器下载一次,存放于游戏目录之外,并由所有实例共享。
修复
- Fabric 26.2 及更高版本上的自定义死亡画面。 此前它钩入了游戏已移除的方法,混合配置将其视为致命错误——导致这些版本的游戏完全无法启动。
- 游戏现在可以正常退出。 退出时曾残留两个线程——页面服务器和 Chromium——导致进程无法终止:在 1.21.1 及更早版本中静默失败,从 1.21.11 起则表现为由游戏自身关机看门狗生成的崩溃报告。
- 26.3 版本中输入页面内容。 SDL 仅在文本输入模式启动后才传递按键字符,而游戏仅为自己的文本字段启动该模式。按键事件和快捷键(如 Ctrl+A 和 Ctrl+V)正常工作,但字母并未传入页面。
- 26.3 版本下的光标形状。 光标形状现在由每帧决定,直接设置会被覆盖,导致无法及时显示。
- 页面中的回车键。 在任何版本中均未产生字符事件,因此
textarea捕获除该键外的所有按键,表单也无法通过回车提交。 - 修复 NeoForge 在每次启动 26.3 时关于已弃用模组元数据的警告。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
让你能够在世界中的任何位置定位结构。
模组
? 使用命令保存和加载玩家或他人的背包/套装。
模组
一堆修复
模组
TerraFirmaCraft (TFC) 是一个全面转换模组,对生存模式进行了彻底的改造与重新设计。
模组
一个基于构建器的 Minecraft 配置库!
模组
所有本应存在的事物
评论 0
登录后参与评分
还没有评论,来抢沙发吧