JanusMCD

Introduction

Overview of JanusMCD, a comprehensive Minecraft-Discord integration plugin with security, authentication, and synchronization features.

JanusMCD

JanusMCD is a modern, secure Discord ↔ Minecraft integration plugin that provides real-time chat syncing, passwordless player authentication, and comprehensive Discord-based identity verification.

Built for servers that demand reliability, security, and seamless community integration without forcing players to use passwords or complicated commands.

🎯 What is JanusMCD?

JanusMCD brings your Discord community and Minecraft server together by:

Synchronizing chat between Minecraft and Discord in real-time
Linking accounts for unified identity across platforms
Enforcing security through VPN protection, account verification, and ban synchronization
Providing moderation tools like vanish, console access, and command logging
Enabling voice chat based on in-game proximity

✨ Key Features

🔄 Comprehensive Synchronization

Chat Relay: Real-time 2-way chat with webhook impersonation (player skins as avatars)
Role Sync: Automatically sync Minecraft permission groups (Vault) to Discord roles
Nickname Sync: Keep Discord nicknames consistent with Minecraft usernames
Ban Sync: Bidirectional ban enforcement (ban in-game → ban on Discord, and vice-versa)
Cross-Discord Sync: Relay chat across multiple Discord servers simultaneously

🛡️ Advanced Security Suite

VPN/Proxy Protection: Multi-provider waterfall (ProxyCheck, VPNAPI, IPQualityScore, IPHub)
IP Monitoring: Detects and blocks VPN cycling attempts
Nuclear Blacklist: Air-gap defense preventing critical commands via Discord
Console Command Security: Role-based access control for Discord console commands
Connection Throttling: Anti-bot protection preventing join spam attacks

👥 Identity & Authentication

Passwordless Authentication: Secure, code-based verification via Discord DMs
STRICT Linking Mode: Prevents public channel linking to stop brute-force attempts
Account Age Requirements: Block brand-new Discord accounts from linking
Linked Account Enforcement: Ban one account → all linked accounts banned
Trusted Sessions: Auto-vouch players from same IP within 24 hours
Duplicate Login Prevention: Prevents session hijacking

🌐 Network Support

Velocity Integration: Full support for Velocity proxy networks
Gateway & Enforcer Model: Proxy handles auth, backend servers enforce
Single Sign-On (SSO): Authenticate once, trusted across all servers
Cross-Server Sync: Account linking synced across entire network
Folia Compatible: Native support for Folia's regionized threading

🎨 Customization & Features

Webhook Impersonation: 4 modes (MINECRAFT, DISCORD, HYBRID_MINECRAFT, HYBRID_DISCORD)
Join/Leave Customization: Fully customizable messages with embeds and avatars
Advancement Notifications: Configurable advancement announcements with filtering
Death Messages: Customizable death message embeds
Server Notifications: Automatic startup/shutdown announcements
Command Logging: Audit trail for all in-game commands

💬 Smart Chat Filtering

Leetspeak Decoder: Detects "h4ck3r" as "hacker" and "w0rd" as "word"
Smart Boundaries: Strict word matching with phrase detection
Regex Patterns: Advanced pattern-based filtering
URL Blocking: Automatically removes links to prevent advertising
Anti-Spam: Rate limiting for chat messages

👻 Moderation Tools

Stealth Vanish: Packet-level invisibility with ProtocolLib
- Silent chests (no animation or sound)
- Tab-complete protection
- Configurable suppression (join/leave, advancements, deaths)
- Interaction controls (pickup, damage, mob targeting)
Freeze Command: Immobilize players for moderation
Console Relay: View console and execute commands from Discord

🎙️ Proximity Voice Chat

Location-Based Channels: Automatically moves players into voice channels based on proximity
Smart Clustering: Groups nearby players together efficiently
Spectator Mode: Separate channel for dead players
Mute on Death: Prevents ghosting in PvP scenarios
Configurable Radius: Customize proximity distance