Discord

SporeCore now supports Discord integration. You can connect your own Discord bot to SporeCore and allow players to link their Discord account with their in-game account.

By default, this feature is disabled, so make sure to enable it in config.yml. After setting up your Discord bot, restart the server, and everything should work correctly.

Currently, the Discord integration supports:

• Account linking

• Punishment notifications

🔗 Account Linking

Players can link their Discord account to their Minecraft account. This is required for certain features, such as punishment notifications, depending on your configuration.

---

⚖️ Punishments

You can configure the system so that staff members must have their Discord account linked before they are allowed to punish a player.

When a punishment is issued, SporeCore can send a Discord embed message to a specified channel. You can also enable pings so staff members are notified immediately when a punishment occurs.

For example, when a player is punished, a Discord message will be sent and the configured role or user will be pinged.

🛠️ Discord Bot Setup

To use this system, you need to create a Discord application and bot.

A popular plugin called DiscordSRV also connects Minecraft servers to Discord. They provide a very clear guide on how to:

• Create a Discord application

• Create a bot

• Retrieve the bot token

It is highly recommended to follow their guide if you are unfamiliar with Discord bots.

Initial Setup | DiscordSRV Documentationdocs.discordsrv.com

The only required information for SporeCore is the Discord Bot Token.

⚙️ Discord Configuration

discord:
  enabled: true
  botToken: ''
  staffRollback: ''
  staffRollbackPing: '@everyone'
  punishment: ''
  pingStaff: true
  rollback: ''
  rollbackPing: ''

🔹 Explanation of Settings

• enabled: Enables or disables Discord integration.

• botToken: The Discord bot token. Required to start and connect the bot.

• punishment: Webhook or channel used for punishment messages.

• pingStaff: Whether staff members should be pinged when a punishment is issued.

• staffRollback / staffRollbackPing: Discord webhook and ping for staff rollback messages.

• rollback / rollbackPing: Discord webhook and ping for inventory rollback messages.

📌 Important Notes

• Only the punishment feature requires the Discord bot to be enabled.

• Staff rollback and inventory rollback notifications do not require the Discord bot, as they use webhooks instead.

• If the bot token is missing or invalid, the Discord bot will not start.