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 minutes2h= 2 hours3d= 3 days1w= 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
- Download the latest DiscoPunish.jar and place it in your server's
pluginsfolder. - Install DiscordSRV.
- Start the server once to generate
config.yml. - Configure role IDs and log channel in
config.yml. - Restart the server.
