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

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)