JanusMCD is a modern, secure Discord ↔ Minecraft integration plugin that provides real-time chat syncing, passwordless player authentication, and Discord-based identity verification.
It is built for servers that want reliability, simplicity, and strong security without forcing players to use passwords or complicated commands.

JanusMCD brings your Discord community and Minecraft server together by synchronising chat, linking accounts, and ensuring only verified users can join — all through secure direct messages.

---

⭐ ✨ Key Features

🔄 Comprehensive Synchronization System

• Chat Sync: Real-time 2-way chat with full formatting, webhooks, and multi-guild support.
  • Webhook Impersonation: 4 modes (MINECRAFT, DISCORD, HYBRID_MINECRAFT, HYBRID_DISCORD)
  • Player Skins as Avatars: Messages appear with Minecraft player skins in Discord
  • Cross-Discord Sync: Relay chat across multiple Discord servers simultaneously
• 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.
  • Real-Time Pardons: Unbanning on Discord automatically unbans the player in Minecraft.

🛡️ Security Suite (VPN/Proxy Protection)

• Multi-Provider Waterfall: Integrated protection using ProxyCheck.io, VPNAPI.io, IPQualityScore, and IPHub.
• Smart Failover: Automatically switches providers if one fails or reaches its quota.
• IP Monitoring & Anti-VPN Cycling: Detects and kicks players attempting to bypass bans by rapidly switching VPN IPs.
• Nuclear Blacklist: Air-gap defense preventing critical commands (op, stop, reload, etc.) from Discord execution.
• Console Command Security: Role-based access control for Discord console commands.
• Connection Throttling: Anti-bot protection preventing join spam attacks.
• Duplicate Login Prevention: Prevents session hijacking by blocking duplicate logins.
• Strict Account Linking: Prevents public channel linking to stop brute-force attempts.

👥 Identity & Passwordless Authentication

• No Passwords: Secure, code-based verification via Discord DMs.
• STRICT Linking Mode: Invalidates codes sent in public channels and kicks player for security.
• Account Age Requirements: Prevent brand-new Discord accounts from linking.
• Avatar Requirement: Require Discord profile pictures to prevent throwaway accounts.
• Trusted Sessions: Auto-vouch players from same IP within 24 hours.
• Linked Account Enforcement:
  • Cross-Account Bans: If a player is banned on one account, all alt accounts linked to that Discord ID are automatically blocked.
  • Membership Requirement: Require players to be in your Discord server to play.
  • IP-Based Limits: Prevent multiple accounts from same IP address.
• Allowed Guilds: Restrict the bot to specific Discord servers for added security.
• Webhook Logging: Complete audit trail for all authentication events.

📊 Advanced Metrics & Visual Reporting

• /janus report: Generate beautiful charts directly in Discord.
  • Engagement: Track DAU/MAU, Retention, and new joins.
  • CCU Tracking: Monitor concurrent player counts over time.
  • Heatmaps: View activity intensity by hour and day.
• Slash Command Logging: Audit log all admin commands executed from Discord.

🎙️ Proximity Voice Chat

• Dynamic Channels: Automatically moves players into voice channels based on in-game location.
• Smart Clustering: Groups nearby players together efficiently.
• Lobby Fallback: Players outside radius return to a lobby channel.
• Spectator Mode: Separate channel for dead players to prevent ghosting.
• Mute on Death: Automatically mutes players when they die.

🕵️ Stealth Vanish (ProtocolLib Enabled)

• True Invisibility: Packet-level hiding prevents tab-completion and server list/query leaks.
• Silent Interaction: Open chests and barrels without sound or animation.
• Note: ProcotolLib is REQUIRED for these advanced stealth features. Without it, standard Bukkit hiding is used.

🪪 Account Linking & Verification

• Players cannot play until they verify via Discord
• Prevents alt abuse
• Ensures accountability and consistent identity across platforms
• Ideal for roleplay servers, community servers, content creators, or staff-managed SMPs

🧊 Player Freeze While Unverified

• Players spawn frozen until authentication completes
• Prevents griefing or world interaction before verification
• Prevents access to the player list until linked or authenticated

🌐 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 model.
• Scales from Single Servers to Large Networks: Works on standalone servers and multi-server networks.

🛠️ Easy Setup & Clean Configuration

• 11 Configuration Files: Organized by feature area for easy management.
  • discord.yml, security.yml, chat.yml, synchronization.yml
  • account-linking.yml, voice.yml, vanish.yml, proxy.yml
  • nuclear-blacklist.yml, debug.yml
• Simple Migration: Clear settings for messages, prompts, colors, and behavior.
• Works instantly on Spigot, Paper, Purpur, and Folia.

🔧 Admin & Moderation Tools

• Tartarus Integration: Full support for cross-plugin bans and admin commands.
• Force Unlink: Manage player link status directly.
• Connectivity Tests: Debug Discord channel connections easily.

⚙️ Lightweight & Efficient

• ZERO Main Thread Blocking: Every single function in JanusMCD is 100% Asynchronous.
• High Performance: Designed to handle large player counts without TPS drops.
• Minimal Overhead: Optimized for both massive networks and small SMPs.

---

⭐ Why Choose JanusMCD Over Other Discord Bridges?

Most plugins only sync chat.
JanusMCD adds identity, security, verification, and protection.

• No passwords stored anywhere
• No third-party accounts
• Discord acts as the authentication provider
• Cleaner, simpler, and more secure than legacy chat bridges
• Designed for modern servers with stricter moderation or membership requirements

---

⭐ Supported Platforms

• Spigot
• Paper
• Purpur
• Folia
• Bukkit-based servers
• Velocity (Proxy support)

Minecraft Versions: 1.21.x

Requirements:

• Java 17+
• Discord Bot Token
• ProtocolLib (Highly Recommended for advanced vanish features)

Optional Dependencies:

• Vault (Required for role synchronization)
• LuckPerms (Recommended permission plugin)
• Tartarus Punishments (Enhanced punishment management)

---

⭐ Permissions

janusmcd.admin              – Access admin commands
janusmcd.reload             – Reload configuration
janusmcd.unlink             – Manage player link status
janusmcd.freeze             – Freeze players
janusmcd.vanish             – Use the vanish command
janusmcd.vanish.see         – See vanished players
janusmcd.vanish.other       – Toggle vanish for other players
janusmcd.vanish.interact    – Bypass vanish interaction restrictions
janusmcd.vanish.chat        – Chat while vanished
janusmcd.vanish.no-pickup   – Prevent item pickup while vanished
janusmcd.vanish.reload      – Reload vanish configuration

---

⭐ Planned Features

• Enhanced Discord UI with buttons and dropdowns
• Advanced analytics dashboard
• Requested features from users (Not ruling anything out)