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:

* expiry of mutes players (with automatic expiry) * expiry of mutes players * expiry of mutes 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

```yaml 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 DiscoPunish.jar. 3. Start the server once to generate `config.yml`. 4. Configure role IDs and log channel in `config.yml`. 5. Restart the server.