# jinnang233/krypt04mcg architecture

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

- Interactive diagram: https://gitdiagram.com/jinnang233/krypt04mcg
- Repository: https://github.com/jinnang233/krypt04mcg

## Overview

Krypt04Mcg is a client-side Minecraft mod for post-quantum encrypted messaging over ordinary chat. The primary flow is command/chat input, identity and trust checks, packet encryption, fragmentation and chat dispatch; receiving reverses transport fragmentation before decrypting and displaying messages. Separate capabilities include session handshakes, key management, raw-channel/file sharing, and optional configuration/update checks. Edges are limited to README statements and SOURCE INDEX references or shown calls; other runtime wiring is not inferred.

Main entry points: [`src/client/java/dev/krypt04mcg/chat/ChatSendService.java`](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/chat/ChatSendService.java) (Chat send service), [`src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java) (Chat receive handler), [`src/main/java/dev/krypt04mcg/service/DataTransferService.java`](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/DataTransferService.java) (Raw channel API), [`src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java`](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java) (Session handshake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Minecraft client"]
  node_commands["Command entry"]
  node_chat_ui["Chat panel"]
end

subgraph group_message["Encrypted messaging"]
  node_send["Chat send service"]
  node_receive["Chat receive handler"]
  node_crypto["Cryptography<br/>[CryptoService.java]"]
  node_codec["Packet codec<br/>[PacketCodec.java]"]
  node_fragment["Fragment service"]
  node_reassembly["Fragment reassembly"]
  node_send_queue["Fragment send queue"]
end

subgraph group_identity["Identity and sessions"]
  node_key_store[("Key store")]
  node_trust[("TOFU trust")]
  node_key_ui["Key manager"]
  node_handshake["Session handshake"]
  node_sessions[("Session service")]
  node_history[("Replay history")]
end

subgraph group_transfer["Data transfer"]
  node_data_api["Raw channel API"]
  node_file_transfer["File sharing<br/>[SharingWorker.java]"]
  node_transfer_progress["Transfer progress"]
end

subgraph group_platform["Settings and integrations"]
  node_config["Mod configuration"]
  node_cloth["Cloth Config integration"]
  node_updates["Update checker<br/>[UpdateChecker.java]"]
end

node_player(("Minecraft player"))
node_chat_transport{{"Minecraft chat transport"}}
node_relay{{"Custom payload relay"}}

node_player -->|"invokes"| node_commands
node_player -.->|"opens"| node_chat_ui
node_commands -.->|"dispatches"| node_send
node_chat_ui -.->|"submits"| node_send
node_send -->|"looks up identity"| node_key_store
node_send -->|"checks trust"| node_trust
node_send -->|"encrypts"| node_crypto
node_send -->|"encodes packet"| node_codec
node_send -->|"fragments packet"| node_fragment
node_send -->|"queues fragments"| node_send_queue
node_send_queue -.->|"dispatches lines"| node_chat_transport
node_chat_transport -.->|"delivers lines"| node_receive
node_receive -.->|"reassembles"| node_reassembly
node_receive -.->|"decodes packet"| node_codec
node_receive -.->|"decrypts"| node_crypto
node_receive -.->|"loads keys"| node_key_store
node_receive -.->|"checks replay"| node_history
node_key_ui -->|"manages keys"| node_key_store
node_key_ui -->|"manages trust"| node_trust
node_send -->|"begins exchange"| node_handshake
node_handshake -->|"encrypts exchange"| node_crypto
node_handshake -->|"updates sessions"| node_sessions
node_data_api -->|"uses session state"| node_sessions
node_data_api -.->|"uses channels"| node_relay
node_data_api -->|"delegates sharing"| node_file_transfer
node_transfer_progress -.->|"tracks progress"| node_receive
node_config -->|"configures sending"| node_send
node_cloth -.->|"configures"| node_config
node_updates -.->|"checks releases"| node_relay

click node_commands "https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/command/CommandRegistrar.java"
click node_chat_ui "https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/gui/Krypt04McgChatScreen.java"
click node_send "https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/chat/ChatSendService.java"
click node_receive "https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java"
click node_crypto "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/crypto/CryptoService.java"
click node_codec "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/protocol/PacketCodec.java"
click node_fragment "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/fragment/FragmentService.java"
click node_reassembly "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/fragment/FragmentReassembler.java"
click node_send_queue "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/chat/FragmentSendQueue.java"
click node_key_store "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/KeyStoreService.java"
click node_trust "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/KeyTrustService.java"
click node_key_ui "https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/gui/Krypt04McgKeyManagerScreen.java"
click node_handshake "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java"
click node_sessions "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SessionService.java"
click node_history "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/DecryptionHistoryService.java"
click node_data_api "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/DataTransferService.java"
click node_file_transfer "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SharingWorker.java"
click node_transfer_progress "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/chat/TransferProgressTracker.java"
click node_config "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/config/Krypt04McgConfig.java"
click node_cloth "https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/config/ClothConfigBridge.java"
click node_updates "https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/update/UpdateChecker.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_chat_ui toneBlue
class node_send,node_receive,node_crypto,node_codec,node_fragment,node_reassembly,node_send_queue toneAmber
class node_key_store,node_trust,node_key_ui,node_handshake,node_sessions,node_history toneMint
class node_data_api,node_file_transfer,node_transfer_progress toneRose
class node_config,node_cloth,node_updates,node_player,node_chat_transport,node_relay toneIndigo
```

## Components

### Minecraft client

- [Command entry](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/command/CommandRegistrar.java): `src/client/java/dev/krypt04mcg/command/CommandRegistrar.java`
- [Chat panel](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/gui/Krypt04McgChatScreen.java): `src/client/java/dev/krypt04mcg/gui/Krypt04McgChatScreen.java`

### Encrypted messaging

- [Chat send service](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/chat/ChatSendService.java): `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`
- [Chat receive handler](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java): `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`
- [Cryptography](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/crypto/CryptoService.java): `src/main/java/dev/krypt04mcg/crypto/CryptoService.java`
- [Packet codec](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/protocol/PacketCodec.java): `src/main/java/dev/krypt04mcg/protocol/PacketCodec.java`
- [Fragment service](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/fragment/FragmentService.java): `src/main/java/dev/krypt04mcg/fragment/FragmentService.java`
- [Fragment reassembly](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/fragment/FragmentReassembler.java): `src/main/java/dev/krypt04mcg/fragment/FragmentReassembler.java`
- [Fragment send queue](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/chat/FragmentSendQueue.java): `src/main/java/dev/krypt04mcg/chat/FragmentSendQueue.java`

### Identity and sessions

- [Key store](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/KeyStoreService.java): `src/main/java/dev/krypt04mcg/service/KeyStoreService.java`
- [TOFU trust](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/KeyTrustService.java): `src/main/java/dev/krypt04mcg/service/KeyTrustService.java`
- [Key manager](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/gui/Krypt04McgKeyManagerScreen.java): `src/client/java/dev/krypt04mcg/gui/Krypt04McgKeyManagerScreen.java`
- [Session handshake](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java): `src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java`
- [Session service](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SessionService.java): `src/main/java/dev/krypt04mcg/service/SessionService.java`
- [Replay history](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/DecryptionHistoryService.java): `src/main/java/dev/krypt04mcg/service/DecryptionHistoryService.java`

### Data transfer

- [Raw channel API](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/DataTransferService.java): `src/main/java/dev/krypt04mcg/service/DataTransferService.java`
- [File sharing](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/service/SharingWorker.java): `src/main/java/dev/krypt04mcg/service/SharingWorker.java`
- [Transfer progress](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/chat/TransferProgressTracker.java): `src/main/java/dev/krypt04mcg/chat/TransferProgressTracker.java`

### Settings and integrations

- [Mod configuration](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/config/Krypt04McgConfig.java): `src/main/java/dev/krypt04mcg/config/Krypt04McgConfig.java`
- [Cloth Config integration](https://github.com/jinnang233/krypt04mcg/blob/main/src/client/java/dev/krypt04mcg/config/ClothConfigBridge.java): `src/client/java/dev/krypt04mcg/config/ClothConfigBridge.java`
- [Update checker](https://github.com/jinnang233/krypt04mcg/blob/main/src/main/java/dev/krypt04mcg/update/UpdateChecker.java): `src/main/java/dev/krypt04mcg/update/UpdateChecker.java`

### Other components

- **Minecraft player**
- **Minecraft chat transport**
- **Custom payload relay**

## Connections

- Minecraft player → Command entry: invokes (evidence: `README.md`)
- Minecraft player → Chat panel: opens
- Command entry → Chat send service: dispatches (evidence: `src/client/java/dev/krypt04mcg/command/CommandRegistrar.java`)
- Chat panel → Chat send service: submits
- Chat send service → Key store: looks up identity (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Chat send service → TOFU trust: checks trust (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Chat send service → Cryptography: encrypts (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Chat send service → Packet codec: encodes packet (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Chat send service → Fragment service: fragments packet (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Chat send service → Fragment send queue: queues fragments (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Fragment send queue → Minecraft chat transport: dispatches lines
- Minecraft chat transport → Chat receive handler: delivers lines
- Chat receive handler → Fragment reassembly: reassembles (evidence: `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`)
- Chat receive handler → Packet codec: decodes packet (evidence: `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`)
- Chat receive handler → Cryptography: decrypts (evidence: `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`)
- Chat receive handler → Key store: loads keys (evidence: `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`)
- Chat receive handler → Replay history: checks replay (evidence: `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`)
- Key manager → Key store: manages keys (evidence: `src/client/java/dev/krypt04mcg/gui/Krypt04McgKeyManagerScreen.java`)
- Key manager → TOFU trust: manages trust (evidence: `src/client/java/dev/krypt04mcg/gui/Krypt04McgKeyManagerScreen.java`)
- Chat send service → Session handshake: begins exchange (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Session handshake → Cryptography: encrypts exchange (evidence: `src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java`)
- Session handshake → Session service: updates sessions (evidence: `src/main/java/dev/krypt04mcg/service/SessionHandshakeService.java`)
- Raw channel API → Session service: uses session state (evidence: `src/main/java/dev/krypt04mcg/service/DataTransferService.java`)
- Raw channel API → Custom payload relay: uses channels (evidence: `README.md`)
- Raw channel API → File sharing: delegates sharing (evidence: `src/main/java/dev/krypt04mcg/service/DataTransferService.java`)
- Transfer progress → Chat receive handler: tracks progress (evidence: `src/client/java/dev/krypt04mcg/chat/ChatReceiveHandler.java`)
- Mod configuration → Chat send service: configures sending (evidence: `src/client/java/dev/krypt04mcg/chat/ChatSendService.java`)
- Cloth Config integration → Mod configuration: configures (evidence: `README.md`)
- Update checker → Custom payload relay: checks releases (evidence: `README.md`)
