MC-DC Bridge

Deprecated

Fully clientside minecraft to discord chat bridge.

1. Create a Bridge Instance

1. Go to https://mc-dc.powerdata.dk
2. Create a Discord bot at https://discord.com/developers/applications
3. Enable “Message Content Intent” in bot settings
4. Get your bot token and invite it to your server’
5. Fill out the form with:
   – Bridge name (e.g., “myserver”)
   – Discord bot token
   – Initial Discord channel ID
6. IMPORTANT: Save the endpoint URL – this is the only time you’ll see it!

1. Install the mod in your Fabric 1.21.4 server/client
   1. In-game, run `/link <bridge-name>` with just the bridge name from step 2 (e.g., `/link myserver`)
   2. on discord, run `/link <minecraft-name>` with your ingame username.
   3. in-game, run `/confirm` if it is your discord user trying to link.
   4. Use `/dc <message>` to send messages to Discord

2. Discord Configuration

Your Discord bot will automatically have these slash commands:
– `/setchannel <channel>` – Change which channel to bridge
– `/bridgeinfo` – Show current bridge configuration and ping settings
– `/pingconfig [users] [roles] [everyone] [here]` – Configure what pings are allowed from Minecraft
– `/pingsettings` – View current ping configuration
– `/blacklistuser <user> <add/remove>` – Add or remove users from ping blacklist
– `/blacklistrole <role> <add/remove>` – Add or remove roles from ping blacklist
– `/blacklistview` – View all blacklisted users and roles
– `/link <minecraft-name>` – Link to a minecrat account
– `/unlink` – Unlink your minecraft account

Usage

– Discord messages from the configured channel appear in Minecraft chat as `[Discord] Username: Message`
– Minecraft players can send messages to Discord using `/dc <message>`
– Messages from Minecraft are automatically sanitized based on ping settings

Ping Control

By default, new bridges allow user pings but block role pings, @everyone, and @here. Use Discord slash commands to customize:

– User Pings (@username): Individual user mentions
– Role Pings (@role): Role mentions 
– @everyone: Pings all server members
– @here: Pings all online members

Basic Configuration Examples:

– `/pingconfig users:true roles:false everyone:false here:false` – Only allow user pings (default)
– `/pingconfig users:true roles:true everyone:true here:true` – Allow all pings
– `/pingconfig users:false roles:false everyone:false here:false` – Block all pings

Blacklist System

Even when user/role pings are enabled, you can blacklist specific users or roles:

– User Blacklist: Specific users who can’t be pinged from Minecraft
– Role Blacklist: Specific roles that can’t be pinged from Minecraft

Blacklist Examples:

– `/blacklistuser @Admin add` – Prevent pinging the Admin user
– `/blacklistrole @Moderators add` – Prevent pinging the Moderators role
– `/blacklistuser @Admin remove` – Allow pinging Admin again
– `/blacklistview` – See all blacklisted users and roles