JanusMCD is not just another Discord chat relay, it is a comprehensive Server Security, Player Intelligence, and Cross-Platform Integration Ecosystem. Designed for server networks that demand absolute control and premium features, JanusMCD bridges the gap between your Minecraft server and Discord with unparalleled depth, security, and moderation tools.

From thwarting session hijackers with IP verification to calculating dynamic "Trust Scores" for your player base, JanusMCD provides the definitive solution for modern Minecraft server administration.

---

🔒 Uncompromising Security & Authentication

JanusMCD’s authentication engine acts as an impenetrable shield for your server, ensuring that only verified players can access your world.

• Mandatory or Optional Linking (2FA): Force players to link their Discord accounts before playing, or keep it optional.
• Trusted Sessions & IP Verification: Players who authenticate successfully are granted a secure session. If their IP address changes unexpectedly, JanusMCD instantly detects the mismatch, wipes the trusted session, and forces a re-authentication to prevent session hijacking.
• Strict Security Mode: Automatically invalidates verification codes if a player accidentally posts them in a public Discord channel.
• Proxy/Velocity Integration (SSO): Full support for velocity networks. "Single Sign-On" allows players to authenticate once at the proxy level without being prompted on sub-servers. Unauthenticated players are instantly rerouted to your configured Lobby server.
• VPN & Proxy Blocking: Built-in waterfall support for ProxyCheck, VPNAPI, IPQualityScore, and IPHub. Automatically kicks players attempting to evade bans using VPNs or proxies.
• Advanced Anti-Bot: Connection throttling and Duplicate Login protection prevent rapid-fire join spam and brutal session-override attacks.
• Safe Logout Enforcement: If a player logs out in a dangerous location or an unauthenticated player joins, Janus securely teleports them to a safe default spawn until authentication is complete, restoring their location instantly afterwards.

---

👁️ The Panopticon: Advanced Player Intelligence

Why log into the server to investigate a player when you can do it directly from Discord? The Panopticon Manager is a revolutionary Discord-based GUI for staff to investigate players in real-time.

• Comprehensive Overviews: Instantly view a player's Rank, Playtime, First Join, Last Seen status, and a fully rendered 30-day activity sparkline graph.
• Dynamic Trust Scoring: JanusMCD automatically grades players with a 0-100% Trust Score. Is a player reliable, average, or high-risk? The system analyzes their Discord link status, playtime consistency, and Tartarus punishment history to give your staff instant insight.
• Visual Inventory Rendering: Requires JupiterAdministration. Janus actually generates a visual image of the player's Minecraft inventory, armour slots, offhand, and Ender Chest, sending it directly to Discord as a viewable image.
• Detailed NBT Forensics: Scroll through paginated Discord embeds to view every item's custom lore, enchantments, and custom model data. Check the "Quarantine" tab to see seized illegal items.
• Actionable Moderation: One-click Discord buttons to Kick, Mute, Ban (with custom reason modals), or Freeze a player instantly, without ever opening the Minecraft client.

---

💬 Next-Generation Chat & Filtering

Say goodbye to manual chat moderation and toxic bypasses.

• Adversarial Filter Pipeline: JanusMCD doesn't just block words; it actively normalizes them. The built-in Leetspeak Decoder aggressively strips out numbers and symbols (e.g. converting "n1g" or "$p@m") and runs the clean text against a specialized Word Trie, completely devastating bypass attempts.
• Cross-Discord Sync: Seamlessly synchronize chat between Minecraft and multiple Discord channels across different servers.
• Intelligent Exceptions: Block "nig" but allow "night" and "knight" seamlessly.
• Automated URL Scrubbing: A comprehensive regex filter catches and scrubs unwanted URLs or Discord invites before they hit the server.
• Proximity Voice Chat (Discord Native): The server automatically creates dynamic Discord Voice Channels based on in-game proximity! Players are seamlessly moved into temporary private voice channels, with support for dead-player muting and spectator channels.

---

☢️ The Nuclear Blacklist (Air-Gap Defence)

What happens if an Admin's Discord account gets compromised? JanusMCD employs The Nuclear Blacklist.

• Certain catastrophic commands (/op, /stop, /reload, /pex, /luckperms) are hard-coded into an air-gapped blacklist.
• Zero Exceptions: Even if the Discord bot owner tries to execute these commands via the Discord Console Relay, JanusMCD will block the execution. Your server cannot be "nuked" via a hijacked Discord account. ever.

---

🔄 Deep Synchronization

JanusMCD links your in-game world directly to your community.

• Role Synchronization: Automatically sync your Vault/LuckPerms ranks directly to specific Discord roles.
• Nickname Syncing: Ensure Discord names perfectly match Minecraft server usernames.
• Cosmetic Event Sync: Rich embed broadcasts in Discord for Server Startup/Shutdown, Join/Leave events (with player avatars), Mobs/Player Deaths, and Advancements.
• Vanish Integration: Fully compatible vanish system. When a staff member vanishes in-game, JanusMCD seamlessly suppresses Discord join/quit messages, death messages, and advancement broadcasts, ensuring absolute stealth. Prevent item pickup, mob targeting, and damage while vanished.

---

📊 Enterprise Metrics & Analytics

Stop guessing about your server's growth. JanusMCD's built-in Metrics Tracker database silently analyzes your player base.

• Daily/Monthly Active Users (DAU/MAU): Accurately track unique player logins over custom timeframes.
• Retention Rate Tracking: Perform cohort analysis to see what percentage of players who joined 3 days ago are actually returning today.
• Average Session Lengths: Provides session histograms (e.g., how many players play for <15m vs >4h).

---

⭐ Supported Platforms

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

Minecraft Versions: 1.21.x

Requirements:

• Java 21+
• 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)