How yung-gang/yungs-better-mineshafts works
Better Mineshafts is a Minecraft world-generation mod: it replaces or supplements vanilla mineshafts with configurable, procedurally assembled structures. The main path is world generation invoking the registered structure, which creates a vertical entrance and expands a network of shaft and room pieces; those pieces place blocks, decorations, and minecart loot. Common code contains the structure and generation logic, while Fabric and NeoForge provide platform-specific startup and configuration. Some piece implementations and platform wiring are unsampled, so uncertain links are omitted or marked unverified.
Main entry points: BetterMineshaftGenerator.java Piece expansion · BetterMineshaftStructure.java Mineshaft structure · VerticalEntrance.java Vertical entrance · BigTunnel.java Tunnel pieces
Components 26
Common worldgen
- Common initialization
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/BetterMineshaftsCommon.java - Platform services
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/Services.java - Platform interfaces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/IPlatformHelper.java - Mineshaft structure
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/BetterMineshaftStructure.java - Structure registration
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/StructureTypeModule.java - Piece registration
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/StructurePieceTypeModule.java - Shared piece logic
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/BetterMineshaftPiece.java - Piece expansion
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Vertical entrance
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/VerticalEntrance.java - Tunnel pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/BigTunnel.java - Small tunnel
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/SmallTunnel.java - Turns and junctions
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/SmallTunnelTurn.java - Side rooms
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/SideRoom.java - Ore deposits
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/OreDeposit.java - Zombie villager room
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/ZombieVillagerRoom.java - Block accessors
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/mixin/BlockBehaviourAccessor.java - Bounds accessor
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/mixin/BoundingBoxAccessor.java
Configuration
- Structure settings
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/config/BetterMineshaftConfiguration.java
Fabric integration
- Fabric config
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/ConfigModuleFabric.java - Fabric modules
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/FabricModulesLoader.java - Fabric platform
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/FabricPlatformHelper.java - Config menu
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/config/gui/BMModMenu.java
NeoForge integration
- NeoForge startup
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/BetterMineshaftsNeoForge.java - NeoForge config
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/ConfigModuleNeoForge.java - NeoForge platform
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/NeoForgePlatformHelper.java
Other components
- Minecraft worldgen
Connections 24
- Minecraft worldgen → Mineshaft structure: invokes generation
- Common initialization → Platform services: loads services
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/BetterMineshaftsCommon.java - Platform services → Platform interfaces: loads implementation
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/Services.java - Mineshaft structure → Vertical entrance: creates entry
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/BetterMineshaftStructure.java - Mineshaft structure → Structure settings: uses settings
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/BetterMineshaftStructure.java - Structure registration → Mineshaft structure: registers type
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/StructureTypeModule.java - Vertical entrance → Piece expansion: expands branches
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/VerticalEntrance.java - Piece expansion → Tunnel pieces: creates pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Piece expansion → Small tunnel: creates pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Piece expansion → Turns and junctions: creates pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Piece expansion → Side rooms: creates pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Piece expansion → Ore deposits: creates pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Piece expansion → Zombie villager room: creates pieces
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/BetterMineshaftGenerator.java - Piece registration → Vertical entrance: registers constructor
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/StructurePieceTypeModule.java - Piece registration → Tunnel pieces: registers constructor
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/StructurePieceTypeModule.java - Tunnel pieces → Block accessors: checks survival
Common/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/world/generator/pieces/BigTunnel.java - Fabric modules → Fabric config: loads modules
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/FabricModulesLoader.java - Fabric config → Structure settings: configures runtime
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/ConfigModuleFabric.java - Config menu → Fabric config: opens config
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/config/gui/BMModMenu.java - Fabric platform → Platform interfaces: implements interface
Fabric/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/FabricPlatformHelper.java - NeoForge startup → Common initialization: initializes common
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/BetterMineshaftsNeoForge.java - NeoForge startup → NeoForge config: initializes config
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/BetterMineshaftsNeoForge.java - NeoForge config → Structure settings: bakes settings
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/module/ConfigModuleNeoForge.java - NeoForge platform → Platform interfaces: implements interface
NeoForge/src/main/java/com/yungnickyoung/minecraft/bettermineshafts/services/NeoForgePlatformHelper.java