MsCustomBans icon

MsCustomBans -----

The Ultimate Punishment Suite for Modern PaperMC Servers.

Download Now
44.7 KB .jar



MsCustomBans
The Ultimate, Modern, and Highly Configurable Punishment Solution​

[HR][/HR]

Tired of clunky, outdated ban plugins? MsCustomBans is a powerful, feature-rich punishment plugin built from the ground up for modern PaperMC servers (1.21+). It combines robust functionality with near-total customization, giving you complete control over your server's moderation.​

[HR][/HR]

⭐ Best Features ⭐

  • 99% Configurable: Almost every message, from the plugin prefix to the multi-line ban screens, is fully customizable in easy-to-edit YAML and TXT files.
  • Modern Punishment Suite: Includes all the essential commands: `/ban`, `/tempban`, `/kick`, `/mute`, `/tempmute`, `/warn`, `/unban`, and `/unmute`.
  • Punishment Templates: Create pre-defined punishment reasons and durations (e.g., "griefing", "xray") in your `config.yml` for fast, consistent, and error-free moderation.
    Code (Text):
    /mscb tempban <player> xray
  • Custom Message Templates: Edit your ban, temp-ban, and kick screens in separate `.txt` files for unlimited creativity and multi-line formatting.
  • Advanced Command System: A clean, unified command structure (`/mscb <subcommand>`) with full tab-completion for all arguments, making moderation effortless.
  • Silent Punishments: Punish players discreetly using the `-s` flag to hide public broadcasts. Perfect for catching cheaters without alerting them.
  • Detailed History: Use `/mscb check <player>` to view a complete, detailed, and formatted history of a player's punishments, including the issuer, reason, date, and status.
  • UUID Based: All punishments are tracked by player UUIDs, so they remain active even if a player changes their username.
  • Lightweight & Optimized: Built specifically for the modern Paper API, ensuring minimal impact on your server's performance.

[HR][/HR]

✨ Commands & Permissions ✨

Main Command: `/mscustombans`, `/mscb`, `/cbans`

Commands:
  • /mscb ban <player> [-s] [reason] - Permanently bans a player.
  • /mscb tempban <player> <duration|template> [-s] [reason] - Temporarily bans a player.
  • /mscb unban <player> - Unbans a player.
  • /mscb kick <player> [-s] [reason] - Kicks a player from the server.
  • /mscb mute <player> [-s] [reason] - Permanently mutes a player.
  • /mscb tempmute <player> <duration|template> [-s] [reason] - Temporarily mutes a player.
  • /mscb unmute <player> - Unmutes a player.
  • /mscb warn <player> [-s] [reason] - Warns a player.
  • /mscb check <player> - Checks a player's punishment history.
  • /mscb reload - Reloads the plugin's configuration.

Permissions:
  • mscb.admin - Grants access to all plugin commands.
  • mscb.ban - Access to /mscb ban.
  • mscb.tempban - Access to /mscb tempban.
  • mscb.unban - Access to /mscb unban.
  • mscb.kick - Access to /mscb kick.
  • mscb.mute - Access to /mscb mute.
  • mscb.tempmute - Access to /mscb tempmute.
  • mscb.unmute - Access to /mscb unmute.
  • mscb.warn - Access to /mscb warn.
  • mscb.check - Access to /mscb check.
  • mscb.reload - Access to /mscb reload.
  • mscb.notify - Receives punishment broadcast messages.
  • mscb.silent - Allows the use of the -s (silent) flag.

[HR][/HR]

⚙️ Configuration ⚙️

Code (YAML):

# Date format used in messages and logs.
date-format : "yyyy-MM-dd 'at' HH:mm:ss z"

# Ban templates for quick and consistent punishments.
ban-templates:
  griefing:
    duration : "7d"
    reason : "&cMajor Griefing - Rebuild required."
  xray:
    duration : "14d"
    reason : "&cUnfair Advantage - Use of X-Ray."
  spam:
    duration : "1h"
    reason : "&eChat Spam / Flood"
  advertising:
    duration : "30d"
    reason : "&cAdvertising external servers or services."
  permanent:
    duration : "-1"
    reason : "&4Severe violation of server rules."
 
Code (Text):

&c&lYou are permanently banned from this server!

&7Reason: &f{reason}
&7Banned by: &f{staff}
&7Punishment ID: &f#{id}

&7You can appeal at: &eyourwebsite.com/appeal
 
All messages are fully translatable in `messages.yml`, and all punishment data is stored in `punishments.yml`.​

[HR][/HR]

Need support or have a suggestion? Join our Discord server or leave a comment below!
DISCORD | SOURCE CODE​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 7
First Release: Oct 13, 2025
Last Update: Oct 13, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings