# a-team-pjnceadc/projecte-team architecture

> Architecture diagram of the GitHub repository a-team-pjnceadc/projecte-team, 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/a-team-pjnceadc/projecte-team
- Repository: https://github.com/a-team-pjnceadc/projecte-team

## Overview

ProjectE-Team adds server-side teams whose members can share ProjectE EMC and transmutation knowledge. The workflow is command-driven team management, with shared values mediated transparently through ProjectE player properties, stored in world data, persisted, and pushed to clients for live GUI updates. The README also documents offline invitations/kicks, separate sharing switches, and filtered transmutation outputs. The graph follows explicit wiring in excerpts and the SOURCE INDEX; paths for unsampled capabilities use their exact source files where identified, while uncertain internal links are omitted.

Main entry points: [`src/main/java/com/projecte/team/TeamManager.java`](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamManager.java) (Team operations), [`src/main/java/com/projecte/team/MyMod.java`](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/MyMod.java) (Mod lifecycle), [`src/main/java/com/projecte/team/TeamSaveHandler.java`](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamSaveHandler.java) (Save handler), [`src/main/java/com/projecte/team/TeamTransmutationProps.java`](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamTransmutationProps.java) (Team properties)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_team_domain["Team management"]
  node_commands["Team commands"]
  node_manager["Team operations<br/>[TeamManager.java]"]
  node_teamdata["Team state<br/>[TeamData.java]"]
end

subgraph group_sharing["Shared transmutation"]
  node_props["Team properties"]
  node_emcmode["EMC mode<br/>[TeamEmcMode.java]"]
  node_knowledgeview["Knowledge view"]
  node_searchhelper["Name search"]
  node_sorthelper["Knowledge sorting"]
end

subgraph group_persistence["World persistence"]
  node_store[("Team registry<br/>[TeamDataStore.java]")]
  node_saves["Save handler"]
end

subgraph group_sync["Live synchronization"]
  node_packet["Packet channel<br/>[PacketHandler.java]"]
  node_emcpkt["EMC packet<br/>[TeamEmcPKT.java]"]
  node_knowledgepkt["Knowledge packet"]
  node_clientproxy["Client proxy<br/>[ClientProxy.java]"]
  node_clienthandler["Client tick handler"]
  node_clientsync["Client state apply"]
end

subgraph group_integration["ProjectE integration"]
  node_mod["Mod lifecycle<br/>[MyMod.java]"]
  node_events["Player events<br/>[TeamEvents.java]"]
  node_mixin["Transmutation hooks"]
  node_searchmixin["Search hook"]
end

node_player(("Game player"))
node_projecte["ProjectE transmutation"]
node_world[("Minecraft world storage")]

node_player -->|"issues commands"| node_commands
node_commands -->|"dispatches operations"| node_manager
node_manager -->|"reads and updates"| node_store
node_store -->|"manages teams"| node_teamdata
node_store -->|"loads saved data"| node_world
node_mod -->|"registers command"| node_commands
node_mod -->|"registers events"| node_events
node_mod -->|"registers handler"| node_saves
node_mod -->|"registers channel"| node_packet
node_props -->|"delegates shared access"| node_manager
node_props -->|"overrides property access"| node_projecte
node_events -->|"registers player properties"| node_props
node_manager -->|"checks EMC mode"| node_emcmode
node_manager -->|"provides knowledge view"| node_knowledgeview
node_manager -->|"sends team updates"| node_packet
node_saves -->|"checks dirty state"| node_store
node_saves -->|"saves world data"| node_world
node_saves -->|"flushes open containers"| node_manager
node_packet -->|"registers packet"| node_emcpkt
node_packet -->|"registers packet"| node_knowledgepkt
node_emcpkt -->|"dispatches EMC"| node_clientproxy
node_knowledgepkt -->|"dispatches knowledge"| node_clientproxy
node_clientproxy -->|"queues state"| node_clientsync
node_clientproxy -->|"registers tick handler"| node_clienthandler
node_clienthandler -->|"applies queued state"| node_clientsync
node_clientsync -->|"updates client properties"| node_props
node_clientsync -->|"refreshes transmutation GUI"| node_projecte
node_mixin -->|"forwards shared operations"| node_manager
node_searchmixin -->|"uses search helper"| node_searchhelper
node_mixin -->|"uses sort helper"| node_sorthelper

click node_mod "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/MyMod.java"
click node_commands "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/commands/ProjectETeamCMD.java"
click node_manager "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamManager.java"
click node_teamdata "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamData.java"
click node_store "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamDataStore.java"
click node_saves "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamSaveHandler.java"
click node_events "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamEvents.java"
click node_props "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamTransmutationProps.java"
click node_emcmode "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamEmcMode.java"
click node_knowledgeview "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamKnowledgeView.java"
click node_mixin "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/mixin/TransmutationInventoryMixin.java"
click node_searchmixin "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/mixin/ItemSearchHelperMixin.java"
click node_searchhelper "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/ItemNameSearchHelper.java"
click node_sorthelper "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/KnowledgeSortHelper.java"
click node_packet "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/network/PacketHandler.java"
click node_emcpkt "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/network/TeamEmcPKT.java"
click node_knowledgepkt "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/network/TeamKnowledgePKT.java"
click node_clientproxy "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/ClientProxy.java"
click node_clienthandler "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamClientHandler.java"
click node_clientsync "https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamClientSync.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_commands,node_manager,node_teamdata toneBlue
class node_props,node_emcmode,node_knowledgeview,node_searchhelper,node_sorthelper,node_world toneAmber
class node_store,node_saves toneMint
class node_packet,node_emcpkt,node_knowledgepkt,node_clientproxy,node_clienthandler,node_clientsync toneRose
class node_mod,node_events,node_mixin,node_searchmixin,node_player,node_projecte toneIndigo
```

## Components

### Team management

- [Team commands](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/commands/ProjectETeamCMD.java): `src/main/java/com/projecte/team/commands/ProjectETeamCMD.java`
- [Team operations](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamManager.java): `src/main/java/com/projecte/team/TeamManager.java`
- [Team state](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamData.java): `src/main/java/com/projecte/team/TeamData.java`

### Shared transmutation

- [Team properties](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamTransmutationProps.java): `src/main/java/com/projecte/team/TeamTransmutationProps.java`
- [EMC mode](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamEmcMode.java): `src/main/java/com/projecte/team/TeamEmcMode.java`
- [Knowledge view](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamKnowledgeView.java): `src/main/java/com/projecte/team/TeamKnowledgeView.java`
- [Name search](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/ItemNameSearchHelper.java): `src/main/java/com/projecte/team/ItemNameSearchHelper.java`
- [Knowledge sorting](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/KnowledgeSortHelper.java): `src/main/java/com/projecte/team/KnowledgeSortHelper.java`

### World persistence

- [Team registry](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamDataStore.java): `src/main/java/com/projecte/team/TeamDataStore.java`
- [Save handler](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamSaveHandler.java): `src/main/java/com/projecte/team/TeamSaveHandler.java`

### Live synchronization

- [Packet channel](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/network/PacketHandler.java): `src/main/java/com/projecte/team/network/PacketHandler.java`
- [EMC packet](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/network/TeamEmcPKT.java): `src/main/java/com/projecte/team/network/TeamEmcPKT.java`
- [Knowledge packet](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/network/TeamKnowledgePKT.java): `src/main/java/com/projecte/team/network/TeamKnowledgePKT.java`
- [Client proxy](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/ClientProxy.java): `src/main/java/com/projecte/team/ClientProxy.java`
- [Client tick handler](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamClientHandler.java): `src/main/java/com/projecte/team/TeamClientHandler.java`
- [Client state apply](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamClientSync.java): `src/main/java/com/projecte/team/TeamClientSync.java`

### ProjectE integration

- [Mod lifecycle](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/MyMod.java): `src/main/java/com/projecte/team/MyMod.java`
- [Player events](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/TeamEvents.java): `src/main/java/com/projecte/team/TeamEvents.java`
- [Transmutation hooks](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/mixin/TransmutationInventoryMixin.java): `src/main/java/com/projecte/team/mixin/TransmutationInventoryMixin.java`
- [Search hook](https://github.com/a-team-pjnceadc/projecte-team/blob/main/src/main/java/com/projecte/team/mixin/ItemSearchHelperMixin.java): `src/main/java/com/projecte/team/mixin/ItemSearchHelperMixin.java`

### Other components

- **Game player**
- **ProjectE transmutation**
- **Minecraft world storage**

## Connections

- Game player → Team commands: issues commands (evidence: `README.md`)
- Team commands → Team operations: dispatches operations (evidence: `src/main/java/com/projecte/team/commands/ProjectETeamCMD.java`)
- Team operations → Team registry: reads and updates (evidence: `src/main/java/com/projecte/team/TeamManager.java`)
- Team registry → Team state: manages teams (evidence: `src/main/java/com/projecte/team/TeamDataStore.java`)
- Team registry → Minecraft world storage: loads saved data (evidence: `src/main/java/com/projecte/team/TeamDataStore.java`)
- Mod lifecycle → Team commands: registers command (evidence: `src/main/java/com/projecte/team/MyMod.java`)
- Mod lifecycle → Player events: registers events (evidence: `src/main/java/com/projecte/team/MyMod.java`)
- Mod lifecycle → Save handler: registers handler (evidence: `src/main/java/com/projecte/team/MyMod.java`)
- Mod lifecycle → Packet channel: registers channel (evidence: `src/main/java/com/projecte/team/MyMod.java`)
- Team properties → Team operations: delegates shared access (evidence: `src/main/java/com/projecte/team/TeamTransmutationProps.java`)
- Team properties → ProjectE transmutation: overrides property access (evidence: `src/main/java/com/projecte/team/TeamTransmutationProps.java`)
- Player events → Team properties: registers player properties (evidence: `src/main/java/com/projecte/team/TeamEvents.java`)
- Team operations → EMC mode: checks EMC mode (evidence: `src/main/java/com/projecte/team/TeamManager.java`)
- Team operations → Knowledge view: provides knowledge view (evidence: `src/main/java/com/projecte/team/TeamManager.java`)
- Team operations → Packet channel: sends team updates (evidence: `src/main/java/com/projecte/team/TeamManager.java`)
- Save handler → Team registry: checks dirty state (evidence: `src/main/java/com/projecte/team/TeamSaveHandler.java`)
- Save handler → Minecraft world storage: saves world data (evidence: `src/main/java/com/projecte/team/TeamSaveHandler.java`)
- Save handler → Team operations: flushes open containers (evidence: `src/main/java/com/projecte/team/TeamSaveHandler.java`)
- Packet channel → EMC packet: registers packet (evidence: `src/main/java/com/projecte/team/network/PacketHandler.java`)
- Packet channel → Knowledge packet: registers packet (evidence: `src/main/java/com/projecte/team/network/PacketHandler.java`)
- EMC packet → Client proxy: dispatches EMC (evidence: `src/main/java/com/projecte/team/network/TeamEmcPKT.java`)
- Knowledge packet → Client proxy: dispatches knowledge (evidence: `src/main/java/com/projecte/team/network/TeamKnowledgePKT.java`)
- Client proxy → Client state apply: queues state (evidence: `src/main/java/com/projecte/team/ClientProxy.java`)
- Client proxy → Client tick handler: registers tick handler (evidence: `src/main/java/com/projecte/team/ClientProxy.java`)
- Client tick handler → Client state apply: applies queued state (evidence: `src/main/java/com/projecte/team/TeamClientHandler.java`)
- Client state apply → Team properties: updates client properties (evidence: `src/main/java/com/projecte/team/TeamClientSync.java`)
- Client state apply → ProjectE transmutation: refreshes transmutation GUI (evidence: `src/main/java/com/projecte/team/TeamClientSync.java`)
- Transmutation hooks → Team operations: forwards shared operations (evidence: `src/main/java/com/projecte/team/mixin/TransmutationInventoryMixin.java`)
- Search hook → Name search: uses search helper (evidence: `src/main/java/com/projecte/team/mixin/ItemSearchHelperMixin.java`)
- Transmutation hooks → Knowledge sorting: uses sort helper (evidence: `src/main/java/com/projecte/team/mixin/TransmutationInventoryMixin.java`)
