JanusMCD – Discord ↔ Minecraft Chat Bridge & Passwordless Auth.

<div align="center"> <h1>JanusMCD</h1> <p><i>Discord ↔ Minecraft Chat Bridge & Passwordless Authentication.</i></p>

<p> <a href="https://modrinth.com/plugin/janusmcd"> <img src="https://img.shields.io/badge/Modrinth-JanusMCD-4a6cf7?style=for-the-badge&logo=modrinth" alt="Modrinth Tracking"> </a> </p> <p> <img src="https://img.shields.io/badge/Version-0.2.4-darkred?style=for-the-badge" alt="Version"> <img src="https://img.shields.io/badge/Paper-1.16.4%20--%201.21.x-green?style=for-the-badge" alt="Platform"> </p> </div>

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.

* Safe Logout Enforcement: Force players to link their Discord accounts before playing, or keep it optional. * Safe Logout Enforcement: 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. * Safe Logout Enforcement: Automatically invalidates verification codes if a player accidentally posts them in a public Discord channel. * Safe Logout Enforcement: 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. * Safe Logout Enforcement: Built-in waterfall support for ProxyCheck, VPNAPI, IPQualityScore, and IPHub. Automatically kicks players attempting to evade bans using VPNs or proxies. * Safe Logout Enforcement: 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.

* Actionable Moderation: Instantly view a player's Rank, Playtime, First Join, Last Seen status, and a fully rendered 30-day activity sparkline graph. * Actionable Moderation: 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. * Actionable Moderation: *Requires JupiterAdministration.* Janus actually generates a Actionable Moderation: of the player's Minecraft inventory, armour slots, offhand, and Ender Chest, sending it directly to Discord as a viewable image. * Actionable Moderation: 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.

* Proximity Voice Chat (Discord Native): JanusMCD doesn't just block words; it actively normalizes them. The built-in Proximity Voice Chat (Discord Native): 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. * Proximity Voice Chat (Discord Native): Seamlessly synchronize chat between Minecraft and *multiple* Discord channels across different servers. * Proximity Voice Chat (Discord Native): Block "nig" but allow "night" and "knight" seamlessly. * Proximity Voice Chat (Discord Native): 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.

* Vanish Integration: Automatically sync your Vault/LuckPerms ranks directly to specific Discord roles. * Vanish Integration: Ensure Discord names perfectly match Minecraft server usernames. * Vanish Integration: 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.

* Average Session Lengths: Accurately track unique player logins over custom timeframes. * Average Session Lengths: 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

- Velocity - Velocity - Velocity - Velocity - Velocity - 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)