环境：ZorinOS 18.1 / GNOME / XWayland / Minecraft Java Edition 1.21.11 + Fabric
前言
Linux 桌面上跑 Minecraft Java 版，有两个陪伴了社区多年的经典问题：一是打开聊天栏时输入框里会凭空多出一个字符，二是游戏窗口在 Wayland 环境下丢失图标。两个问题看似不相关，根源却都指向同一件事——Minecraft 的底层输入/窗口库 LWJGL 对 Linux 显示协议的适配历史包袱。
这篇文章记录了这两个问题的排查过程、根本原因，以及最终的解决方案。
Bug 一：打开聊天栏时多出一个 t 字符
现象
按下 T 键打开聊天栏，输入框里会自动出现一个 t；按 / 打开命令栏时同理（但 / 本来就应该出现，所以不那么明显）。
这个 bug 在 Mojang 的 issue tracker 上编号为 MC-122477，存在多年，在某些 Linux 桌面环境和 macOS 上复现，Windows 不受影响。
根本原因
X11 的键盘事件模型会产生两类事件：
KeyPress/KeyRelease：物理按键动作- 字符事件：这次按键产生的字符
Minecraft 监听到 T 键的 KeyPress 后，立刻把聊天 GUI 切换到打开状态并开始接受文本输入。问题在于，同一次按键产生的字符事件（t）在 GUI 切换后仍然被投递进来，被新打开的输入框接收并显示出来了。
本质上是事件没有被正确消费（consume）掉，属于 LWJGL 层面的事件处理竞态。
macOS 也存在相同问题，原因是 Cocoa 的键盘事件模型与 X11 类似，同样存在字符事件在 GUI 切换后延迟投递的情况。Windows 的 Win32 消息队列对按键消息有严格的窗口归属绑定，反而歪打正着地规避了这个问题。
解决方案
安装 Fabric mod：Mc122477Fix re updated
- Modrinth 页面：https://modrinth.com/mod/mc122477fix-re-updated
- 支持版本：1.16.x 至最新版
- 仅需 Fabric Loader，无需 Fabric API，无需任何额外 JVM 参数
- 纯 Client-side，不影响服务端
实现原理：通过 Mixin 在 ChatScreen 的 charTyped() 方法入口注入一个短暂的"开屏忽略帧"——屏幕 init() 时设置一个 flag，charTyped() 收到第一个字符时若 flag 还在就丢弃该字符并清除 flag。完全在 Minecraft 事件处理逻辑内部完成，不涉及 LWJGL 或 JVM 层面的任何改动，副作用极小。
Bug 二：Wayland / XWayland 下游戏窗口丢失图标
现象
使用官方 Minecraft Launcher 启动游戏后，任务栏和窗口装饰上的图标变成通用空白图标或 JVM 默认图标，而 Launcher 本身的图标显示正常。
根本原因
X11 和 Wayland 设置窗口图标的机制完全不同：
X11 的方式：应用程序通过 _NET_WM_ICON 属性直接把原始 RGBA 像素数据嵌进窗口属性，合成器直接读取渲染。LWJGL 用的就是这套。
Wayland / XWayland 的方式：合成器不读 _NET_WM_ICON，而是：读取窗口的 WM_CLASS → 去匹配系统里安装的 .desktop 文件 → 从 .desktop 的 Icon= 字段找系统图标主题里的图标文件。
Minecraft 游戏进程的 WM_CLASS 格式为 Minecraft* [版本号]（例如 Minecraft* 1.21.11），系统里没有对应的 .desktop 文件，自然匹配不到任何图标。
Launcher 之所以正常，是因为它有正经安装的 .desktop 文件（minecraft-launcher.desktop），StartupWMClass=minecraft-launcher 与窗口匹配。
解决方案
为每个已安装的游戏版本自动生成对应的 .desktop 文件，并通过 systemd path unit 监听版本目录变化，实现下载新版本后自动更新，无需手动维护。
第一步：图标文件
ZorinOS 自带的草方块图标位于：
/usr/share/icons/Zorin/512x512@2x/apps/minecraft.png
其他发行版可通过以下命令查找：
find /usr/share/icons /usr/share/pixmaps -name "minecraft*" 2>/dev/null
第二步：创建生成脚本
mkdir -p ~/.local/bin
cat > ~/.local/bin/minecraft-desktop-gen.sh << 'EOF'
#!/bin/bash
VERSIONS_DIR="$HOME/.minecraft/versions"
DESKTOP_DIR="$HOME/.local/share/applications"
ICON="/usr/share/icons/Zorin/512x512@2x/apps/minecraft.png"
mkdir -p "$DESKTOP_DIR"
for version_dir in "$VERSIONS_DIR"/*/; do
[ -d "$version_dir" ] || continue
version=$(basename "$version_dir")
cat > "$DESKTOP_DIR/minecraft-${version}.desktop" << DESKTOP
[Desktop Entry]
Type=Application
Name=Minecraft $version
Exec=true
Icon=$ICON
Terminal=false
Categories=Game;
StartupWMClass=Minecraft* $version
NoDisplay=true
DESKTOP
done
EOF
chmod +x ~/.local/bin/minecraft-desktop-gen.sh
注意 StartupWMClass 中的星号不能省略，实际 WM_CLASS 格式为 Minecraft* 版本号，可通过以下命令确认：
# 游戏运行时执行
xprop WM_CLASS
# 然后点击游戏窗口
第三步：创建 systemd path unit
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/minecraft-desktop-gen.service << 'EOF'
[Unit]
Description=Auto-generate Minecraft version .desktop files
[Service]
Type=oneshot
ExecStart=%h/.local/bin/minecraft-desktop-gen.sh
EOF
cat > ~/.config/systemd/user/minecraft-desktop-gen.path << 'EOF'
[Unit]
Description=Watch Minecraft versions directory
[Path]
PathChanged=%h/.minecraft/versions
Unit=minecraft-desktop-gen.service
[Install]
WantedBy=default.target
EOF
第四步：启用并立即执行一次
systemctl --user daemon-reload
systemctl --user enable --now minecraft-desktop-gen.path
~/.local/bin/minecraft-desktop-gen.sh
验证
ls ~/.local/share/applications/minecraft-*.desktop
grep StartupWMClass ~/.local/share/applications/minecraft-1.21.11.desktop
关于性能影响
几乎为零。systemd path unit 底层使用 Linux 内核的 inotify 接口，纯事件驱动，没有任何轮询。平时只是挂着一个文件描述符监听，CPU 占用为零。脚本仅在 ~/.minecraft/versions/ 目录发生变化时触发一次，运行几毫秒后即退出，不常驻内存。脚本本身是幂等的，重复执行只会覆盖同名文件，没有副作用。
总结
| 问题 | 根本原因 | 解决方案 |
|---|---|---|
聊天栏多出 t 字符 | LWJGL 键盘事件消费竞态（X11 / Cocoa） | Fabric mod：Mc122477Fix re updated |
| Wayland 下游戏窗口无图标 | XWayland 不读 _NET_WM_ICON，依赖 .desktop 匹配 | systemd path unit 自动生成版本对应的 .desktop 文件 |
两个方案都不需要修改 JVM 参数，不需要替换系统 LWJGL 库，引入新问题的风险极低。
折腾的乐趣大概就在这里——你不只是在用一个系统，你在理解它。