How forbidden-a/dforblock works
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: DForBlockOrchestrator.kt Bridge orchestrator · DiscordBotManager.kt Bot manager · IBlockyCommunicator.kt Game interface · ConfigManager.kt Config loader
Components 24
Game adapters
- Fabric plugin
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt - Fabric adapter
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/FabricModdedServerLike.kt - NeoForge plugin
dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt - NeoForge adapter
dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/NeoForgeModdedServerLike.kt - Paper plugin
dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt - Paper adapter
dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/PaperCommunicator.kt - Hytale plugin
dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt - Hytale adapter
dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/HytaleCommunicator.kt - Advancement hook
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt
Shared bridge
- Bridge orchestrator
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt - Game interface
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/IBlockyCommunicator.kt - Minecraft operations
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/ModdedMinecraftCommunicator.kt
Discord features
- Bot manager
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt - Discord interactions
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordEventHandler.kt - Scheduled tasks
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt - Log forwarding
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/LogtoDiscordHandler.kt
Configuration
- Config loader
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt - JSON5 settings
config - Channel settings
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ChannelConfig.kt - Core settings
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/Core.kt - Message templates
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/MessagesConfig.kt
Other components
- Server operator
- Game server
- Discord
Connections 39
- Server operator → Fabric plugin: installs
README.md - Server operator → NeoForge plugin: installs
README.md - Server operator → Paper plugin: installs
README.md - Server operator → Hytale plugin: installs
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
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt - NeoForge plugin → Bridge orchestrator: starts; reports events
dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt - Paper plugin → Bridge orchestrator: starts; reports events
dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt - Hytale plugin → Bridge orchestrator: starts; reports events
dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/DForBlockHytalePlugin.kt - Fabric plugin → Fabric adapter: creates
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/DForBlockFabric.kt - NeoForge plugin → NeoForge adapter: creates
dforblock-neoforge/src/main/kotlin/dev/forb/dforblock/neoforge/DforblockNeoForgeMod.kt - Paper plugin → Paper adapter: creates
dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/DForBlockPaper.kt - Hytale plugin → Hytale adapter: creates
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
dforblock-papermc/src/main/kotlin/dev/forb/dforblock/papermc/PaperCommunicator.kt - Hytale adapter → Game interface: implements
dforblock-hytale/src/main/kotlin/dev/forb/dforblock/hytale/HytaleCommunicator.kt - Bridge orchestrator → Config loader: loads
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt - Config loader → JSON5 settings: reads
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt - Config loader → Channel settings: decodes
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt - Config loader → Core settings: decodes
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt - Config loader → Message templates: decodes
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/config/ConfigManager.kt - Bridge orchestrator → Bot manager: starts
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt - Bridge orchestrator → Game interface: uses
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/DForBlockOrchestrator.kt - Bot manager → Discord interactions: registers
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt - Bot manager → Scheduled tasks: starts
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt - Bot manager → Log forwarding: configures
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt - Bot manager → Discord: connects
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordBotManager.kt - Discord interactions → Game interface: queries server
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordEventHandler.kt - Discord interactions → Game server: forwards chat
- Scheduled tasks → Log forwarding: starts flushing
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt - Scheduled tasks → Discord: updates channels
dforblock-core/src/main/kotlin/dev/forb/dforblock/core/discord/DiscordTaskScheduler.kt - Fabric plugin → Advancement hook: registers hook
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt - Advancement hook → Bridge orchestrator: reports advancements
dforblock-fabric/src/main/kotlin/dev/forb/dforblock/fabric/mixin/PlayerAdvancementTracker.kt - Discord → Bot manager: sends interactions
- Discord → Server operator: shows control panel