GitHub - EVV1E/waylandcraft: Wayland Compositor in Minecraft · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
EVV1E
waylandcraft
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>411
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>276 Commits<br>276 Commits
assets
assets
gradle/wrapper
gradle/wrapper
native
native
src/main
src/main
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
build.gradle
build.gradle
gradle.properties
gradle.properties
gradlew
gradlew
settings.gradle
settings.gradle
View all files
Repository files navigation
Wayland Compositor in Minecraft
Demo video
System dependencies
OS: Linux
Minecraft 26.1.2
Fabric mod loader
xkbcommon library 1.11.0
xkbcommon tools (xkbcli)
Frequently Asked Questions
How do I use this thing?
Download the mod from the releases section, install Minecraft Fabric for 26.1.2 and drag the jar file in your mods folder.<br>Look at your keybind settings. By default V opens the app launcher, G enables keyboard capture allowing you to type in<br>the windows, B opens the window manager screen.
How can I press Escape in the windows?
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,<br>so the ESC key is forwarded to the application.
How to do the relative mouse movement thing for 3D games?
Move your mouse over the window, then activate the hard keyboard capture mode. (ALT-Q)<br>Exiting the hard keyboard capture mode releases the mouse.
Will there be multiplayer support?
Multiplayer support would require video streaming, a bunch of networking code and a rewrite of input handling,<br>so it's not really planned right now.
But can I use it on a server though?
You can, but because it's a client-side mod, other players won't see your windows or be able to interact with them.<br>Also you will not receive the windows as items. To spawn a window in the world, go into the wm screen (default bind B)<br>and then press and hold the "Grab" button.
Does this work in VR?
Depending on your VR mod, you can probably get the windows to display fine but you probably won't be able to interact with<br>the windows using your controller. Soooo, kinda.
Does this work with shaders?
The windows are rendered into the world by themselves (not like blocks or entities) so a lot of shaders will break the functionality.
Compilation
You need a Rust development environment and a Java 25 SDK.<br>Change into the native subdirectory and run cargo build.<br>This compiles the native code and puts the shared library into native/target/debug/libwaylandcraft.so.<br>From here you can just return to the main directory and then run ./gradlew build to produce the jar file<br>in build/libs/ or run ./gradlew runClient to run it in a development environment.
Images
Disclaimer
This compositor still has lots of issues and bugs. Use it at your own risk or whatever.
The entire project was written without the usage of any generative AI .
About
Wayland Compositor in Minecraft
Topics
minecraft
wayland-compositor
wayland
Resources
Readme
License
GPL-3.0 license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
411<br>stars
Watchers
watching
Forks
forks
Report repository
Releases
Release v1.0.0
Latest
May 17, 2026
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Java<br>58.6%
Rust<br>40.8%
GLSL<br>0.6%
You can’t perform that action at this time.