kit-p / minecord

Bring your Minecraft world into your Discord guild

Minecord

Bring your Minecraft world into your Discord guild

Minecord is a Minecraft mod that brings your Minecraft world into your Discord guild.

It is a server-side only mod, uses JDA to interface with Discord, is built on the Fabric mod loader, and is available for modern versions of Minecraft Java Edition.

Features

💬 Chat

Chat is an addon that bridges chat-related events between Minecraft and Discord.

• Multi-channel support
• Filter events to Minecraft dimensions
• Translate unicode emojis, e.g. 😃 -> :smiley:
• Discord events relayed to Minecraft
  • A user sent a message
  • A user edited their recently sent message
  • A user reacted to a recent message
  • A user removed their reaction from a recent message
  • A user sent a message that contained attachments
• Minecraft events relayed to Discord
  • A player sent an in-game chat message
  • A player had died
  • A named animal/monster (with name tag) had died
  • A player unlocked an advancement
  • A player teleported to another dimension
  • A player joined the game
  • A player left the game
  • The server began to start
  • The server started and is accepting connections
  • The server began to stop
  • The server stopped and is offline
  • The server stopped unexpectedly and is inaccessible
    • Optionally attach the crash report when available

🪄 Commands

Commands is an addon that provides various commands to interact with your Minecraft server from Discord.

• Built-in commands ready to use
  • /uptime — shows for how long the server has been online
  • /tps — displays the Minecraft server's current ticks-per-second
• Configure your own slash commands to run Minecraft commands
  • For example, you could manage your server's whitelist via /whitelist
• Ability to apply cooldowns to commands
  • This can be configured on a per user, channel or guild basis
• Mod developers can register their own slash commands

😇 Presence

Presence is an addon that updates the bot presence in Discord to show more detailed statuses.

• Built-in presence categories ready to use
  • starting — used when the Minecraft server is starting
  • running — used when the Minecraft server is running
  • stopping — used when the Minecraft server is stopping
• Configure your own presences
  • Type of activity, i.e. competing, listening, playing, streaming, or watching
  • Name of activity (supports placeholder values)
• Mod developers can register and trigger their own presence categories

📦 API

API is a gateway into the Minecord mod. It equips developers with the tools necessary to integrate their mods with Discord.

Contributing

Thank you for considering contributing to Minecord! Please see the Contribution Guidelines.

Security Vulnerabilities

Please review the Security Policy on how to report security vulnerabilities.

Licence

Minecord is open-sourced software licenced under the MIT licence.