Simple Ban

SimpleBan Plugin

Simple Ban is a comprehensive Minecraft moderation plugin that provides server administrators with complete punishment management tools

%%MD0%%

Available Commands

Ban Commands

`/ban <player> <reason>`

- Features: Permanently ban a player by name, IP, and UUID - Features: `spy.admin` - Features: `/ban PlayerName Griefing the spawn area` - Features: - Bans by name, IP address, and UUID simultaneously - Works on both online and offline players - For online players: Immediately kicks with ban message - For offline players: Creates offline ban that updates IP/UUID on next join attempt - Broadcasts ban message to all players - Permanent ban (no expiration)

`/tempban <player> <time> <reason>`

- Features: Temporarily ban a player by name, IP, and UUID - Features: `spy.tempban` - Features: `/tempban PlayerName 1h Spamming in chat` - Features: - `s` = seconds (e.g., `30s`) - `m` = minutes (e.g., `15m`) - `h` = hours (e.g., `2h`) - `d` = days (e.g., `7d`) - Can combine: `1d12h30m` for 1 day, 12 hours, 30 minutes - Features: - Same IP/UUID banning as permanent ban - Automatically expires after specified time - Shows duration in kick message - Auto-cleanup removes expired bans

`/unban <player>`

- Features: Remove a ban from a player - Features: `spy.unban` - Features: `/unban PlayerName` - Features: - Removes all ban data (name, IP, UUID) - Works for both permanent and temporary bans - Broadcasts unban message to all players - Returns error if player is not banned

`/banlist`

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

Mute Commands

`/mute <player> <reason>`

- Features: Permanently mute a player - Features: `spy.mute` - Features: `/mute PlayerName Using inappropriate language` - Features: - Prevents player from sending chat messages - Works on both online and offline players - For online players: Immediately notifies them of mute - For offline players: Creates offline mute that updates UUID on next join - Broadcasts mute message to all players - Permanent mute (no expiration)

`/unmute <player>`

- Features: Remove a mute from a player - Features: `spy.mute` - Features: `/unmute PlayerName` - Features: - Removes all mute data - Broadcasts unmute message to all players - Returns error if player is not muted - Player can immediately chat again

`/mutelist`

- Features: Display all currently muted players - Features: `spy.mutelist` - Features: `/mutelist` - Features: - Shows all active mutes - Displays total mute count - For each mute shows: - Player name - Mute reason - Who muted them - Mute date and time - Formatted with colors for easy reading

`/tempmute <player> <time> <reason>`

- Features: Temporarily mute a player - Features: `spy.tempmute` - Features: `/tempmute PlayerName 30m Spamming in chat` - Features: - `s` = seconds (e.g., `30s`) - `m` = minutes (e.g., `15m`) - `h` = hours (e.g., `2h`) - `d` = days (e.g., `7d`) - Can combine: `1h30m` for 1 hour, 30 minutes - Features: - Same mute functionality as permanent mute - Automatically expires after specified time - Shows duration in mute message - Auto-cleanup removes expired mutes every second - Works on both online and offline players - For online players: Immediately notifies them with duration - Broadcasts mute message with duration to all players

Warning Commands

`/warn <player> <reason>`

- Features: Issue a warning to a player - Features: `spy.warn` - Features: `/warn PlayerName Breaking server rules` - Features: - Records warning in player's history - Works on both online and offline players - For online players: Shows formatted warning message with total count - Notifies all online staff members - Warnings accumulate (no automatic removal) - Displays warning count to warned player

`/unwarn <player>`

- Features: Remove all warnings from a player - Features: `spy.unwarn` - Features: `/unwarn PlayerName` - Features: - Removes ALL warnings from the specified player - Shows how many warnings were removed - Notifies target player if online - Staff-only notifications (no public broadcast) - Returns error if player has no warnings

`/warnlist <player>`

- Features: Display all warnings for a specific player - Features: `spy.warnlist` - Features: `/warnlist PlayerName` - Features: - Shows all warnings for the specified player - Displays total warning count - For each warning shows: - Warning reason - Who issued the warning - Warning date and time - Works for both online and offline players - Returns message if player has no warnings

Permission System

Main Permissions

- `spy.admin` - Master permission (grants access to all commands) - `spy.tempban` - Allows /tempban command - `spy.unban` - Allows /unban command - `spy.mute` - Allows /mute and /unmute commands - `spy.tempmute` - Allows /tempmute command - `spy.warn` - Allows /warn command - `spy.banlist` - Allows /banlist command - `spy.unwarn` - Allows /unwarn command - `spy.warnlist` - Allows /warnlist command - `spy.mutelist` - Allows /mutelist command

Permission Details

- All permissions default to `op` level - `spy.admin` includes all other permissions as children - `/ban` command requires `spy.admin` permission directly - Staff members need appropriate permissions to use moderation commands

Plugin Information

- API Version: SpySimpleBan - API Version: 1.0.0 - API Version: Simple ban plugin with IP and UUID banning - API Version: 1.21

Data Storage

File Locations

- Warnings: `plugins/SpySimpleBan/bans.json` - Warnings: `plugins/SpySimpleBan/mutes.json` - Warnings: `plugins/SpySimpleBan/warns.json`

Data Features

- JSON format for easy reading and backup - Automatic data saving on all changes - Thread-safe operations - Automatic expired ban cleanup every second - UUID enrichment for offline players when they join

Special Features

IP and UUID Banning

- Bans apply to player name, IP address, and UUID - Prevents ban evasion through alt accounts on same IP - UUID banning prevents name changes from bypassing bans

Offline Player Support

- All commands work on offline players - Data is enriched with IP/UUID when player joins - Accurate targeting using stored player data

Auto-Expiration

- Temporary bans automatically expire - Expired bans are cleaned up every second - No manual intervention needed for timed punishments

Staff Notifications

- Warn command notifies all online staff - Unwarn command sends staff-only notifications - Broadcasting keeps staff informed of moderation actions

Chat Integration

- Muted players cannot send chat messages - Chat listener prevents muted player messages - Real-time mute checking during chat events

Error Handling

- Clear error messages for invalid usage - Permission checks with user-friendly messages - Validation for all command arguments - Graceful handling of offline player operations