# tau-ri-dev/mod-jsg architecture

> Architecture diagram of the GitHub repository tau-ri-dev/mod-jsg, 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/tau-ri-dev/mod-jsg
- Repository: https://github.com/tau-ri-dev/mod-jsg

## Overview

JSG is a Minecraft mod that adds Stargate travel, short-range transport rings, protective irises, and related devices and materials. Players use a gate or dial-home device to dial an address; gate state and network address data support connection, while the event horizon transfers travelers. The map also preserves the documented transport-ring capability and major in-game interfaces. Several links are based on explicit README descriptions or source-index references; unsampled implementation details are not inferred as verified calls.

Main entry points: [`src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java`](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java) (Dialing), [`src/main/java/dev/tauri/jsg/JSG.java`](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/JSG.java) (JSG Mod), [`src/main/java/dev/tauri/jsg/common/stargate/network/StargateNetwork.java`](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/network/StargateNetwork.java) (Gate Network), [`src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java`](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java) (Admin Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Gate Runtime"]
  node_gate_api["Gate Behavior<br/>[Stargate.java]"]
  node_gate_blocks["Gate Blocks"]
  node_classic_gate["Classic Gate"]
  node_dialing["Dialing"]
  node_gate_state["Gate State"]
  node_horizon["Event Horizon"]
end

subgraph group_network["Address Network"]
  node_network[("Gate Network")]
  node_gate_position["Gate Position<br/>[StargatePos.java]"]
  node_dynamic_address["Dynamic Address"]
end

subgraph group_devices["Devices and Travel"]
  node_dhd["Dial Home Device<br/>[DHDAbstractBE.java]"]
  node_dhd_state["DHD State"]
  node_rig["Transport Rings"]
  node_admin_item["Admin Controller"]
end

subgraph group_client["Client Experience"]
  node_admin_gui["Admin Interface"]
  node_renderer_state["Renderer State"]
  node_gate_renderer["Gate Rendering"]
end

subgraph group_platform["Mod Platform"]
  node_mod["JSG Mod<br/>[JSG.java]"]
  node_api["JSG API<br/>[JSGApi.java]"]
  node_config["Configuration<br/>[JSGConfig.java]"]
  node_scheduled["Scheduled Tasks"]
  node_computer_events["Computer Events"]
  node_packets["Network Packets"]
end

node_player(("Player"))

node_player -.->|"operates"| node_dhd
node_dhd -.->|"initiates dialing"| node_dialing
node_dialing -->|"looks up address"| node_network
node_gate_api -->|"resolves address"| node_network
node_gate_api -.->|"uses position"| node_gate_position
node_network -.->|"indexes addresses"| node_dynamic_address
node_dialing -->|"emits signals"| node_computer_events
node_dialing -.->|"schedules tasks"| node_scheduled
node_gate_blocks -->|"manages state"| node_gate_state
node_gate_blocks -.->|"owns dialing"| node_dialing
node_gate_state -->|"sends updates"| node_renderer_state
node_gate_renderer -.->|"renders state"| node_renderer_state
node_classic_gate -->|"handles travelers"| node_horizon
node_horizon -->|"emits signals"| node_computer_events
node_player -.->|"uses transport rings"| node_rig
node_admin_item -->|"opens interface"| node_admin_gui
node_admin_gui -->|"requests gate data"| node_packets
node_packets -.->|"delivers updates"| node_admin_gui
node_mod -->|"initializes"| node_api
node_mod -->|"loads config"| node_config
node_mod -->|"initializes handler"| node_packets

click node_mod "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/JSG.java"
click node_api "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/JSGApi.java"
click node_config "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/config/JSGConfig.java"
click node_scheduled "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/registry/JSGScheduledTaskTypes.java"
click node_computer_events "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/integration/StargateComputerEvents.java"
click node_gate_api "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/stargate/Stargate.java"
click node_gate_blocks "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/blockentity/stargate/StargateAbstractBaseBE.java"
click node_classic_gate "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/blockentity/stargate/StargateClassicBaseBE.java"
click node_dialing "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java"
click node_gate_state "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/state/StargateAbstractStateManager.java"
click node_horizon "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/StargateEventHorizonManager.java"
click node_network "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/network/StargateNetwork.java"
click node_gate_position "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/stargate/network/StargatePos.java"
click node_dynamic_address "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/stargate/network/address/StargateAddressDynamic.java"
click node_dhd "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/blockentity/dialhomedevice/DHDAbstractBE.java"
click node_dhd_state "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/dialhomedevice/manager/state/DHDAbstractStateManager.java"
click node_rig "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/rig/StargateRIGManager.java"
click node_admin_item "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/item/admincontroller/AdminControllerItem.java"
click node_packets "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/packet/JSGPacketHandler.java"
click node_admin_gui "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java"
click node_renderer_state "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/state/stargate/StargateRendererActionState.java"
click node_gate_renderer "https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/client/renderer/blockentity/stargate/StargateClassicRendererState.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_gate_api,node_gate_blocks,node_classic_gate,node_dialing,node_gate_state,node_horizon toneBlue
class node_network,node_gate_position,node_dynamic_address toneAmber
class node_dhd,node_dhd_state,node_rig,node_admin_item toneMint
class node_admin_gui,node_renderer_state,node_gate_renderer toneRose
class node_mod,node_api,node_config,node_scheduled,node_computer_events,node_packets,node_player toneIndigo
```

## Components

### Gate Runtime

- [Gate Behavior](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/stargate/Stargate.java): `src/main/java/dev/tauri/jsg/api/stargate/Stargate.java`
- [Gate Blocks](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/blockentity/stargate/StargateAbstractBaseBE.java): `src/main/java/dev/tauri/jsg/common/blockentity/stargate/StargateAbstractBaseBE.java`
- [Classic Gate](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/blockentity/stargate/StargateClassicBaseBE.java): `src/main/java/dev/tauri/jsg/common/blockentity/stargate/StargateClassicBaseBE.java`
- [Dialing](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java): `src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java`
- [Gate State](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/state/StargateAbstractStateManager.java): `src/main/java/dev/tauri/jsg/common/stargate/manager/state/StargateAbstractStateManager.java`
- [Event Horizon](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/manager/StargateEventHorizonManager.java): `src/main/java/dev/tauri/jsg/common/stargate/manager/StargateEventHorizonManager.java`

### Address Network

- [Gate Network](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/network/StargateNetwork.java): `src/main/java/dev/tauri/jsg/common/stargate/network/StargateNetwork.java`
- [Gate Position](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/stargate/network/StargatePos.java): `src/main/java/dev/tauri/jsg/api/stargate/network/StargatePos.java`
- [Dynamic Address](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/stargate/network/address/StargateAddressDynamic.java): `src/main/java/dev/tauri/jsg/api/stargate/network/address/StargateAddressDynamic.java`

### Devices and Travel

- [Dial Home Device](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/blockentity/dialhomedevice/DHDAbstractBE.java): `src/main/java/dev/tauri/jsg/common/blockentity/dialhomedevice/DHDAbstractBE.java`
- [DHD State](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/dialhomedevice/manager/state/DHDAbstractStateManager.java): `src/main/java/dev/tauri/jsg/common/dialhomedevice/manager/state/DHDAbstractStateManager.java`
- [Transport Rings](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/stargate/rig/StargateRIGManager.java): `src/main/java/dev/tauri/jsg/common/stargate/rig/StargateRIGManager.java`
- [Admin Controller](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/item/admincontroller/AdminControllerItem.java): `src/main/java/dev/tauri/jsg/common/item/admincontroller/AdminControllerItem.java`

### Client Experience

- [Admin Interface](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java): `src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java`
- [Renderer State](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/state/stargate/StargateRendererActionState.java): `src/main/java/dev/tauri/jsg/common/state/stargate/StargateRendererActionState.java`
- [Gate Rendering](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/client/renderer/blockentity/stargate/StargateClassicRendererState.java): `src/main/java/dev/tauri/jsg/client/renderer/blockentity/stargate/StargateClassicRendererState.java`

### Mod Platform

- [JSG Mod](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/JSG.java): `src/main/java/dev/tauri/jsg/JSG.java`
- [JSG API](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/JSGApi.java): `src/main/java/dev/tauri/jsg/api/JSGApi.java`
- [Configuration](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/config/JSGConfig.java): `src/main/java/dev/tauri/jsg/api/config/JSGConfig.java`
- [Scheduled Tasks](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/registry/JSGScheduledTaskTypes.java): `src/main/java/dev/tauri/jsg/api/registry/JSGScheduledTaskTypes.java`
- [Computer Events](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/api/integration/StargateComputerEvents.java): `src/main/java/dev/tauri/jsg/api/integration/StargateComputerEvents.java`
- [Network Packets](https://github.com/tau-ri-dev/mod-jsg/blob/1.20.1/src/main/java/dev/tauri/jsg/common/packet/JSGPacketHandler.java): `src/main/java/dev/tauri/jsg/common/packet/JSGPacketHandler.java`

### Other components

- **Player**

## Connections

- Player → Dial Home Device: operates (evidence: `README.md`)
- Dial Home Device → Dialing: initiates dialing
- Dialing → Gate Network: looks up address (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java`)
- Gate Behavior → Gate Network: resolves address (evidence: `src/main/java/dev/tauri/jsg/api/stargate/Stargate.java`)
- Gate Behavior → Gate Position: uses position (evidence: `src/main/java/dev/tauri/jsg/api/stargate/Stargate.java`)
- Gate Network → Dynamic Address: indexes addresses
- Dialing → Computer Events: emits signals (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java`)
- Dialing → Scheduled Tasks: schedules tasks (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/dialing/StargateAbstractDialingManager.java`)
- Gate Blocks → Gate State: manages state (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/state/StargateAbstractStateManager.java`)
- Gate Blocks → Dialing: owns dialing
- Gate State → Renderer State: sends updates (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/state/StargateAbstractStateManager.java`)
- Gate Rendering → Renderer State: renders state
- Classic Gate → Event Horizon: handles travelers (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/StargateEventHorizonManager.java`)
- Event Horizon → Computer Events: emits signals (evidence: `src/main/java/dev/tauri/jsg/common/stargate/manager/StargateEventHorizonManager.java`)
- Player → Transport Rings: uses transport rings (evidence: `README.md`)
- Admin Controller → Admin Interface: opens interface (evidence: `src/main/java/dev/tauri/jsg/common/item/admincontroller/AdminControllerItem.java`)
- Admin Interface → Network Packets: requests gate data (evidence: `src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java`)
- Network Packets → Admin Interface: delivers updates (evidence: `src/main/java/dev/tauri/jsg/client/screen/gui/admincontroller/AdminControllerGUI.java`)
- JSG Mod → JSG API: initializes (evidence: `src/main/java/dev/tauri/jsg/JSG.java`)
- JSG Mod → Configuration: loads config (evidence: `src/main/java/dev/tauri/jsg/JSG.java`)
- JSG Mod → Network Packets: initializes handler (evidence: `src/main/java/dev/tauri/jsg/JSG.java`)
