Wayland Compositor in Minecraft
Now available on Modrinth!
- OS: Linux
- Minecraft 26.1.2
- Fabric mod loader
- xkbcommon library 1.11.0
- xkbcommon tools (xkbcli)
Download the mod from the releases section, install Minecraft Fabric for 26.1.2 and drag the jar file in your mods folder.
Look at your keybind settings. By default V opens the app launcher, G enables keyboard capture allowing you to type in
the windows, B opens the window manager screen.
Instead of using G to capture the keyboard, use ALT+Q instead. The only way to turn it off is to press ALT-Q again,
so the ESC key is forwarded to the application.
Move your mouse over the window, then activate the hard keyboard capture mode. (ALT-Q)
Exiting the hard keyboard capture mode releases the mouse.
Multiplayer support would require video streaming, a bunch of networking code and a rewrite of input handling, so it's not really planned right now.
You can, but because it's a client-side mod, other players won't see your windows or be able to interact with them.
Also you will not receive the windows as items. To spawn a window in the world, go into the wm screen (default bind B)
and then press and hold the "Grab" button.
Depending on your VR mod, you can probably get the windows to display fine but you probably won't be able to interact with the windows using your controller. Soooo, kinda.
The windows are rendered into the world by themselves (not like blocks or entities) so a lot of shaders will break the functionality.
Try setting the environment variable __GL_THREADED_OPTIMIZATIONS=0 in your launcher.
Some users reported success by setting the Improved Transparency option in the game settings to enabled.
Make sure you don't use a sandboxed version of the launcher, i.e. don't use the Flatpak, go with a natively installed version of it.
You need a Rust development environment and a Java 25 SDK.
./build.sh #all arguments are passed to cargo buildThe final jar file will be in build/libs, or run ./gradlew runClient
for a development environment
This compositor still has lots of issues and bugs. Use it at your own risk or whatever.
All contributions have to be made an accordance with the GPLv3 license (see LICENSE).
Waylandcraft has a strong no generative AI policy for reasons of code and contribution quality as well as ethical and copyright concerns.
All contributions have to be made without major LLM assistance in the final submitted code. You sign this off every time you submit code
via a pull request or similar.