Blocketing

Blocketing

Syncs chat and commands between Discord and Minecraft

547 downloads 6 followers
Icon

Blocketing

Blocketing is a Fabric mod for seamless communication between a Discord channel and a Minecraft server, enabling bidirectional message synchronization and command execution.

Environment Loader

Modrinth downloads GitHub downloads


โœจ 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

  1. Download the latest .jar from the Releases Page.
  2. Place the .jar file in your serverโ€™s mods/ folder.
  3. Start the Minecraft server with Fabric.
  4. 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 token for later configuration.

๐Ÿ›ก๏ธ Permissions

  • Minecraft: /blocketing commands require permission level 4 (OP).
  • Discord: For /console via 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 /console from 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.


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