# forbidden-a/dforblock architecture

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

- Interactive diagram: https://gitdiagram.com/forbidden-a/dforblock
- Repository: https://github.com/forbidden-a/dforblock

## Overview

DForBlock is a configurable Discord-to-game bridge for Fabric, NeoForge, Paper, and Hytale. A platform plugin starts the shared orchestrator, which loads configuration and brings up the Discord bot; game events and Discord interactions are then translated through the shared communicator and Discord handlers. The README also documents a server control panel, rich presence, log forwarding, and LuckPerms support. Some of those paths are documented but not fully shown in the excerpts, so uncertain connections are marked dashed or omitted.

Main entry points: [`dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt`](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt) (Bridge orchestrator), [`dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt`](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt) (Bot manager), [`dforblock-core/src/main/kotlin/dev/forb/dforblock/core/IBlockyCommunicator.kt`](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/IBlockyCommunicator.kt) (Game interface), [`dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt`](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt) (Config loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platforms["Game adapters"]
  node_fabric["Fabric plugin<br/>[DForBlockFabric.kt]"]
  node_fabric_adapter["Fabric adapter"]
  node_neoforge["NeoForge plugin"]
  node_neoforge_adapter["NeoForge adapter"]
  node_paper["Paper plugin<br/>[DForBlockPaper.kt]"]
  node_paper_adapter["Paper adapter"]
  node_hytale["Hytale plugin"]
  node_hytale_adapter["Hytale adapter"]
  node_advancement_hook["Advancement hook"]
end

subgraph group_core["Shared bridge"]
  node_orchestrator["Bridge orchestrator"]
  node_communicator["Game interface"]
  node_mc_communicator["Minecraft operations"]
end

subgraph group_discord["Discord features"]
  node_discord_bot["Bot manager"]
  node_discord_events["Discord interactions"]
  node_scheduler["Scheduled tasks"]
  node_log_handler["Log forwarding"]
end

subgraph group_config["Configuration"]
  node_config_manager["Config loader<br/>[ConfigManager.kt]"]
  node_config_files["JSON5 settings"]
  node_channel_config["Channel settings<br/>[ChannelConfig.kt]"]
  node_core_config["Core settings<br/>[Core.kt]"]
  node_messages_config["Message templates<br/>[MessagesConfig.kt]"]
end

node_operator(("Server operator"))
node_games["Game server"]
node_discord_service["Discord"]

node_operator -->|"installs"| node_fabric
node_operator -->|"installs"| node_neoforge
node_operator -->|"installs"| node_paper
node_operator -->|"installs"| node_hytale
node_games -.->|"emits events"| node_fabric
node_games -.->|"emits events"| node_neoforge
node_games -.->|"emits events"| node_paper
node_games -.->|"emits events"| node_hytale
node_fabric -->|"starts; reports events"| node_orchestrator
node_neoforge -->|"starts; reports events"| node_orchestrator
node_paper -->|"starts; reports events"| node_orchestrator
node_hytale -->|"starts; reports events"| node_orchestrator
node_fabric -->|"creates"| node_fabric_adapter
node_neoforge -->|"creates"| node_neoforge_adapter
node_paper -->|"creates"| node_paper_adapter
node_hytale -->|"creates"| node_hytale_adapter
node_fabric_adapter -.->|"implements"| node_communicator
node_neoforge_adapter -.->|"implements"| node_communicator
node_paper_adapter -->|"implements"| node_communicator
node_hytale_adapter -->|"implements"| node_communicator
node_orchestrator -->|"loads"| node_config_manager
node_config_manager -->|"reads"| node_config_files
node_config_manager -->|"decodes"| node_channel_config
node_config_manager -->|"decodes"| node_core_config
node_config_manager -->|"decodes"| node_messages_config
node_orchestrator -->|"starts"| node_discord_bot
node_orchestrator -->|"uses"| node_communicator
node_discord_bot -->|"registers"| node_discord_events
node_discord_bot -->|"starts"| node_scheduler
node_discord_bot -.->|"configures"| node_log_handler
node_discord_bot -->|"connects"| node_discord_service
node_discord_events -->|"queries server"| node_communicator
node_discord_events -.->|"forwards chat"| node_games
node_scheduler -->|"starts flushing"| node_log_handler
node_scheduler -->|"updates channels"| node_discord_service
node_fabric -->|"registers hook"| node_advancement_hook
node_advancement_hook -->|"reports advancements"| node_orchestrator
node_discord_service -.->|"sends interactions"| node_discord_bot
node_discord_service -.->|"shows control panel"| node_operator

click node_fabric "https://github.com/forbidden-a/dforblock/blob/development/dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt"
click node_fabric_adapter "https://github.com/forbidden-a/dforblock/blob/development/dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/FabricModdedServerLike.kt"
click node_neoforge "https://github.com/forbidden-a/dforblock/blob/development/dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt"
click node_neoforge_adapter "https://github.com/forbidden-a/dforblock/blob/development/dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/NeoForgeModdedServerLike.kt"
click node_paper "https://github.com/forbidden-a/dforblock/blob/development/dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt"
click node_paper_adapter "https://github.com/forbidden-a/dforblock/blob/development/dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/PaperCommunicator.kt"
click node_hytale "https://github.com/forbidden-a/dforblock/blob/development/dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt"
click node_hytale_adapter "https://github.com/forbidden-a/dforblock/blob/development/dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/HytaleCommunicator.kt"
click node_orchestrator "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt"
click node_communicator "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/IBlockyCommunicator.kt"
click node_mc_communicator "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/ModdedMinecraftCommunicator.kt"
click node_config_manager "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt"
click node_config_files "https://github.com/forbidden-a/dforblock/tree/development/config"
click node_channel_config "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ChannelConfig.kt"
click node_core_config "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/Core.kt"
click node_messages_config "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/MessagesConfig.kt"
click node_discord_bot "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt"
click node_discord_events "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordEventHandler.kt"
click node_scheduler "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt"
click node_log_handler "https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/LogtoDiscordHandler.kt"
click node_advancement_hook "https://github.com/forbidden-a/dforblock/blob/development/dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt"

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_fabric,node_fabric_adapter,node_neoforge,node_neoforge_adapter,node_paper,node_paper_adapter,node_hytale,node_hytale_adapter,node_advancement_hook toneBlue
class node_orchestrator,node_communicator,node_mc_communicator toneAmber
class node_discord_bot,node_discord_events,node_scheduler,node_log_handler,node_operator,node_games toneMint
class node_config_manager,node_config_files,node_channel_config,node_core_config,node_messages_config toneRose
class node_discord_service toneIndigo
```

## Components

### Game adapters

- [Fabric plugin](https://github.com/forbidden-a/dforblock/blob/development/dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt): `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt`
- [Fabric adapter](https://github.com/forbidden-a/dforblock/blob/development/dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/FabricModdedServerLike.kt): `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/FabricModdedServerLike.kt`
- [NeoForge plugin](https://github.com/forbidden-a/dforblock/blob/development/dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt): `dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt`
- [NeoForge adapter](https://github.com/forbidden-a/dforblock/blob/development/dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/NeoForgeModdedServerLike.kt): `dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/NeoForgeModdedServerLike.kt`
- [Paper plugin](https://github.com/forbidden-a/dforblock/blob/development/dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt): `dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt`
- [Paper adapter](https://github.com/forbidden-a/dforblock/blob/development/dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/PaperCommunicator.kt): `dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/PaperCommunicator.kt`
- [Hytale plugin](https://github.com/forbidden-a/dforblock/blob/development/dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt): `dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt`
- [Hytale adapter](https://github.com/forbidden-a/dforblock/blob/development/dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/HytaleCommunicator.kt): `dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/HytaleCommunicator.kt`
- [Advancement hook](https://github.com/forbidden-a/dforblock/blob/development/dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt): `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt`

### Shared bridge

- [Bridge orchestrator](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt`
- [Game interface](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/IBlockyCommunicator.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/IBlockyCommunicator.kt`
- [Minecraft operations](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/ModdedMinecraftCommunicator.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/ModdedMinecraftCommunicator.kt`

### Discord features

- [Bot manager](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt`
- [Discord interactions](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordEventHandler.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordEventHandler.kt`
- [Scheduled tasks](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt`
- [Log forwarding](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/LogtoDiscordHandler.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/LogtoDiscordHandler.kt`

### Configuration

- [Config loader](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt`
- [JSON5 settings](https://github.com/forbidden-a/dforblock/tree/development/config): `config`
- [Channel settings](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ChannelConfig.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ChannelConfig.kt`
- [Core settings](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/Core.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/Core.kt`
- [Message templates](https://github.com/forbidden-a/dforblock/blob/development/dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/MessagesConfig.kt): `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/MessagesConfig.kt`

### Other components

- **Server operator**
- **Game server**
- **Discord**

## Connections

- Server operator → Fabric plugin: installs (evidence: `README.md`)
- Server operator → NeoForge plugin: installs (evidence: `README.md`)
- Server operator → Paper plugin: installs (evidence: `README.md`)
- Server operator → Hytale plugin: installs (evidence: `README.md`)
- Game server → Fabric plugin: emits events
- Game server → NeoForge plugin: emits events
- Game server → Paper plugin: emits events
- Game server → Hytale plugin: emits events
- Fabric plugin → Bridge orchestrator: starts; reports events (evidence: `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt`)
- NeoForge plugin → Bridge orchestrator: starts; reports events (evidence: `dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt`)
- Paper plugin → Bridge orchestrator: starts; reports events (evidence: `dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt`)
- Hytale plugin → Bridge orchestrator: starts; reports events (evidence: `dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt`)
- Fabric plugin → Fabric adapter: creates (evidence: `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt`)
- NeoForge plugin → NeoForge adapter: creates (evidence: `dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt`)
- Paper plugin → Paper adapter: creates (evidence: `dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt`)
- Hytale plugin → Hytale adapter: creates (evidence: `dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt`)
- Fabric adapter → Game interface: implements
- NeoForge adapter → Game interface: implements
- Paper adapter → Game interface: implements (evidence: `dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/PaperCommunicator.kt`)
- Hytale adapter → Game interface: implements (evidence: `dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/HytaleCommunicator.kt`)
- Bridge orchestrator → Config loader: loads (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt`)
- Config loader → JSON5 settings: reads (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt`)
- Config loader → Channel settings: decodes (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt`)
- Config loader → Core settings: decodes (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt`)
- Config loader → Message templates: decodes (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt`)
- Bridge orchestrator → Bot manager: starts (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt`)
- Bridge orchestrator → Game interface: uses (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt`)
- Bot manager → Discord interactions: registers (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt`)
- Bot manager → Scheduled tasks: starts (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt`)
- Bot manager → Log forwarding: configures (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt`)
- Bot manager → Discord: connects (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt`)
- Discord interactions → Game interface: queries server (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordEventHandler.kt`)
- Discord interactions → Game server: forwards chat
- Scheduled tasks → Log forwarding: starts flushing (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt`)
- Scheduled tasks → Discord: updates channels (evidence: `dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt`)
- Fabric plugin → Advancement hook: registers hook (evidence: `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt`)
- Advancement hook → Bridge orchestrator: reports advancements (evidence: `dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt`)
- Discord → Bot manager: sends interactions
- Discord → Server operator: shows control panel
