# nwuww/tpmanagermod-neoforged architecture

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

- Interactive diagram: https://gitdiagram.com/nwuww/tpmanagermod-neoforged
- Repository: https://github.com/nwuww/tpmanagermod-neoforged

## Overview

TPManager is a NeoForge Minecraft mod for player teleport requests and home/visit permissions. Players issue commands; the command handlers consult per-player settings and request state, then accept, deny, or expire requests and manage home access. Persistent player settings are loaded at server startup and saved by command operations. The README documents the full command capabilities, while the excerpts show only selected command paths; unsampled details are represented only where documented.

Main entry points: [`src/main/java/com/nwuww/TPManager/ConfigManager.java`](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/ConfigManager.java) (Settings persistence), [`src/main/java/com/nwuww/TPManager/TPCommand.java`](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPCommand.java) (TPA commands), [`src/main/java/com/nwuww/TPManager/TPManager.java`](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPManager.java) (Mod bootstrap), [`src/main/java/com/nwuww/TPManager/PlayerSettings.java`](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/PlayerSettings.java) (Player settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Mod entry"]
  node_mod["Mod bootstrap<br/>[TPManager.java]"]
  node_client["Client config screen"]
end

subgraph group_teleport["Teleport requests"]
  node_tpa_commands["TPA commands<br/>[TPCommand.java]"]
  node_request_state["Request state and timeout<br/>[TpaManager.java]"]
end

subgraph group_homes["Homes and visits"]
  node_home_commands["Home and visit commands<br/>[TPCommand.java]"]
end

subgraph group_state["Settings and state"]
  node_player_settings["Player settings"]
  node_home_state["Home access state<br/>[Home.java]"]
  node_settings_manager["Settings persistence<br/>[ConfigManager.java]"]
  node_world_file["World settings file"]
  node_mod_config["NeoForge config<br/>[Config.java]"]
end

node_player(("Player"))

node_player -->|"issues requests"| node_tpa_commands
node_player -->|"manages home"| node_home_commands
node_mod -->|"registers commands"| node_tpa_commands
node_mod -->|"loads settings"| node_settings_manager
node_tpa_commands -->|"creates requests"| node_request_state
node_tpa_commands -->|"reads settings"| node_settings_manager
node_home_commands -->|"reads and saves"| node_settings_manager
node_settings_manager -->|"stores settings"| node_player_settings
node_player_settings -->|"holds home"| node_home_state
node_settings_manager -->|"reads and writes"| node_world_file
node_mod -->|"uses config values"| node_mod_config

click node_mod "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPManager.java"
click node_client "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPManagerClient.java"
click node_tpa_commands "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPCommand.java"
click node_request_state "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TpaManager.java"
click node_home_commands "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPCommand.java"
click node_player_settings "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/PlayerSettings.java"
click node_home_state "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/Home.java"
click node_settings_manager "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/ConfigManager.java"
click node_mod_config "https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/Config.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_mod,node_client toneBlue
class node_tpa_commands,node_request_state toneAmber
class node_home_commands toneMint
class node_player_settings,node_home_state,node_settings_manager,node_world_file,node_mod_config toneRose
class node_player toneIndigo
```

## Components

### Mod entry

- [Mod bootstrap](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPManager.java): `src/main/java/com/nwuww/TPManager/TPManager.java`
- [Client config screen](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPManagerClient.java): `src/main/java/com/nwuww/TPManager/TPManagerClient.java`

### Teleport requests

- [TPA commands](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPCommand.java): `src/main/java/com/nwuww/TPManager/TPCommand.java`
- [Request state and timeout](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TpaManager.java): `src/main/java/com/nwuww/TPManager/TpaManager.java`

### Homes and visits

- [Home and visit commands](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/TPCommand.java): `src/main/java/com/nwuww/TPManager/TPCommand.java`

### Settings and state

- [Player settings](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/PlayerSettings.java): `src/main/java/com/nwuww/TPManager/PlayerSettings.java`
- [Home access state](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/Home.java): `src/main/java/com/nwuww/TPManager/Home.java`
- [Settings persistence](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/ConfigManager.java): `src/main/java/com/nwuww/TPManager/ConfigManager.java`
- **World settings file**
- [NeoForge config](https://github.com/nwuww/tpmanagermod-neoforged/blob/main/src/main/java/com/nwuww/TPManager/Config.java): `src/main/java/com/nwuww/TPManager/Config.java`

### Other components

- **Player**

## Connections

- Player → TPA commands: issues requests (evidence: `README.md`)
- Player → Home and visit commands: manages home (evidence: `README.md`)
- Mod bootstrap → TPA commands: registers commands (evidence: `src/main/java/com/nwuww/TPManager/TPManager.java`)
- Mod bootstrap → Settings persistence: loads settings (evidence: `src/main/java/com/nwuww/TPManager/TPManager.java`)
- TPA commands → Request state and timeout: creates requests (evidence: `src/main/java/com/nwuww/TPManager/TPCommand.java`)
- TPA commands → Settings persistence: reads settings (evidence: `src/main/java/com/nwuww/TPManager/TPCommand.java`)
- Home and visit commands → Settings persistence: reads and saves (evidence: `src/main/java/com/nwuww/TPManager/TPCommand.java`)
- Settings persistence → Player settings: stores settings (evidence: `src/main/java/com/nwuww/TPManager/ConfigManager.java`)
- Player settings → Home access state: holds home (evidence: `src/main/java/com/nwuww/TPManager/PlayerSettings.java`)
- Settings persistence → World settings file: reads and writes (evidence: `src/main/java/com/nwuww/TPManager/ConfigManager.java`)
- Mod bootstrap → NeoForge config: uses config values (evidence: `src/main/java/com/nwuww/TPManager/TPManager.java`)
