How evv1e/waylandcraft works
WaylandCraft is a Linux Minecraft mod that runs a Wayland compositor and presents application windows inside the Minecraft world. The main workflow is to launch or connect to an application, receive its surfaces through the native/Java bridge, render them as in-world displays, and forward player input back to the window. The README also documents an app launcher, window manager, window items, Xwayland support, and Iris shader compatibility. Some subsystem links rely on documented capabilities or index references; unsampled implementation details are not asserted.
Main entry points: WaylandCraft.java Client Startup · lib.rs Wayland Runtime · WLCAbstractWindow.java Window Surfaces · java_types.rs JNI Bridge
Components 22
Compositor Runtime
- Client Startup
src/main/java/dev/evvie/waylandcraft/WaylandCraft.java - Wayland Runtime
native/src/lib.rs - JNI Bridge
native/src/bridge/java_types.rs - Java Bridge
src/main/java/dev/evvie/waylandcraft/bridge/WaylandCraftBridge.java - Window Surfaces
src/main/java/dev/evvie/waylandcraft/bridge/WLCAbstractWindow.java - Surface Buffers
src/main/java/dev/evvie/waylandcraft/bridge/WLCSurface.java
World Interaction
- World Displays
src/main/java/dev/evvie/waylandcraft/displays/WindowDisplay.java - Input Capture
src/main/java/dev/evvie/waylandcraft/WaylandCraft.java - Pointer Grabs
src/main/java/dev/evvie/waylandcraft/grabs/PointerGrabMap.java - Window Manager
src/main/java/dev/evvie/waylandcraft/gui/WindowManagerScreen.java
Window Rendering
- Window Framebuffer
src/main/java/dev/evvie/waylandcraft/render/WindowFramebuffer.java - Render Utilities
src/main/java/dev/evvie/waylandcraft/render/RenderUtils.java
Apps and Items
- App Launcher
src/main/java/dev/evvie/waylandcraft/gui/AppLauncherScreen.java - Desktop Entries
src/main/java/dev/evvie/waylandcraft/desktop/DesktopEntry.java - Window Items
src/main/java/dev/evvie/waylandcraft/item/WindowItem.java - Window Item Sync
src/main/java/dev/evvie/waylandcraft/item/WindowItemManager.java
Mod Support
- Settings
src/main/java/dev/evvie/waylandcraft/settings/WaylandCraftSettingsManager.java - Item Networking
src/main/java/dev/evvie/waylandcraft/network/WaylandCraftNetworking.java - Server Item Manager
src/main/java/dev/evvie/waylandcraft/item/ServerItemManager.java
Other components
- Minecraft Player
- Linux Applications
- xwayland-satellite
Connections 24
- Minecraft Player → Client Startup: uses mod
README.md - Client Startup → Wayland Runtime: initializes
- Wayland Runtime → JNI Bridge: exposes JNI
native/src/lib.rs - JNI Bridge → Java Bridge: bridges calls
- Java Bridge → Window Surfaces: updates windows
- Linux Applications → Wayland Runtime: connects through Wayland
README.md - Wayland Runtime → xwayland-satellite: starts optionally
README.md - Window Surfaces → Surface Buffers: owns root surface
src/main/java/dev/evvie/waylandcraft/bridge/WLCAbstractWindow.java - Surface Buffers → Window Framebuffer: renders commits
src/main/java/dev/evvie/waylandcraft/bridge/WLCSurface.java - Window Framebuffer → Render Utilities: uses rendering helpers
src/main/java/dev/evvie/waylandcraft/render/WindowFramebuffer.java - Client Startup → World Displays: manages displays
src/main/java/dev/evvie/waylandcraft/WaylandCraft.java - World Displays → Window Surfaces: tests window surfaces
src/main/java/dev/evvie/waylandcraft/displays/WindowDisplay.java - Minecraft Player → Input Capture: provides input
README.md - Input Capture → Wayland Runtime: forwards input
- Client Startup → Pointer Grabs: manages grabs
src/main/java/dev/evvie/waylandcraft/WaylandCraft.java - Window Manager → Window Surfaces: selects windows
src/main/java/dev/evvie/waylandcraft/gui/WindowManagerScreen.java - Minecraft Player → Window Manager: opens screen
README.md - Minecraft Player → App Launcher: opens launcher
README.md - App Launcher → Desktop Entries: lists applications
- Client Startup → Desktop Entries: loads desktop entries
src/main/java/dev/evvie/waylandcraft/desktop/XDGDesktopManager.java - Minecraft Player → Window Items: uses window items
README.md - Window Item Sync → Item Networking: sends item updates
src/main/java/dev/evvie/waylandcraft/item/WindowItemManager.java - Item Networking → Server Item Manager: routes item payloads
src/main/java/dev/evvie/waylandcraft/item/ServerItemManager.java - Client Startup → Settings: loads settings
src/main/java/dev/evvie/waylandcraft/settings/WaylandCraftSettingsManager.java