MC-DC 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!

7. Install the mod in your Fabric 1.21.4 server/client

8. In-game, run /link <bridge-name> with just the bridge name from step 2 (e.g., /link myserver)

9. Discord, run /link <user> with the name of the minecraft user

10. In-game, run /confirm or /deny to confirm or deny the discord user linking to your minecraft account

11. 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
• /link <minecraft_username> - link to discord user to send chats to discord 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 - Send link to discord

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

Note: Blacklisted users/roles are blocked even if their type (user/role) is generally allowed.

Configuration

The mod configuration file (config/mcdiscordbridge.json) includes:

• serverUrl: The endpoint URL for your specific bridge instance
• checkIntervalTicks: How often to check for new messages (default: 40 ticks = 2 seconds)

You can update the bridge in-game using /link <bridge-name> (e.g., /link myserver)