企业官网建设流程全解析

V/G/B三个按键玩转Minecraft窗口：WaylandCraft新手上手完整指南

【免费下载链接】waylandcraftWayland Compositor in Minecraft项目地址: https://gitcode.com/gh_mirrors/wa/waylandcraft

WaylandCraft 是一款运行在 Minecraft 里的Wayland 合成器模组（Wayland Compositor in Minecraft），它把你的 Linux 桌面应用直接变成游戏世界中的 3D 悬浮窗口，让你用V、G、B三个按键就能启动应用、打字输入和管理窗口，无需离开游戏就能操作浏览器、终端和媒体播放器。

一、安装前准备：环境要求清单

WaylandCraft 是仅限 Linux的 Fabric 模组，安装前请确认以下依赖（详见 README.md）：

⚠️ 三个新手最容易踩的坑：

1. 不要用 flatpak 打包的 Minecraft 启动器，否则无法启动系统应用；
2. NVIDIA 显卡用户请在启动器中设置环境变量__GL_THREADED_OPTIMIZATIONS=0；
3. Zink OpenGL 驱动可能引起问题，请使用原生 OpenGL 驱动。

二、V 键：一键打开应用启动器

按默认键位V，WaylandCraft 会打开应用启动器（App Launcher），它会读取你系统里的桌面入口（.desktop 文件），以分类列表的形式展示所有可启动的应用。选中应用后，一个真实的 Linux 窗口就会以 3D 表面形式出现在 Minecraft 世界中——就像截图里那样的浏览器、文件管理器和终端。

应用启动器与桌面文件解析的实现位于 AppLauncherScreen.java 和 XDGDesktopManager.java。

三、G 键：键盘捕获，在窗口里打字

默认情况下，键盘输入仍归 Minecraft 所有。按G启用键盘捕获（keyboard capture），所有按键就会转发给当前焦点的窗口，你可以在窗口内正常打字、搜索、操作终端；再按Esc即可退出捕获，把键盘还给游戏。

三个按键的注册逻辑集中在 WaylandCraft.java，你也可以在游戏"控制"设置中修改它们。

进阶技巧：ALT+Q 硬捕获

想在窗口里按 Esc 键？把鼠标移到窗口上，按ALT+Q进入硬键盘捕获（hard capture）模式，Esc 键会被完整转发给应用，退出时再按一次 ALT+Q 即可。这也是玩3D 游戏获得相对鼠标移动的标准姿势：

1. 将鼠标移动到窗口上；
2. 按 ALT+Q 进入硬捕获模式，鼠标被锁定在窗口内；
3. 按 ALT+Q 退出，释放鼠标。

四、B 键：窗口管理器，全面掌控桌面

按B打开窗口管理器（Window Manager Screen），这是管理所有窗口的主控面板，可对任意窗口执行：

• 移动 / 缩放：拖动调整窗口在 3D 空间中的位置和大小；
• 固定（Pin）：把窗口固定在你的视角前；
• 隐藏 / 恢复：临时隐藏某个窗口；
• 抓取（Grab）：长按 Grab 按钮，可在没有服务端支持的环境下自行生成窗口物品。

窗口管理器界面实现见 WindowManagerScreen.java，输入事件经由 WaylandCraftBridge.java 的 Rust 原生桥接层传递给真正的 Wayland 客户端。

五、新手常见问题速答 🎮

问：服务器上能用吗？可以。它是纯客户端模组，其他玩家看不到你的窗口。如果服务器也安装了模组，其他玩家可用自己的窗口物品；服务器不支持时，可在 B 键窗口管理器里长按 Grab 按钮生成窗口。

问：能运行 X11 应用吗？可以。v2.0.0 起集成 xwayland-satellite，只要系统装了对应二进制文件，X11 应用会自动被支持。

问：支持光影吗？v2.0.2 起支持 Iris 光影（见 IrisCompat.java），但窗口边框可能较粗、远处文字清晰度略降，部分光影需关闭 TAA 等功能。

问：有联机同步窗口吗？联机需要视频流传输和输入系统重写，目前暂无计划。

六、三分钟上手总结

从拖入 mods 文件夹到用 V/G/B 三键打开你的第一个窗口，WaylandCraft 让你第一次真正"把 Linux 桌面装进方块世界"。祝你在 Minecraft 里玩得开心！🎉

【免费下载链接】waylandcraftWayland Compositor in Minecraft项目地址: https://gitcode.com/gh_mirrors/wa/waylandcraft