How cookfishsev/mirebound works
Mirebound is a Minecraft quicksand gameplay mod: players encounter sinking terrain, experience configurable movement and struggle effects, accumulate mud contamination, and see those effects rendered on players, equipment, entities, and the environment. The repository also includes adaptive conversion of existing blocks, terrain-generation tools, tuning controls, and event-like systems such as eruptions and assimilation. The graph reflects the README and available tree; excerpts only confirm some runtime calls and data transfers, so uncertain wiring between broader subsystems is left out.
Main entry points: ClientNetworkHandlers.java Client network handlers · MudPlayerPhysicsController.java Sinking physics · MudCoverageService.java Player contamination · ClientMudState.java Player mud visuals
Components 19
Gameplay physics
- Sinking physics
src/main/java/com/fish/mirebound/mud/MudPlayerPhysicsController.java - Assimilation
src/main/java/com/fish/mirebound/assimilation/AssimilationSystem.java
Mud coverage
- Player contamination
src/main/java/com/fish/mirebound/coverage/MudCoverageService.java - Entity contamination
src/main/java/com/fish/mirebound/entitycoverage/EntityMudCoverageService.java - Equipment staining
src/main/java/com/fish/mirebound/coverage/armor/EquipmentSurfaceService.java - Skin stain rules
src/main/java/com/fish/mirebound/coverage/skin/SkinStainMask.java
Terrain systems
- Adaptive mud conversion
src/main/java/com/fish/mirebound/adaptive/AdaptiveMudService.java - Source block store
src/main/java/com/fish/mirebound/adaptive/AdaptiveMudSourceStore.java - Terrain generation
src/main/java/com/fish/mirebound/generation/MudTerrainGenerationManager.java - Mud tuning
src/main/java/com/fish/mirebound/mud/tuning/MudTuningManager.java
Client presentation
- Client network handlers
src/main/java/com/fish/mirebound/client/ClientNetworkHandlers.java - Player mud visuals
src/main/java/com/fish/mirebound/client/ClientMudState.java - Entity mud visuals
src/main/java/com/fish/mirebound/client/entitycoverage/ClientEntityMudCoverage.java - Mud rendering
src/main/java/com/fish/mirebound/client/MudSurfaceEffectRenderer.java - Armor rendering
src/main/java/com/fish/mirebound/client/ArmorMudLayer.java
Events and tools
- Mud eruptions
src/main/java/com/fish/mirebound/eruption/MudEruptionSystem.java - Mudwork items
src/main/java/com/fish/mirebound/content/mudwork/MudBallProjectile.java - Mud commands
src/main/java/com/fish/mirebound/command/MudCommands.java
Other components
- Player / world
Connections 21
- Player / world → Sinking physics: enters mud
- Sinking physics → Assimilation: checks state
- Sinking physics → Player contamination: tracks contact
- Player contamination → Player / world: persists state
- Player contamination → Client network handlers: sends coverage
- Entity contamination → Client network handlers: sends entity coverage
- Client network handlers → Player mud visuals: updates state
- Client network handlers → Entity mud visuals: updates state
- Player mud visuals → Mud rendering: supplies appearance
- Player mud visuals → Armor rendering: supplies coverage
- Entity mud visuals → Mud rendering: supplies spots
- Player / world → Equipment staining: reports contacts
- Equipment staining → Player / world: updates item data
- Player / world → Skin stain rules: edits mask
- Adaptive mud conversion → Source block store: stores source
- Mud tuning → Adaptive mud conversion: converts blocks
- Player / world → Mud tuning: tunes mud
- Player / world → Terrain generation: requests terrain
- Player / world → Mud eruptions: encounters eruption
- Player / world → Mudwork items: uses item
- Player / world → Mud commands: runs command