JanusMCD

JanusMCD - Minecraft Discord Bridge

A Minecraft server plugin that creates a seamless chat bridge between your Minecraft server and Discord channels, with advanced filtering and security features.

Features

• Multi-Version Support - Works with Minecraft servers from 1.16 to 1.21+
• Two-Way Chat Relay - Relay messages between Minecraft and Discord
• Console Integration - Send console output to Discord and execute console commands from Discord
• Advanced Message Filtering:
  • Profanity/banned word filtering
  • Regular expression pattern matching
  • URL detection and blocking
  • Anti-spam/raid protection with rate limiting
• Command Security:
  • Command detection and redirection to console channels
  • Password masking for sensitive commands (Non-configurable, this is hard coded for security reasons)
  • Command execution permissions

Security

This bot will only accept direct invocations. If a request does not come direct from a player, it will error. This is not a bug, this is a feature. This bot is designed to detect other plugins interactive with it.

Requirements

• Minecraft server running Spigot/Paper 1.16.5 or newer
• Java 17 or newer
• A Discord bot token and appropriate permissions

Installation

1. Download the latest plugin JAR from the releases page
2. Place the JAR file in your server's plugins folder
3. Start your server once to generate the configuration file
4. Edit the plugins/JanusMCD/config.yml file to add your Discord bot token and channel IDs
5. Restart your server

Configuration

JanusMCD is configured through the config.yml file.

See the full config.yml file for detailed descriptions of all options.

Version Compatibility

This plugin uses a specialized abstraction layer to support multiple Minecraft versions:

• 1.16-1.18: Uses the legacy AsyncPlayerChatEvent with backward compatibility
• 1.19-1.21+: Uses the modern Paper AsyncChatEvent with the Adventure API

All features work consistently across supported versions.

License

This project is licensed under the MIT License - see the LICENSE file for details.