Configurable Ban System with Reason IDs
\nSmartBans is a lightweight yet powerful banning system designed for server staff who want to ban players quickly, consistently, and with clear reasoning. Instead of typing out full reasons every time, use short configurable reason IDs like \/ban Notch 1 to apply a preset punishment instantly.<\/p>\n
\u2705 Features:
\nBan with Reason IDs \u2013 Assign numeric codes to punishments (e.g. 1 = Cheating, 2 = Griefing).<\/p>\n
\u2699\ufe0f Fully Configurable \u2013 Set your own reasons, durations, and messages in config.yml.<\/p>\n
Lightweight & Fast \u2013 No unnecessary bloat; perfect for all server sizes.<\/p>\n
\ufe0f Permission-Based \u2013 Fine-tuned control for staff roles.
\nExample Usage
\n\/ban Notch 1<\/p>\n
\u2192 Bans Notch for 30 days for “Cheating”<\/p>\n
\/ban Herobrine 2<\/p>\n
\u2192 Bans Herobrine for 7 days for “Griefing”<\/p>\n
\/unban Notch<\/p>\n
\u2192 Unbans Notch<\/p>\n
Permissions:<\/p>\n “` “`<\/p>\n<\/details>\n Config Example:<\/p>\n “` settings: bans: mutes: # Duration format: # Messages usage-format: “` Why Choose SmartBans? Coming Soon? Already Implemented A smart, easy and fast way to ban players.<\/p>\n","protected":false},"featured_media":143749,"template":"","meta":{"_minecraft_slug":"smartban","_minecraft_project_id":"kotqy5fK","_minecraft_author":"Viirless","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":121,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smartban.zip","_minecraft_size_bytes":80543,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:10:53.791966Z","_minecraft_date_created":"2025-08-01T04:12:55.429674Z","_minecraft_date_modified":"2025-07-31T10:55:14.458931Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smartban","_minecraft_icon_attachment_id":143749,"_minecraft_imported_at":"2026-06-08T13:54:32+00:00","_minecraft_import_hash":"5c5943ebe6566993e648c1c2b52bed6a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,129],"mod_loader":[132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-143748","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nSpoiler<\/summary>\n
\nbanplugin.ban
\n> Allows banning players
\n\u200b
\nbanplugin.unban
\n> Allows unbanning players
\n\u200b
\nbanplugin.admin
\n> Allows banning and unbanning
\n\u200b
\nbanplugin.mute
\n> Allows muting
\n\u200b
\nbanplugin.unmute
\n> Allowes unmuting
\n\u200b
\nbanplugin.*
\n> Grants all permissions
\n\u200b
\nbanplugin.bypass
\n> Allows that you can’t be banned\/muted\/kicked
\n\u200b
\nbanplugin.history
\n> Allows to see a players ban \/ mute history
\n\u200b
\nbanplugin.reload
\n> Allowes reloading the plugin<\/p>\nSpoiler<\/summary>\n
\n# Ban Plugin Configuration
\n# Configure ban reasons, durations, and IDs<\/p>\n
\n use-id-system:
\n ban: true # true = use IDs (1,2,3), false = use reasons directly
\n mute: true # true = use IDs (1,2,3), false = use reasons directly<\/p>\n
\n 1:
\n reason: “Cheating\/Hacking”
\n duration: “30d”
\n 2:
\n reason: “Griefing”
\n duration: “7d”
\n 3:
\n reason: “Spam\/Advertising”
\n duration: “1h”
\n 4:
\n reason: “Toxic Behavior”
\n duration: “3d”
\n 5:
\n reason: “Exploiting”
\n duration: “14d”
\n 6:
\n reason: “Inappropriate Username”
\n duration: “1d”
\n 7:
\n reason: “Ban Evasion”
\n duration: “60d”
\n 8:
\n reason: “Staff Disrespect”
\n duration: “2d”<\/p>\n
\n 1:
\n reason: “Chat Spam”
\n duration: “1h”
\n 2:
\n reason: “Insulting Players”
\n duration: “2h”
\n 3:
\n reason: “Racism”
\n duration: “7d”
\n 4:
\n reason: “Advertising”
\n duration: “1d”
\n 5:
\n reason: “Toxic Behavior”
\n duration: “3d”<\/p>\n
\n# s = seconds, m = minutes, h = hours, d = days
\n# Examples: 30s, 5m, 2h, 7d<\/p>\n
\nmessages:
\n ban-success: “&aSuccessfully banned &c{player} &afor &e{reason} &afor &c{duration}”
\n unban-success: “&aSuccessfully unbanned &c{player}”
\n kick-success: “&aSuccessfully kicked &c{player} &afor &e{reason}”
\n player-not-found: “&cPlayer not found!”
\n player-not-online: “&cPlayer is not online!”
\n invalid-ban-id: “&cInvalid ban ID! Available IDs: {ids}”
\n no-permission: “&cYou don’t have permission to use this command!”
\n player-banned: “&cYou are banned from this server!n&cReason: &e{reason}n&cExpires: &e{expires}”
\n player-kicked: “&cYou have been kicked from the server!n&cReason: &e{reason}”
\n already-banned: “&c{player} is already banned!”
\n not-banned: “&c{player} is not banned!”
\n cannot-ban-staff: “&cYou cannot ban this player – they have bypass permission!”
\n cannot-kick-staff: “&cYou cannot kick this player – they have bypass permission!”
\n usage-ban: “&cUsage: \/ban
\n usage-unban: “&cUsage: \/unban
\n usage-kick: “&cUsage: \/kick
\n mute-success: “&aSuccessfully muted &c{player} &afor &e{reason} &afor &c{duration}”
\n unmute-success: “&aSuccessfully unmuted &c{player}”
\n player-muted: “&cYou have been muted in this server!n&cReason: &e{reason}n&cExpires: &e{expires}”
\n player-unmuted: “&cYou have been unmuted in this server!”
\n already-muted: “&c{player} is already muted!”
\n not-muted: “&c{player} is not muted!”
\n cannot-mute-staff: “&cYou cannot mute this player – they have bypass permission!”
\n usage-mute: “&cUsage: \/mute
\n invalid-mute-id: “&cInvalid mute ID! Available IDs: {ids}”
\n history:
\n title: “&8History of {player}”
\n no-entries: “&cNo history entries found”
\n entry:
\n ban: “&eBan”
\n mute: “&eMute”
\n by: “&7By: &f{staff}”
\n reason: “&7Reason: &f{reason}”
\n date: “&7Date: &f{date}”
\n duration:
\n permanent: “&7Duration: &fPermanent”
\n temporary: “&7Duration: &f{duration}”
\n invalid-player: “&cPlease enter a valid player name”
\n history-usage: “&cUsage: \/history
\n reload-success: “&aConfiguration successfully reloaded!”<\/p>\n
\n divider: “&7&m——————————–”
\n ban-command:
\n header: “&cUsage: &7\/ban
\n list-header: “&cAvailable Ban IDs:”
\n format: “&7ID: &c{id} &7| Reason: &c{reason} &7| Duration: &c{duration}”
\n mute-command:
\n header: “&cUsage: &7\/mute
\n list-header: “&cAvailable Mute IDs:”
\n format: “&7ID: &c{id} &7| Reason: &c{reason} &7| Duration: &c{duration}”
\n kick-command:
\n header: “&cUsage: &7\/kick
\n list-header: “&cKick Command Help:”
\n info: “&7Write your custom kick reason after the player name.”
\n example: “&7Example: &c\/kick Player1 Breaking the rules”<\/p>\n
\n<\/details>\n
\nSmartBans is perfect for staff who want clear, fast, and professional punishments without typing reasons every time. It’s ideal for survival, minigame, faction, or any type of server where moderation needs to be efficient and consistent.<\/p>\n
\n– GUI Based bans (toggle on and off)
\n– Web Plugin for CMS
\n– Add MySQL \/ PostgreSQL support<\/p>\n
\n– Mute System \u2714\ufe0f
\n– Bypass permission \u2714\ufe0f
\n– Kick Command \u2714\ufe0f
\n– Hybrid toggle function \u2714\ufe0f
\n– History System \u2714\ufe0f<\/p>\n","protected":false},"excerpt":{"rendered":"