How phasetranscrystal/topology works
Topology is a NeoForge library mod that gives downstream mods declarative infrastructure rather than adding gameplay itself. The main workflow is a mod implementing and registering a TopoPlugin; TopoPluginEngine then bootstraps the registered domains, which provide machine, recipe, material, equipment, pipe, and ore capabilities in-game. The graph preserves those distinct domains and highlights multiblock recognition and pipe-network surveying as internal runtime layers. README documents additional capabilities whose exact runtime wiring is not shown in the sampled source; those links are left out where uncertain.
Main entry points: TopoPluginEngine.java Domain bootstrap · PipeNetworkEngine.java Pipe network runtime · PipeSurveyManager.java Network survey · TopoPlugins.java Plugin registration
Components 22
Plugin bootstrap
- Plugin registration
src/main/java/net/ptcrys/topo/api/api/plugin/TopoPlugins.java - Domain bootstrap
src/main/java/net/ptcrys/topo/api/api/plugin/TopoPluginEngine.java
Machine runtime
- Machine definitions
src/main/java/net/ptcrys/topo/api/machine/Machines.java - Machine components
src/main/java/net/ptcrys/topo/api/machine/component/MachineComponents.java - Resource ports
src/main/java/net/ptcrys/topo/api/machine/resource/ResourcePort.java - Machine data sync
src/main/java/net/ptcrys/topo/api/machine/data/MachineDataSyncBatcher.java - Multiblock controller
src/main/java/net/ptcrys/topo/api/machine/multiblock/MultiblockController.java - Structure recognition
src/main/java/net/ptcrys/topo/api/machine/multiblock/pattern/StructureEngine.java
Recipes
- Recipe types
src/main/java/net/ptcrys/topo/api/recipe/TopoRecipeTypes.java - Recipe search
src/main/java/net/ptcrys/topo/api/recipe/search/TopoRecipeSearchIndex.java - Production lines
src/main/java/net/ptcrys/topo/api/recipe/productionline/ProductionLines.java
Materials and equipment
- Material registry
src/main/java/net/ptcrys/topo/api/material/MaterialRegistry.java - Material forms
src/main/java/net/ptcrys/topo/api/material/form/MaterialFormRegistry.java - Material processing
src/main/java/net/ptcrys/topo/api/material/process/MaterialPostProcessorRegistry.java - Equipment registry
src/main/java/net/ptcrys/topo/api/equipment/EquipmentRegistry.java
Pipe networks
- Pipe network runtime
src/main/java/net/ptcrys/topo/api/pipe/network/PipeNetworkEngine.java - Per-level networks
src/main/java/net/ptcrys/topo/api/pipe/network/PipeLevelRuntime.java - Network survey
src/main/java/net/ptcrys/topo/api/pipe/survey/PipeSurveyManager.java - Survey renderer
src/main/java/net/ptcrys/topo/client/survey/PipeSurveyClientRenderer.java
Ore generation
- Ore vein registry
src/main/java/net/ptcrys/topo/api/ore/OreVeins.java - Ore worldgen planner
src/main/java/net/ptcrys/topo/api/ore/engine/OreWorldgenService.java
Other components
- Downstream mod
Connections 17
- Downstream mod → Plugin registration: registers plugin
- Plugin registration → Domain bootstrap: supplies plugins
- Domain bootstrap → Recipe types: bootstraps recipes
- Domain bootstrap → Material registry: bootstraps materials
- Domain bootstrap → Machine definitions: bootstraps machines
- Domain bootstrap → Equipment registry: bootstraps equipment
- Domain bootstrap → Pipe network runtime: freezes pipe setup
- Domain bootstrap → Ore vein registry: bootstraps ore
- Multiblock controller → Structure recognition: recognizes structure
- Recipe search → Recipe types: searches types
- Material registry → Material forms: registers forms
- Domain bootstrap → Material processing: runs processors
- Pipe network runtime → Per-level networks: dispatches level events
- Pipe network runtime → Per-level networks: forwards pipe hooks
- Network survey → Pipe network runtime: gets network runtime
- Network survey → Survey renderer: sends snapshot
- Ore worldgen planner → Ore vein registry: reads frozen veins