Blocketing
Blocketing is a Fabric mod for seamless communication between a Discord channel and a Minecraft server, enabling bidirectional message synchronization and command execution.
โจ Features
- โ Syncs Minecraft and Discord messages in both directions ๐ฌ
- โ Join/Leave notifications with player avatars ๐ผ๏ธ
- โ Server start/stop announcements ๐
- โ Toggle sending advancement and death messages to Discord ๐
- โ Run Minecraft commands from Discord (permission-based) ๐ ๏ธ
- โ Player chat webhook mode (with avatar & name) ๐จ
- โ In-game configuration via commands ๐ฎ
- โ Update notifications for new mod versions ๐
- โ Paginated player list and server status via Discord slash commands ๐
- โ Multi-server support to run multiple Minecraft server instances using the same Discord bot token (per-server channel filtering) โพ๏ธ
๐ Installation
๐จ 1. Install the Mod
- Download the latest .jar from the Releases Page.
- Place the
.jarfile in your serverโsmods/folder. - Start the Minecraft server with Fabric.
- Configure the bot using the in-game commands (see below).
๐ค 2. Set up the Discord Bot
- Create a new Discord bot application in the Discord Developer Portal.
- Add the bot to your Discord server.
- Copy the
bot tokenfor later configuration.
๐ก๏ธ Permissions
- Minecraft:
/blocketingcommands require permission level 4 (OP). - Discord: For
/consolevia Discord, the user must have the configured OP role (if set).
โ๏ธ Configuration Commands
All configuration is done in-game using /blocketing commands (OP only):
Setup Discord Integration
/blocketing setup token <token>
Set the Discord bot token./blocketing setup guild <guild_id>
Set the Discord server (guild) ID./blocketing setup channel <channel_id>
Set the Discord channel ID for message sync./blocketing setup op_role <role_id>
Set the Discord role ID required to run/consolefrom Discord./blocketing setup webhook_url <url>
Set the Discord webhook URL for player chat webhook mode./blocketing setup
List available setup commands.
Feature Toggles
/blocketing toggle advancements
Enable/disable sending advancement messages to Discord./blocketing toggle deaths
Enable/disable sending death messages to Discord./blocketing toggle player_chat_mode
Enable/disable player chat webhook mode (uses webhook for chat, with player avatar and name)./blocketing toggle update-info
Enable/disable update notifications for new mod versions./blocketing toggle discord_chat_log
Enable/disable logging of Discord chat messages to the server console./blocketing toggle
List available toggles.
Other Commands
/blocketing reload
Reload the configuration and restart the Discord bot.
๐ฅ Discord Slash Commands
/status
Show server status (TPS, MSPT, CPU, RAM, uptime, version)./players
Show online players (paginated, with navigation buttons)./console <command>
Run a Minecraft command from Discord (requires OP role if set).
๐ฌ Player-Chat Webhook Mode
When enabled, Minecraft chat messages are sent to Discord using a webhook, displaying the player's name and avatar.
To enable, set a webhook URL and use /blocketing toggle player_chat_mode.
๐ Notifications
- Join/Leave: Player join/leave events are announced in Discord with player avatars.
- Advancements/Deaths: Advancement and death messages can be toggled.
- Server Start/Stop: Server start/stop events are announced in Discord.
- Update Info: OPs and Discord can be notified when a new mod version is available.
โ Need Help?
Feel free to ask questions or open an issue.
Shows a Discord message in Minecraft chat, a normal Minecraft chat message, the activation of webhook chat mode, and a message sent via Discord /command.
Shows server startup, player joining, a Discord message, Minecraft chat messages (with and without webhook mode), and an executed /command command.
Displays advancement messages, death messages, player disconnects, and server shutdowns as sent by Minecraft to Discord.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Blocketing v2.6.0 2.6.0 |
1.21.10, 1.21.9
|
fabric
|
Download |
|
Blocketing v2.5.2 2.5.2 |
1.21.10, 1.21.9
|
fabric
|
Download |
|
Blocketing v2.5.1 2.5.1 |
1.21.10, 1.21.9
|
fabric
|
Download |
|
Blocketing v2.5.0 2.5.0 |
1.21.9
|
fabric
|
Download |
|
Blocketing v2.4.4 2.4.4 |
1.21.9
|
fabric
|
Download |
|
Blocketing v2.4.3 2.4.3 |
1.21.5, 1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Blocketing v2.4.2 2.4.2 |
1.21.5, 1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Blocketing v2.4.1 2.4.1 |
1.21.5, 1.21.6, 1.21.7
|
fabric
|
Download |
|
Blocketing v2.4.0 2.4.0 |
1.21.5, 1.21.6
|
fabric
|
Download |
|
Blocketing v2.3.1 2.3.1 |
1.21.5, 1.21.6
|
fabric
|
Download |
|
Blocketing v2.3.0 2.3.0 |
1.21.5, 1.21.6
|
fabric
|
Download |
|
Blocketing v2.2.1 2.2.1 |
1.21.5, 1.21.6
|
fabric
|
Download |
|
Blocketing v2.2.0 2.2.0 |
1.21.5
|
fabric
|
Download |
|
Blocketing v2.1.0 2.1.0 |
1.21.5
|
fabric
|
Download |
|
Blocketing v2.0.0 2.0.0 |
1.21.5
|
fabric
|
Download |