# jinnang233/krypt04mcg-plugin architecture

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

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

## Overview

Krypt04McgRelay is a Bukkit/Spigot plugin that privately relays opaque encrypted packets; it does not encrypt or decrypt message bodies. The main workflow collects a player’s chat fragments, decodes packet metadata to find the receiver, then forwards the original fragments privately. Separate paths support custom payload channels and raw API streams, with optional ProtocolLib chat-spam interception. The graph follows the sampled callers and README-documented capabilities; unsampled internals are represented only where their subsystem is documented.

Main entry points: [`src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java) (Chat relay), [`src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java) (Plugin lifecycle), [`src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java`](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java) (Custom payload relay), [`src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java`](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java) (Raw stream relay)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Plugin lifecycle"]
  node_plugin["Plugin lifecycle"]
  node_config["Relay configuration<br/>[RelayConfig.java]"]
  node_messages["Localized messages<br/>[MessageBundle.java]"]
end

subgraph group_chat["Encrypted chat relay"]
  node_chatrelay["Chat relay"]
  node_fragmentservice["Fragment parsing"]
  node_collector["Fragment assembly"]
  node_inbox["Incoming queue<br/>[BoundedInbox.java]"]
  node_outbox["Delivery queue"]
end

subgraph group_channels["Payload and stream channels"]
  node_custom["Custom payload relay"]
  node_raw["Raw stream relay"]
  node_streamcontrol["Stream control<br/>[StreamControl.java]"]
end

subgraph group_support["Protocol and safeguards"]
  node_codec["Packet decoding<br/>[PacketCodec.java]"]
  node_packetmodel["Packet metadata"]
  node_limiter["Traffic limits"]
  node_interceptor["Chat interception"]
end

node_player(("Player"))
node_server["Bukkit server"]

node_server -->|"enables plugin"| node_plugin
node_plugin -->|"loads settings"| node_config
node_plugin -->|"loads language"| node_messages
node_plugin -->|"registers relay"| node_chatrelay
node_plugin -->|"registers channels"| node_custom
node_plugin -->|"registers streams"| node_raw
node_plugin -.->|"registers optionally"| node_interceptor
node_player -->|"sends fragments"| node_chatrelay
node_chatrelay -->|"queues input"| node_inbox
node_chatrelay -->|"parses fragments"| node_fragmentservice
node_chatrelay -->|"assembles fragments"| node_collector
node_chatrelay -->|"decodes packet"| node_codec
node_codec -->|"builds metadata"| node_packetmodel
node_chatrelay -->|"queues delivery"| node_outbox
node_chatrelay -->|"checks traffic"| node_limiter
node_chatrelay -->|"reads settings"| node_config
node_chatrelay -->|"formats notices"| node_messages
node_chatrelay -->|"forwards privately"| node_player
node_player -->|"sends payload"| node_custom
node_custom -->|"limits forwarding"| node_limiter
node_custom -->|"forwards payload"| node_player
node_player -.->|"opens stream"| node_raw
node_raw -->|"uses controls"| node_streamcontrol
node_raw -->|"limits traffic"| node_limiter
node_player -.->|"sends chat"| node_interceptor
node_interceptor -->|"coordinates bypass"| node_chatrelay

click node_plugin "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java"
click node_config "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RelayConfig.java"
click node_messages "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/MessageBundle.java"
click node_chatrelay "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java"
click node_fragmentservice "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/fragment/FragmentService.java"
click node_collector "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/fragment/FragmentCollector.java"
click node_inbox "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/BoundedInbox.java"
click node_outbox "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/FragmentOutbox.java"
click node_codec "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/protocol/PacketCodec.java"
click node_packetmodel "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/model/EncryptedPacket.java"
click node_limiter "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RelayTrafficLimiter.java"
click node_custom "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java"
click node_raw "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java"
click node_streamcontrol "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/StreamControl.java"
click node_interceptor "https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/ProtocolLibChatInterceptor.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_plugin,node_config,node_messages toneBlue
class node_chatrelay,node_fragmentservice,node_collector,node_inbox,node_outbox toneAmber
class node_custom,node_raw,node_streamcontrol,node_server toneMint
class node_codec,node_packetmodel,node_limiter,node_interceptor toneRose
class node_player toneIndigo
```

## Components

### Plugin lifecycle

- [Plugin lifecycle](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java): `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`
- [Relay configuration](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RelayConfig.java): `src/main/java/dev/krypt04mcg/relay/RelayConfig.java`
- [Localized messages](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/MessageBundle.java): `src/main/java/dev/krypt04mcg/relay/MessageBundle.java`

### Encrypted chat relay

- [Chat relay](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java): `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`
- [Fragment parsing](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/fragment/FragmentService.java): `src/main/java/dev/krypt04mcg/relay/fragment/FragmentService.java`
- [Fragment assembly](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/fragment/FragmentCollector.java): `src/main/java/dev/krypt04mcg/relay/fragment/FragmentCollector.java`
- [Incoming queue](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/BoundedInbox.java): `src/main/java/dev/krypt04mcg/relay/BoundedInbox.java`
- [Delivery queue](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/FragmentOutbox.java): `src/main/java/dev/krypt04mcg/relay/FragmentOutbox.java`

### Payload and stream channels

- [Custom payload relay](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java): `src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java`
- [Raw stream relay](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java): `src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java`
- [Stream control](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/StreamControl.java): `src/main/java/dev/krypt04mcg/relay/StreamControl.java`

### Protocol and safeguards

- [Packet decoding](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/protocol/PacketCodec.java): `src/main/java/dev/krypt04mcg/relay/protocol/PacketCodec.java`
- [Packet metadata](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/model/EncryptedPacket.java): `src/main/java/dev/krypt04mcg/relay/model/EncryptedPacket.java`
- [Traffic limits](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/RelayTrafficLimiter.java): `src/main/java/dev/krypt04mcg/relay/RelayTrafficLimiter.java`
- [Chat interception](https://github.com/jinnang233/krypt04mcg-plugin/blob/main/src/main/java/dev/krypt04mcg/relay/ProtocolLibChatInterceptor.java): `src/main/java/dev/krypt04mcg/relay/ProtocolLibChatInterceptor.java`

### Other components

- **Player**
- **Bukkit server**

## Connections

- Bukkit server → Plugin lifecycle: enables plugin (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Plugin lifecycle → Relay configuration: loads settings (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Plugin lifecycle → Localized messages: loads language (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Plugin lifecycle → Chat relay: registers relay (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Plugin lifecycle → Custom payload relay: registers channels (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Plugin lifecycle → Raw stream relay: registers streams (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Plugin lifecycle → Chat interception: registers optionally (evidence: `src/main/java/dev/krypt04mcg/relay/Krypt04McgRelayPlugin.java`)
- Player → Chat relay: sends fragments (evidence: `README.md`)
- Chat relay → Incoming queue: queues input (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Fragment parsing: parses fragments (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Fragment assembly: assembles fragments (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Packet decoding: decodes packet (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Packet decoding → Packet metadata: builds metadata (evidence: `src/main/java/dev/krypt04mcg/relay/protocol/PacketCodec.java`)
- Chat relay → Delivery queue: queues delivery (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Traffic limits: checks traffic (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Relay configuration: reads settings (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Localized messages: formats notices (evidence: `src/main/java/dev/krypt04mcg/relay/EncryptedChatRelay.java`)
- Chat relay → Player: forwards privately (evidence: `README.md`)
- Player → Custom payload relay: sends payload (evidence: `README.md`)
- Custom payload relay → Traffic limits: limits forwarding (evidence: `src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java`)
- Custom payload relay → Player: forwards payload (evidence: `src/main/java/dev/krypt04mcg/relay/CustomPayloadRelay.java`)
- Player → Raw stream relay: opens stream (evidence: `README.md`)
- Raw stream relay → Stream control: uses controls (evidence: `src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java`)
- Raw stream relay → Traffic limits: limits traffic (evidence: `src/main/java/dev/krypt04mcg/relay/RawStreamRelay.java`)
- Player → Chat interception: sends chat (evidence: `README.md`)
- Chat interception → Chat relay: coordinates bypass (evidence: `src/main/java/dev/krypt04mcg/relay/ProtocolLibChatInterceptor.java`)
