DiscoPunish

DiscoPunish — Minecraft Discord Integration Punishments

Project Page / Modrinth Listing Info

Summary

DiscoPunish is a lightweight Minecraft plugin that integrates with DiscordSRV to manage player punishments across both Minecraft and Discord. Mute, ban, and warn players with automatic expiry and Discord notifications. Perfect for servers that want synchronized moderation and the ability to punish someone without joining minecraft.

---

Features

• In-game and Discord-integrated punishments:

  • Mute players (with automatic expiry)
  • Ban players
  • Warn players

• Automatic expiry of mutes

• Discord notifications and logging for all punishments

• Role-based Discord permissions for moderation commands

• Simple configuration via config.yml:

  • Set roles allowed to ban, mute, or warn
  • Set Discord log channel

• Supports Minecraft and Discord commands

• Works seamlessly with DiscordSRV

---

Permissions

DiscoPunish uses in-game and Discord roles for moderation:

Permission	Description
discopunish.commands	Allows a player to use all commands

Discord role IDs can be set in config.yml to allow Discord members to moderate without granting Minecraft permissions.

---

Dependencies

• Paper 1.20+ (Minecraft server API)
• DiscordSRV 1.30+ (required)

Optional: None. All functionality works with just these dependencies.

---

Commands

Command	Description
/ban <player> [duration] <reason>	Ban a player in-game (Discord notification included)
/mute <player> [duration] <reason>	Mute a player in-game (Discord notification included)
/warn <player> <reason>	Warn a player with Discord logging
/unban <player>	Let a player regain access to the server
/unmute <player>	End a player's mute early

Duration format for mutes/bans:

• 10m = 10 minutes
• 2h = 2 hours
• 3d = 3 days
• 1w = 1 week

---

Configuration (config.yml) Example

roles:
  ban: "123456789012345678"   # Discord role allowed to ban
  mute: "123456789012345678"  # Discord role allowed to mute
log-channel-id: "987654321098765432"  # Discord text channel for logs

---

Installation

1. Download the latest DiscoPunish.jar and place it in your server’s plugins folder.
2. Install DiscordSRV.
3. Start the server once to generate config.yml.
4. Configure role IDs and log channel in config.yml.
5. Restart the server.