Slackbridge

Slackbridge is a Fabric Minecraft <-> Slack chat relay for Minecraft 1.21.

Download

Slackbridge is available to download on:

• Modrinth
• CurseForge
• GitHub Releases

Features

• Relay
  • Relay messages from Slack to Minecraft (excludes threads)
  • Relay messages from Minecraft to Slack
  • Displays player join/leave messages in Slack
  • Displays death messages in Slack
  • Displays advancement messages in Slack
  • Displays server start/stop messages in Slack
• Slack Commands
  • /slackbridge-info - Displays online players and performance stats
• Minecraft Commands
  • /shrug <message> - Appends a shrug to the end of the message

Setup

Create a Slack App

• Go to Slack API and create a new app in your workspace using the following manifest. You may want to change the bot name and the command /slackbridge-info to something else. If you are using this in the Hack Club Slack workspace, you must change the command name.

{
    "display_information": {
        "name": "SlackBridge"
    },
    "features": {
        "bot_user": {
            "display_name": "SlackBridge",
            "always_online": false
        },
        "slash_commands": [
            {
                "command": "/slackbridge-info",
                "description": "See current server status",
                "should_escape": false
            }
        ]
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "channels:history",
                "chat:write",
                "chat:write.customize",
                "users:read",
                "commands"
            ]
        }
    },
    "settings": {
        "event_subscriptions": {
            "bot_events": [
                "message.channels"
            ]
        },
        "interactivity": {
            "is_enabled": true
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false
    }
}

• Once you have created the app, go to the "OAuth & Permissions" page and install the app to your workspace.
• Note down the Bot User OAuth Token.
• Go to the Basic Information page and create an app token. Note down the app token.
• In Slack, invite the bot to the channel you want to relay messages to.
• Right click on the channel and click "Copy Link". Note down the channel ID from the link. (It should look like C01A2B3C4D5)
• That's it on the Slack side! Let's get your server setup now.

Setup the Mod

• Install the mod on your server by adding the jar to the mods folder.
• Restart the server to generate the config file.
• Open the config file (config/slackbridge.json) and fill in the following fields:
  • slackBotToken - The Bot User OAuth Token
  • slackAppToken - The App Token
  • relayChannelId - The Channel ID
  • infoCommand - The command name you set in the manifest. This will default to /slackbridge-info - if you didn't change the manifest, you can leave this alone.
• Restart the server again and you should be good to go!