How tastytrash/spatial-gui works
Spatial GUI is a client-side Minecraft mod that turns supported inventory and container screens into configurable 3D planes. The main flow selects eligible screens, captures their contents to a texture, and renders that texture in first- or third-person; camera, mouse, and screen behavior are adapted around that display. Configuration and keybinds control the experience, with optional compatibility for Inventory Particles and documented EMI support. Connections are limited to SOURCE INDEX references, shown excerpts, and README statements; some rendering and integration internals are unsampled.
Main entry points: SpatialGUIRenderer.java Spatial GUI orchestration · SpatialGUIClient.java Client screen selection · render Render and camera hooks · SpatialGUIConfig.java Configuration
Components 21
Mod setup
- Mod initialization
src/main/java/org/tastytrash/spatialGUI/SpatialGUI.java - Configuration
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIConfig.java - Keybinds
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIKeybinds.java - Mod Menu config
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIModMenu.java
Screen handling
- Client screen selection
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIClient.java - Screen hooks
src/main/java/org/tastytrash/spatialGUI/mixin/client - EMI screen compatibility
src/main/java/org/tastytrash/spatialGUI/mixin/compat/EMIScreenManagerMixin.java
3D rendering
- Spatial GUI orchestration
src/main/java/org/tastytrash/spatialGUI/render/SpatialGUIRenderer.java - Screen capture
src/main/java/org/tastytrash/spatialGUI/render/ScreenExtractor.java - Texture target
src/main/java/org/tastytrash/spatialGUI/render/TextureTargetManager.java - 3D screen rendering
src/main/java/org/tastytrash/spatialGUI/render/InventoryRenderer.java - Screen geometry utilities
src/main/java/org/tastytrash/spatialGUI/util/RenderUtil.java - Math utilities
src/main/java/org/tastytrash/spatialGUI/util/MathUtil.java
View and input
- Render and camera hooks
src/main/java/org/tastytrash/spatialGUI/mixin/render - GUI and mouse hooks
src/main/java/org/tastytrash/spatialGUI/mixin/gui - Inventory Particles compatibility
src/main/java/org/tastytrash/spatialGUI/compat/InventoryParticlesCompat.java - Camera collision and tuning
src/main/java/org/tastytrash/spatialGUI/util/CameraUtil.java - Mouse position utilities
src/main/java/org/tastytrash/spatialGUI/util/MouseHandlerUtil.java - Screen animation
src/main/java/org/tastytrash/spatialGUI/util/AnimationUtil.java
Other components
- Player
- Minecraft client
Connections 25
- Player → Minecraft client: opens screens
README.md - Minecraft client → Client screen selection: provides screens
- Mod initialization → Configuration: registers
src/main/java/org/tastytrash/spatialGUI/SpatialGUI.java - Client screen selection → Keybinds: registers
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIClient.java - Client screen selection → Spatial GUI orchestration: creates
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIClient.java - Client screen selection → Configuration: checks settings
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIClient.java - Mod Menu config → Configuration: opens config
src/main/java/org/tastytrash/spatialGUI/client/SpatialGUIModMenu.java - Spatial GUI orchestration → Screen capture: captures screens
src/main/java/org/tastytrash/spatialGUI/render/SpatialGUIRenderer.java - Spatial GUI orchestration → Texture target: manages target
src/main/java/org/tastytrash/spatialGUI/render/SpatialGUIRenderer.java - Spatial GUI orchestration → 3D screen rendering: renders screen
src/main/java/org/tastytrash/spatialGUI/render/SpatialGUIRenderer.java - 3D screen rendering → Texture target: draws to
src/main/java/org/tastytrash/spatialGUI/render/InventoryRenderer.java - 3D screen rendering → Screen geometry utilities: uses geometry
src/main/java/org/tastytrash/spatialGUI/render/InventoryRenderer.java - Render and camera hooks → Spatial GUI orchestration: invokes rendering
src/main/java/org/tastytrash/spatialGUI/mixin/render/GameRendererMixin.java - Render and camera hooks → Camera collision and tuning: checks collisions
src/main/java/org/tastytrash/spatialGUI/mixin/render/CameraMixin.java - Render and camera hooks → Screen animation: uses animation
src/main/java/org/tastytrash/spatialGUI/mixin/render/CameraMixin.java - Render and camera hooks → Math utilities: uses math
src/main/java/org/tastytrash/spatialGUI/mixin/render/CameraMixin.java - GUI and mouse hooks → Spatial GUI orchestration: checks hooked screen
src/main/java/org/tastytrash/spatialGUI/mixin/gui/MouseHandlerMixin.java - GUI and mouse hooks → Mouse position utilities: maps mouse input
src/main/java/org/tastytrash/spatialGUI/mixin/gui/MouseHandlerMixin.java - GUI and mouse hooks → Inventory Particles compatibility: updates cursor
src/main/java/org/tastytrash/spatialGUI/mixin/gui/MouseHandlerMixin.java - Screen hooks → Client screen selection: queries screen eligibility
src/main/java/org/tastytrash/spatialGUI/mixin/client/AbstractRecipeBookScreenMixin.java - EMI screen compatibility → Client screen selection: uses screen state
src/main/java/org/tastytrash/spatialGUI/mixin/compat/EMIScreenManagerMixin.java - EMI screen compatibility → Mouse position utilities: uses mouse mapping
src/main/java/org/tastytrash/spatialGUI/mixin/compat/EMIScreenManagerMixin.java - Spatial GUI orchestration → Camera collision and tuning: uses camera tuning
src/main/java/org/tastytrash/spatialGUI/render/SpatialGUIRenderer.java - Player → Spatial GUI orchestration: views 3D screens
README.md - Configuration → Spatial GUI orchestration: configures modes
README.md