# petsox/signalcraft architecture

> Architecture diagram of the GitHub repository petsox/signalcraft, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/petsox/signalcraft
- Repository: https://github.com/petsox/signalcraft

## Overview

SignalCraft is a Forge mod adding Czech/Slovak and German railway signals, crossings, switches and trackside scenery to Minecraft. A typical player places and configures equipment, pairs receivers with controllers, and triggers linked devices; the mod also synchronizes state to clients. The graph preserves those product areas and shared tools, networking and rendering. Relationships among unsampled feature modules are shown only where README documentation supports them; source-level edges are limited to visible calls or references.

Main entry points: [`src/main/java/signalcraft/ItemBlocks/SCItemBlocks.java`](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/SCItemBlocks.java) (Placeable equipment), [`src/main/java/signalcraft/entities/controllers/TileController.java`](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/TileController.java) (Controllers), [`src/main/java/signalcraft/entities/controllers/signals/lightSignals/TileRedControllerLightSignals.java`](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/signals/lightSignals/TileRedControllerLightSignals.java) (Signal control), [`src/main/java/signalcraft/network/PacketPipeline.java`](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/network/PacketPipeline.java) (Packet transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Railway equipment"]
  node_itemblocks["Placeable equipment<br/>[SCItemBlocks.java]"]
  node_czsignals["Czech signals"]
  node_crossings["Level crossings"]
  node_signs["Trackside signs"]
  node_gsar["German equipment"]
  node_decor["Railway scenery"]
  node_switches["Switch stands<br/>[BlockSwitch.java]"]
end

subgraph group_control["Control and configuration"]
  node_controllers["Controllers"]
  node_crossingcontrol["Crossing control"]
  node_signalcontrol["Signal control"]
  node_controllerblocks["Controller blocks"]
  node_tools["Configuration tools"]
  node_gui["Configuration GUI"]
end

subgraph group_runtime["Runtime infrastructure"]
  node_registration["Mod registration<br/>[SignalCraft.java]"]
  node_packets["Packet transport"]
  node_sync["State packets"]
  node_integration{{"Optional integrations"}}
end

subgraph group_presentation["Client presentation"]
  node_texture["Texture registry"]
  node_fonts["Custom fonts<br/>[StringCache.java]"]
  node_rendering["Tile rendering"]
end

node_player(("Minecraft player"))

node_player -->|"places"| node_itemblocks
node_itemblocks -.->|"includes"| node_czsignals
node_itemblocks -.->|"includes"| node_crossings
node_itemblocks -.->|"includes"| node_gsar
node_player -->|"configures"| node_tools
node_tools -.->|"opens"| node_gui
node_player -->|"pairs devices"| node_controllers
node_controllerblocks -->|"creates"| node_controllers
node_crossingcontrol -->|"extends"| node_controllers
node_signalcontrol -->|"extends"| node_controllers
node_player -->|"triggers crossings"| node_crossingcontrol
node_player -->|"sets signal states"| node_signalcontrol
node_signalcontrol -.->|"syncs state"| node_packets
node_packets -.->|"transports"| node_sync
node_registration -->|"registers messages"| node_packets
node_player -->|"operates"| node_switches
node_gsar -.->|"includes"| node_switches
node_player -.->|"adds compatibility"| node_integration
node_texture -.->|"supplies textures"| node_rendering

click node_registration "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/SignalCraft.java"
click node_itemblocks "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/SCItemBlocks.java"
click node_czsignals "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/lightSignals/ItemBlockLightSignal.java"
click node_crossings "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/levelCrossings/BlockLevelCrossing.java"
click node_signs "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/signSignals/ItemBlockSpeedSign.java"
click node_gsar "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/gsar/signalsBU/BlockGSARSignalBU2.java"
click node_decor "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/other/BlockTrackGravel.java"
click node_switches "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/switches/BlockSwitch.java"
click node_controllers "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/TileController.java"
click node_crossingcontrol "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/crossings/TileCrossingController.java"
click node_signalcontrol "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/signals/lightSignals/TileRedControllerLightSignals.java"
click node_controllerblocks "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/controllers/BlockController.java"
click node_tools "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/items/ItemSignalBonder.java"
click node_gui "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/gui/controllers/GuiRedstoneController.java"
click node_packets "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/network/PacketPipeline.java"
click node_sync "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/packet/controllers/SPacketUpdateControllers.java"
click node_texture "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/models/TextureRegistry.java"
click node_fonts "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/fonts/StringCache.java"
click node_rendering "https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/renderers/entities/GenericTileRenderer.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_itemblocks,node_czsignals,node_crossings,node_signs,node_gsar,node_decor,node_switches toneBlue
class node_controllers,node_crossingcontrol,node_signalcontrol,node_controllerblocks,node_tools,node_gui toneAmber
class node_registration,node_packets,node_sync,node_integration toneMint
class node_texture,node_fonts,node_rendering toneRose
class node_player toneIndigo
```

## Components

### Railway equipment

- [Placeable equipment](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/SCItemBlocks.java): `src/main/java/signalcraft/ItemBlocks/SCItemBlocks.java`
- [Czech signals](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/lightSignals/ItemBlockLightSignal.java): `src/main/java/signalcraft/ItemBlocks/lightSignals/ItemBlockLightSignal.java`
- [Level crossings](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/levelCrossings/BlockLevelCrossing.java): `src/main/java/signalcraft/blocks/levelCrossings/BlockLevelCrossing.java`
- [Trackside signs](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/ItemBlocks/signSignals/ItemBlockSpeedSign.java): `src/main/java/signalcraft/ItemBlocks/signSignals/ItemBlockSpeedSign.java`
- [German equipment](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/gsar/signalsBU/BlockGSARSignalBU2.java): `src/main/java/signalcraft/blocks/gsar/signalsBU/BlockGSARSignalBU2.java`
- [Railway scenery](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/other/BlockTrackGravel.java): `src/main/java/signalcraft/blocks/other/BlockTrackGravel.java`
- [Switch stands](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/switches/BlockSwitch.java): `src/main/java/signalcraft/blocks/switches/BlockSwitch.java`

### Control and configuration

- [Controllers](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/TileController.java): `src/main/java/signalcraft/entities/controllers/TileController.java`
- [Crossing control](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/crossings/TileCrossingController.java): `src/main/java/signalcraft/entities/controllers/crossings/TileCrossingController.java`
- [Signal control](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/entities/controllers/signals/lightSignals/TileRedControllerLightSignals.java): `src/main/java/signalcraft/entities/controllers/signals/lightSignals/TileRedControllerLightSignals.java`
- [Controller blocks](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/blocks/controllers/BlockController.java): `src/main/java/signalcraft/blocks/controllers/BlockController.java`
- [Configuration tools](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/items/ItemSignalBonder.java): `src/main/java/signalcraft/items/ItemSignalBonder.java`
- [Configuration GUI](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/gui/controllers/GuiRedstoneController.java): `src/main/java/signalcraft/gui/controllers/GuiRedstoneController.java`

### Runtime infrastructure

- [Mod registration](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/SignalCraft.java): `src/main/java/signalcraft/SignalCraft.java`
- [Packet transport](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/network/PacketPipeline.java): `src/main/java/signalcraft/network/PacketPipeline.java`
- [State packets](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/packet/controllers/SPacketUpdateControllers.java): `src/main/java/signalcraft/packet/controllers/SPacketUpdateControllers.java`
- **Optional integrations**

### Client presentation

- [Texture registry](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/models/TextureRegistry.java): `src/main/java/signalcraft/models/TextureRegistry.java`
- [Custom fonts](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/fonts/StringCache.java): `src/main/java/signalcraft/fonts/StringCache.java`
- [Tile rendering](https://github.com/petsox/signalcraft/blob/main/src/main/java/signalcraft/renderers/entities/GenericTileRenderer.java): `src/main/java/signalcraft/renderers/entities/GenericTileRenderer.java`

### Other components

- **Minecraft player**

## Connections

- Minecraft player → Placeable equipment: places
- Placeable equipment → Czech signals: includes
- Placeable equipment → Level crossings: includes
- Placeable equipment → German equipment: includes
- Minecraft player → Configuration tools: configures
- Configuration tools → Configuration GUI: opens
- Minecraft player → Controllers: pairs devices
- Controller blocks → Controllers: creates (evidence: `src/main/java/signalcraft/blocks/controllers/BlockController.java`)
- Crossing control → Controllers: extends (evidence: `src/main/java/signalcraft/entities/controllers/crossings/TileCrossingController.java`)
- Signal control → Controllers: extends (evidence: `src/main/java/signalcraft/entities/controllers/signals/lightSignals/TileRedControllerLightSignals.java`)
- Minecraft player → Crossing control: triggers crossings
- Minecraft player → Signal control: sets signal states
- Signal control → Packet transport: syncs state
- Packet transport → State packets: transports
- Mod registration → Packet transport: registers messages (evidence: `src/main/java/signalcraft/SignalCraft.java`)
- Minecraft player → Switch stands: operates
- German equipment → Switch stands: includes
- Minecraft player → Optional integrations: adds compatibility
- Texture registry → Tile rendering: supplies textures
