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