{"id":140876,"date":"2026-06-08T11:48:52","date_gmt":"2026-06-08T08:48:52","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/"},"modified":"2026-06-08T11:48:52","modified_gmt":"2026-06-08T08:48:52","slug":"simpleban","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/","title":{"rendered":"Simple Ban"},"content":{"rendered":"

# SimpleBan Plugin
\nSimple Ban is a comprehensive Minecraft moderation plugin that provides server administrators with complete punishment management tools<\/p>\n

![logo
\n](https:\/\/www.gtxgaming.co.uk\/)<\/p>\n

## Available Commands<\/p>\n

### Ban Commands<\/p>\n

#### `\/ban `
\n– **Description:** Permanently ban a player by name, IP, and UUID
\n– **Permission:** `spy.admin`
\n– **Usage Example:** `\/ban PlayerName Griefing the spawn area`
\n– **Features:**
\n – Bans by name, IP address, and UUID simultaneously
\n – Works on both online and offline players
\n – For online players: Immediately kicks with ban message
\n – For offline players: Creates offline ban that updates IP\/UUID on next join attempt
\n – Broadcasts ban message to all players
\n – Permanent ban (no expiration)<\/p>\n

#### `\/tempban

#### `\/unban `
\n– **Description:** Remove a ban from a player
\n– **Permission:** `spy.unban`
\n– **Usage Example:** `\/unban PlayerName`
\n– **Features:**
\n – Removes all ban data (name, IP, UUID)
\n – Works for both permanent and temporary bans
\n – Broadcasts unban message to all players
\n – Returns error if player is not banned<\/p>\n

#### `\/banlist`
\n– **Description:** Display all currently active banned players
\n– **Permission:** `spy.banlist`
\n– **Usage Example:** `\/banlist`
\n– **Features:**
\n – Shows only active (non-expired) bans
\n – Displays total ban count
\n – For each ban shows:
\n – Player name
\n – Ban reason
\n – Who banned them
\n – Ban date and time
\n – Ban type (Permanent\/Temporary)
\n – For temporary bans: expiration date and time remaining
\n – Formatted with colors for easy reading<\/p>\n

### Mute Commands<\/p>\n

#### `\/mute `
\n– **Description:** Permanently mute a player
\n– **Permission:** `spy.mute`
\n– **Usage Example:** `\/mute PlayerName Using inappropriate language`
\n– **Features:**
\n – Prevents player from sending chat messages
\n – Works on both online and offline players
\n – For online players: Immediately notifies them of mute
\n – For offline players: Creates offline mute that updates UUID on next join
\n – Broadcasts mute message to all players
\n – Permanent mute (no expiration)<\/p>\n

#### `\/unmute `
\n– **Description:** Remove a mute from a player
\n– **Permission:** `spy.mute`
\n– **Usage Example:** `\/unmute PlayerName`
\n– **Features:**
\n – Removes all mute data
\n – Broadcasts unmute message to all players
\n – Returns error if player is not muted
\n – Player can immediately chat again<\/p>\n

#### `\/mutelist`
\n– **Description:** Display all currently muted players
\n– **Permission:** `spy.mutelist`
\n– **Usage Example:** `\/mutelist`
\n– **Features:**
\n – Shows all active mutes
\n – Displays total mute count
\n – For each mute shows:
\n – Player name
\n – Mute reason
\n – Who muted them
\n – Mute date and time
\n – Formatted with colors for easy reading<\/p>\n

#### `\/tempmute

### Warning Commands<\/p>\n

#### `\/warn `
\n– **Description:** Issue a warning to a player
\n– **Permission:** `spy.warn`
\n– **Usage Example:** `\/warn PlayerName Breaking server rules`
\n– **Features:**
\n – Records warning in player’s history
\n – Works on both online and offline players
\n – For online players: Shows formatted warning message with total count
\n – Notifies all online staff members
\n – Warnings accumulate (no automatic removal)
\n – Displays warning count to warned player<\/p>\n

#### `\/unwarn `
\n– **Description:** Remove all warnings from a player
\n– **Permission:** `spy.unwarn`
\n– **Usage Example:** `\/unwarn PlayerName`
\n– **Features:**
\n – Removes ALL warnings from the specified player
\n – Shows how many warnings were removed
\n – Notifies target player if online
\n – Staff-only notifications (no public broadcast)
\n – Returns error if player has no warnings<\/p>\n

#### `\/warnlist `
\n– **Description:** Display all warnings for a specific player
\n– **Permission:** `spy.warnlist`
\n– **Usage Example:** `\/warnlist PlayerName`
\n– **Features:**
\n – Shows all warnings for the specified player
\n – Displays total warning count
\n – For each warning shows:
\n – Warning reason
\n – Who issued the warning
\n – Warning date and time
\n – Works for both online and offline players
\n – Returns message if player has no warnings<\/p>\n

## Permission System<\/p>\n

### Main Permissions
\n– `spy.admin` – Master permission (grants access to all commands)
\n– `spy.tempban` – Allows \/tempban command
\n– `spy.unban` – Allows \/unban command
\n– `spy.mute` – Allows \/mute and \/unmute commands
\n– `spy.tempmute` – Allows \/tempmute command
\n– `spy.warn` – Allows \/warn command
\n– `spy.banlist` – Allows \/banlist command
\n– `spy.unwarn` – Allows \/unwarn command
\n– `spy.warnlist` – Allows \/warnlist command
\n– `spy.mutelist` – Allows \/mutelist command<\/p>\n

### Permission Details
\n– All permissions default to `op` level
\n– `spy.admin` includes all other permissions as children
\n– `\/ban` command requires `spy.admin` permission directly
\n– Staff members need appropriate permissions to use moderation commands<\/p>\n

![banner](https:\/\/cdn.modrinth.com\/data\/cached_images\/e0bac08649e26b25ab2433bb4ff734f5ea37abbf_0.webp)
\n## Plugin Information
\n– **Name:** SpySimpleBan
\n– **Version:** 1.0.0
\n– **Description:** Simple ban plugin with IP and UUID banning
\n– **API Version:** 1.21<\/p>\n

## Data Storage<\/p>\n

### File Locations
\n– **Bans:** `plugins\/SpySimpleBan\/bans.json`
\n– **Mutes:** `plugins\/SpySimpleBan\/mutes.json`
\n– **Warnings:** `plugins\/SpySimpleBan\/warns.json`<\/p>\n

### Data Features
\n– JSON format for easy reading and backup
\n– Automatic data saving on all changes
\n– Thread-safe operations
\n– Automatic expired ban cleanup every second
\n– UUID enrichment for offline players when they join<\/p>\n

## Special Features<\/p>\n

### IP and UUID Banning
\n– Bans apply to player name, IP address, and UUID
\n– Prevents ban evasion through alt accounts on same IP
\n– UUID banning prevents name changes from bypassing bans<\/p>\n

### Offline Player Support
\n– All commands work on offline players
\n– Data is enriched with IP\/UUID when player joins
\n– Accurate targeting using stored player data<\/p>\n

### Auto-Expiration
\n– Temporary bans automatically expire
\n– Expired bans are cleaned up every second
\n– No manual intervention needed for timed punishments<\/p>\n

### Staff Notifications
\n– Warn command notifies all online staff
\n– Unwarn command sends staff-only notifications
\n– Broadcasting keeps staff informed of moderation actions<\/p>\n

### Chat Integration
\n– Muted players cannot send chat messages
\n– Chat listener prevents muted player messages
\n– Real-time mute checking during chat events<\/p>\n

### Error Handling
\n– Clear error messages for invalid usage
\n– Permission checks with user-friendly messages
\n– Validation for all command arguments
\n– Graceful handling of offline player operations<\/p>\n","protected":false},"excerpt":{"rendered":"

Simple Ban is a comprehensive Minecraft moderation plugin that provides server administrators with complete punishment management tools<\/p>\n","protected":false},"featured_media":140877,"template":"","meta":{"_minecraft_slug":"simpleban","_minecraft_project_id":"bj0Y3sod","_minecraft_author":"YourSenior","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":173,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simpleban.zip","_minecraft_size_bytes":885818,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T13:09:07.728070Z","_minecraft_date_created":"2025-09-16T23:47:11.767583Z","_minecraft_date_modified":"2025-10-17T02:21:17.798921Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simpleban","_minecraft_icon_attachment_id":140877,"_minecraft_imported_at":"2026-06-08T08:48:52+00:00","_minecraft_import_hash":"823a6d404fc954f0b04856ee8dc81713","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-140876","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","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","minecraft_version-1-21-9"],"yoast_head":"\nSimple Ban - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Simple Ban - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Simple Ban is a comprehensive Minecraft moderation plugin that provides server administrators with complete punishment management tools\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/\",\"name\":\"Simple Ban - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simpleban-icon-73fe02fd71494d5a9bce69dbf5a9ab83e087e99a_96.webp\",\"datePublished\":\"2026-06-08T08:48:52+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simpleban-icon-73fe02fd71494d5a9bce69dbf5a9ab83e087e99a_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simpleban-icon-73fe02fd71494d5a9bce69dbf5a9ab83e087e99a_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simpleban\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Simple Ban\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Simple Ban - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/","og_locale":"en_US","og_type":"article","og_title":"Simple Ban - Minecraft","og_description":"Simple Ban is a comprehensive Minecraft moderation plugin that provides server administrators with complete punishment management tools","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/","name":"Simple Ban - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simpleban-icon-73fe02fd71494d5a9bce69dbf5a9ab83e087e99a_96.webp","datePublished":"2026-06-08T08:48:52+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simpleban-icon-73fe02fd71494d5a9bce69dbf5a9ab83e087e99a_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simpleban-icon-73fe02fd71494d5a9bce69dbf5a9ab83e087e99a_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simpleban\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Simple Ban"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/140876","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/140877"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=140876"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=140876"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=140876"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=140876"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}