## PortalCord – Modern Discord Bridge for Paper 1.21<\/p>\n
**PortalCord** is a next-generation Discord bridge plugin designed specifically for Paper 1.21 servers. Unlike traditional bridges that spam plain text walls, PortalCord utilizes Discord’s modern Embed API to deliver rich, visually appealing messages with player avatars, color-coded status updates, and interactive slash commands. Built with performance in mind using async operations and Paper’s Adventure API, it ensures zero server lag while maintaining seamless two-way communication between your Minecraft server and Discord community.<\/p>\n
—<\/p>\n
### \ud83c\udfaf Core Features<\/p>\n
**Rich Discord Embeds**
\nEvery player join, leave, death, and advancement is displayed as a beautiful Discord embed featuring the player’s skin avatar (via Crafatar), custom colors (green for joins, red for leaves), and formatted timestamps. No more ugly plain text spam in your Discord channels.<\/p>\n
**Modern Slash Commands**
\nFull Discord slash command integration replacing outdated prefix commands (!help):
\n– `\/list` – Displays all online players with their ping counts in a formatted embed
\n– `\/server` – Shows real-time TPS, server version, uptime, and player count
\n– `\/announce <message>` – Broadcasts messages from Discord to all online Minecraft players with announcement formatting
\n– `\/execute <command>` – Execute console commands remotely from Discord (highly restricted)<\/p>\n
**Live Player Counter**
\nAutomatically updates a Discord channel name (voice or text) to reflect current server population in real-time. Displays as “\ud83c\udfae Players: 12\/100” and updates every 60 seconds (configurable). Helps Discord members see server status at a glance without joining Minecraft.<\/p>\n
**Two-Way Chat Synchronization**
\n– Minecraft \u2192 Discord: Chat messages sent in-game appear in Discord with player skin avatars and formatted text
\n– Discord \u2192 Minecraft: Messages sent in the linked channel appear in-game with [Discord] prefix and full MiniMessage color code support (RGB colors, gradients, hover events)<\/p>\n
**Advanced Security & Permissions**
\n– **Role-Based Access Control**: Discord commands are locked behind specific Role IDs. Only users with designated admin roles can use `\/announce` or `\/execute`
\n– **Command Blacklist**: Automatically filters sensitive commands (\/login, \/password, \/lp user) from appearing in Discord chat to prevent credential leaks
\n– **Word Filtering**: Built-in profanity filter that blocks specified words in both directions (Discord \u2192 MC and MC \u2192 Discord)
\n– **Secure Console Access**: Remote console access disabled by default. Must be explicitly enabled and restricted to specific trusted roles<\/p>\n
**Paper 1.21 Native**
\nBuilt specifically for Paper 1.21+ using the Adventure API for modern chat handling. Supports MiniMessage format serialization, async event handling to prevent main thread blocking, and Java 21 optimizations.<\/p>\n
—<\/p>\n
### \ud83d\udccb Command Reference<\/p>\n
**Minecraft Commands** (In-game):
\n– `\/portalcord` or `\/pc` – Displays plugin information, version, and help
\n– `\/portalcord reload` – Reloads configuration file without server restart
\n – Permission: `portalcord.reload`
\n – Default: OP only<\/p>\n
**Discord Slash Commands**:
\nAll Discord commands require the bot to have `applications.commands` scope and appropriate channel permissions.<\/p>\n
– `\/list` – Shows online players, their ping, and total count in a rich embed
\n – Access: Everyone (@everyone can use)
\n – Cooldown: None<\/p>\n
– `\/server` – Displays server statistics including current TPS (Ticks Per Second), server version, uptime duration, and online player count vs max slots
\n – Access: Everyone
\n – Updates: Real-time data<\/p>\n
– `\/announce <message: string>` – Broadcasts a message to all online Minecraft players with special formatting (colored [Discord] Announcement prefix)
\n – Access: Restricted to Role IDs listed in `commands.admin-roles`
\n – Parameter: message (required, max 2000 characters)
\n – Confirmation: Returns success\/failure message to Discord<\/p>\n
– `\/execute <command: string>` – Executes any command as console from Discord
\n – Access: Restricted to Role IDs listed in `console-access.allowed-roles`
\n – Security: Disabled by default in config (console-access.enabled: false)
\n – Logging: All executed commands logged with user attribution
\n – Warning: Powerful feature – only grant to server owners\/senior admins<\/p>\n
—<\/p>\n
### \ud83d\udd10 Permission System Details<\/p>\n
**Minecraft Permission Nodes**:
\n– `portalcord.admin` – Access to base \/portalcord command (Default: OP)
\n– `portalcord.reload` – Permission to reload configuration (Default: OP)<\/p>\n
**Discord Role Configuration**:
\nDiscord permissions are not based on Minecraft ranks but on Discord Role IDs. Configure these in `plugins\/PortalCord\/config.yml`:<\/p>\n
“`yaml
\ncommands:
\n admin-roles:
\n – “123456789012345678” # Admin Role ID
\n – “987654321098765432” # Moderator Role ID<\/p>\n
console-access:
\n enabled: false # Must be true to use \/execute
\n allowed-roles:
\n – “098765432109876543” # Owner Role ID only<\/p>\n","protected":false},"excerpt":{"rendered":"
PortalCord is a next-generation Discord bridge plugin designed specifically for Paper 1.18 – 1.21 servers.<\/p>\n","protected":false},"featured_media":104213,"template":"","meta":{"_minecraft_slug":"modern-discord-bridge","_minecraft_project_id":"9fuZtwle","_minecraft_author":"Sunnymittal112","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":48,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"modern-discord-bridge.zip","_minecraft_size_bytes":17108034,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:16:47.528165Z","_minecraft_date_created":"2026-02-02T19:52:10.308808Z","_minecraft_date_modified":"2026-02-01T14:48:29.936006Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/modern-discord-bridge","_minecraft_icon_attachment_id":104213,"_minecraft_imported_at":"2026-06-05T23:58:07+00:00","_minecraft_import_hash":"a4553608c49172c7befd6a1f148d7ca3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,90,127,128,867,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-104212","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n