How polari-stars-mc/relativity-craft works
RelativityCraft is a Minecraft mod that turns selected block volumes into movable, physics-driven entities while retaining block interactions and world behavior. The principal path runs from client interaction and server handling through physicalized-volume state and world physics, backed by a Java-to-native Rapier layer. Separate branches represent enclaves, celestial bodies, redstone, rendering, and fluids. The README is empty; unsampled subsystem links are included only where the source index supports them, so some event-driven wiring is not shown.
Main entry points: PhysicsWorldManager.java Physics world manager · PhysicalizedInteractionHandler.java Interaction handler · PhysicalizedVolumeEntity.java Volume entity · PhysicalizedVolumeSnapshot.java Volume snapshot
Components 22
Mod and interaction
- Client interactions
src/main/java/org/polaris2023/relativity/client/PhysicalizedClientInteractions.java - Interaction network
src/main/java/org/polaris2023/relativity/network/PhysicalizedInteractionNetwork.java - Interaction handler
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedInteractionHandler.java - Physicalized raycaster
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedRaycaster.java - Volume mapping
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedVolumeMapping.java
Physicalized volumes
- Volume manager
src/main/java/org/polaris2023/relativity/physicalization/PhysicalizedVolumeManager.java - Volume entity
src/main/java/org/polaris2023/relativity/entity/PhysicalizedVolumeEntity.java - Volume snapshot
src/main/java/org/polaris2023/relativity/physicalization/PhysicalizedVolumeSnapshot.java - Block snapshot
src/main/java/org/polaris2023/relativity/physicalization/PhysicalizedBlockSnapshot.java
Physics simulation
- Physics world manager
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Physics commands
src/main/java/org/polaris2023/relativity/world/PhysicsCommand.java
World features
- Redstone mapping
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedRedstoneMapping.java - Fluid domains
src/main/java/org/polaris2023/relativity/fluid/FluidDomainManager.java - Water colliders
src/main/java/org/polaris2023/relativity/world/WaterSurfaceColliderManager.java - Celestial bodies
src/main/java/org/polaris2023/relativity/celestial/CelestialBody.java - Enclave entity
src/main/java/org/polaris2023/relativity/entity/EnclaveEntity.java - Volume rendering
src/main/java/org/polaris2023/relativity/render/PhysicalizedVolumeRenderer.java - Enclave storage
src/main/java/org/polaris2023/relativity/enclave/Enclave.java
Native physics
- Rapier native world
src/main/java/org/polaris2023/relativity/nativeaccess/RapierNativeWorld.java - Native API
src/main/java/org/polaris2023/relativity/nativeaccess/RelativityCraftRapier.java - Rust physics FFI
native/src/ffi.rs
Other components
- Minecraft player
Connections 23
- Minecraft player → Client interactions: initiates
- Client interactions → Interaction network: sends actions
src/main/java/org/polaris2023/relativity/client/PhysicalizedClientInteractions.java - Interaction network → Interaction handler: dispatches actions
src/main/java/org/polaris2023/relativity/network/PhysicalizedInteractionNetwork.java - Interaction handler → Physicalized raycaster: raycasts targets
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedInteractionHandler.java - Interaction handler → Volume entity: updates blocks
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedInteractionHandler.java - Interaction handler → Volume snapshot: reads and updates
src/main/java/org/polaris2023/relativity/interaction/PhysicalizedInteractionHandler.java - Volume entity → Volume snapshot: holds state
src/main/java/org/polaris2023/relativity/entity/PhysicalizedVolumeEntity.java - Volume snapshot → Block snapshot: indexes cells
src/main/java/org/polaris2023/relativity/physicalization/PhysicalizedVolumeSnapshot.java - Physicalized raycaster → Volume mapping: maps hits
- Physics world manager → Volume manager: manages volumes
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Physics world manager → Volume entity: registers bodies
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Physics world manager → Physics commands: queues work
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Physics world manager → Rapier native world: runs simulation
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Physics world manager → Celestial bodies: registers bodies
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Physics world manager → Enclave entity: registers bodies
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Rapier native world → Native API: calls native API
src/main/java/org/polaris2023/relativity/nativeaccess/RapierNativeWorld.java - Native API → Rust physics FFI: bridges calls
- Fluid domains → Rapier native world: applies fluid forces
src/main/java/org/polaris2023/relativity/fluid/FluidDomainManager.java - Water colliders → Fluid domains: samples water
src/main/java/org/polaris2023/relativity/world/WaterSurfaceColliderManager.java - Water colliders → Physics commands: queues updates
src/main/java/org/polaris2023/relativity/world/WaterSurfaceColliderManager.java - Redstone mapping → Physics world manager: queries bodies
src/main/java/org/polaris2023/relativity/world/PhysicsWorldManager.java - Enclave entity → Enclave storage: stores blocks
- Volume entity → Volume rendering: renders volume