# \u26a1 BanHammer 4.0.0 – Enhanced Edition<\/p>\n
**The most feature-rich ban hammer plugin for Paper & Folia 26.1.x servers**<\/p>\n
Transform your moderation workflow with a dramatic ban hammer that strikes players with lightning, particles, and sound effects – all while maintaining a complete punishment database and Discord integration.<\/p>\n
—<\/p>\n
## \ud83c\udfa8 Resource Pack<\/p>\n
**The BanHammer texture pack is available as a separate download:**<\/p>\n
\u27a1\ufe0f **BS-BanHammer Resource Pack**<\/p>\n
Staff members will see a clickable download hint on join (configurable in `config.yml`).<\/p>\n
—<\/p>\n
## \ud83c\udfaf What Makes BS-BanHammer Special?<\/p>\n
### \ud83d\udd28 Dual-Action Preset System<\/p>\n
**Ban Presets (Shift + Right-Click):**
\n– Cycle through unlimited predefined ban types on-the-fly
\n– Each preset has custom duration, reason, IP-ban option, and sound
\n– Actionbar feedback shows active preset
\n– No commands needed – just shift-click and ban!<\/p>\n
**Kick\/Jail Presets (Shift + Left-Click):**
\n– Mix instant kicks and timed jails in one preset list
\n– Left-click players to execute with active preset
\n– Perfect for quick moderation without typing commands
\n– Separate preset tracking from ban presets<\/p>\n
**Example Workflow:**
\n“`
\n1. Shift + Right-Click \u2192 Switch to “7 Day Ban” preset
\n2. Right-Click on griefer \u2192 Instantly banned for 7 days with lightning!
\n3. Shift + Left-Click \u2192 Switch to “30 Min Jail” preset
\n4. Left-Click on spammer \u2192 Jailed for 30 minutes
\n“`<\/p>\n
### \u26a1 Dramatic Visual Effects<\/p>\n
Every punishment comes with spectacular effects:
\n– **Lightning strikes** at player location
\n– **Thunder & explosion sounds** for maximum impact
\n– **Particle effects** (critical hits & smoke)
\n– **Optional knockback** for extra drama
\n– Fully configurable per preset<\/p>\n
### \ud83d\udcca Complete Database System<\/p>\n
**SQLite or MySQL – Your Choice:**
\n– SQLite for single-server setups (zero configuration)
\n– MySQL for multi-server networks (shared ban database)
\n– Complete punishment history tracking
\n– Staff statistics and leaderboards
\n– Automatic cleanup of expired punishments
\n– GDPR-compliant IP anonymization<\/p>\n
### \ud83d\udd04 Auto-Unban Scheduler<\/p>\n
Set it and forget it:
\n– Automatic unbanning when temporary punishments expire
\n– Works for temp-bans, temp-mutes, and jail sentences
\n– Configurable check intervals (default: 60 seconds)
\n– Discord notifications on auto-unbans
\n– Event system for external plugins<\/p>\n
### \ud83c\udfad Extended Punishment Types<\/p>\n
**Beyond Bans:**
\n– **Mute System** – Blocks chat and commands (permanent or temporary)
\n– **Jail System** – Locks players in place with Essentials integration
\n– **Warning System** – Auto-ban after X warnings (configurable)
\n– **IP Bans** – Network-wide bans with anonymization options
\n– **Appeals** – Let players submit unban requests<\/p>\n
### \ud83c\udf10 Essentials Jail Integration<\/p>\n
**Smart Integration:**
\n– Soft dependency – no hard requirement
\n– Automatically uses Essentials jails if available
\n– Falls back to built-in jail system
\n– Works with existing Essentials jail configurations
\n– Reflection-based – no version conflicts<\/p>\n
### \ud83d\udcac Discord Webhook Integration<\/p>\n
**Real-Time Moderation Logs:**
\n– Color-coded embeds for different actions
\n– Rich information: player, staff, reason, duration
\n– Works independently of database
\n– Configurable per event type (bans, kicks, mutes, unbans, appeals)
\n– Automatic notifications on punishment expiry<\/p>\n
### \ud83c\udf0d Multi-Language Support<\/p>\n
Fully translated:
\n– \ud83c\udde9\ud83c\uddea **German** – Vollst\u00e4ndig \u00fcbersetzt
\n– \ud83c\uddec\ud83c\udde7 **English** – Fully translated
\n– All messages configurable in YAML files
\n– Easy to add custom languages<\/p>\n
### \ud83d\udd0c Developer-Friendly API<\/p>\n
**Custom Events:**
\n“`java
\nPlayerPunishEvent \/\/ Cancellable, fired before punishment
\nPlayerPunishedEvent \/\/ Fired after successful punishment
\nPlayerUnpunishedEvent \/\/ Fired when punishment removed
\n“`<\/p>\n
**PunishmentManager API:**
\n“`java
\npm.banPlayer(staff, victim, reason, duration, ipBan)
\npm.mutePlayer(staff, victim, reason, duration)
\npm.jailPlayer(staff, victim, reason, duration)
\npm.getHistory(playerUuid, limit)
\n“`<\/p>\n
### \ud83d\udcc8 Statistics & Appeals<\/p>\n
**Track Everything:**
\n– Staff leaderboards (most bans, kicks, etc.)
\n– Player punishment history
\n– Active punishment counts<\/p>\n
**Appeal System:** —<\/p>\n ## \ud83d\ude80 Quick Start<\/p>\n 1. **Install** the plugin in your `plugins\/` folder —<\/p>\n ## \ud83d\udcdd Commands Overview<\/p>\n | Command | Description | **Full command list in README.md**<\/p>\n —<\/p>\n ## \u2699\ufe0f Configuration Highlights<\/p>\n **Ban Presets Example:** serious: permanent: **Kick\/Jail Presets Example:** jail_30m: —<\/p>\n ## \ud83d\udd12 Security & Privacy<\/p>\n – **GDPR Compliant** – IP anonymization with 4 levels —<\/p>\n ## \ud83c\udf1f What’s New in 4.0.0?<\/p>\n **Paper 26.1.x Support (BREAKING):** **Previous Major Features:** —<\/p>\n ## \ud83d\udce6 Requirements<\/p>\n – **Server:** Paper or Folia 26.1.x or higher > **Looking for 1.21.x support?** Use BanHammer v3.1.1 instead.<\/p>\n —<\/p>\n ## \ud83d\udcdc License<\/p>\n MIT License – Free for all server types (commercial & non-commercial)<\/p>\n —<\/p>\n ## \ud83d\ude4f Credits<\/p>\n – **Plugin Development:** BoondockSulfur —<\/p>\n **\u2b50 If you enjoy BanHammer, please leave a rating! \u2b50**<\/p>\n Made with \u2764\ufe0f for the Minecraft community<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" The most feature-rich ban hammer for Paper & Folia 1.21.x – Strike players with lightning effects while maintaining a complete punishment database, Discord integration, and preset system.<\/p>\n","protected":false},"featured_media":35142,"template":"","meta":{"_minecraft_slug":"bs-banhammer","_minecraft_project_id":"odcCYmcd","_minecraft_author":"boondocksulfur","_minecraft_license":"MIT","_minecraft_downloads":469,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bs-banhammer.zip","_minecraft_size_bytes":109346222,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T10:45:39.537588Z","_minecraft_date_created":"2025-10-14T02:03:32.996993Z","_minecraft_date_modified":"2026-05-03T19:54:34.497947Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bs-banhammer","_minecraft_icon_attachment_id":35142,"_minecraft_imported_at":"2026-06-01T16:57:56+00:00","_minecraft_import_hash":"66599f024376857cf46d3a6c7f4f0cc2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,127,128,129,123,92],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-35141","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-folia","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-11","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– Players can submit appeals via `\/appeal
\n– Cooldown system prevents spam
\n– Staff review with `\/bh approve\/deny`
\n– Discord notifications for new appeals<\/p>\n
\n2. **Start** your server (auto-generates config)
\n3. **Give** yourself the hammer: `\/bh give
\n4. **Download** the Resource Pack for the custom texture
\n5. **Configure** presets in `config.yml` (optional)
\n6. **Use** the hammer:
\n – **Shift + Right-Click** to switch ban presets
\n – **Right-Click player** to ban with active preset
\n – **Shift + Left-Click** to switch kick\/jail presets
\n – **Left-Click player** to kick\/jail with active preset<\/p>\n
\n|———|————-|
\n| `\/bh give
\n| `\/bh reload` | Reload config (reinitializes Discord & DB) |
\n| `\/bh history
\n| `\/bh unban
\n| `\/bh stats [player]` | View moderation statistics |
\n| `\/bh appeals` | View pending appeals |
\n| `\/mute
\n| `\/jail
\n| `\/warn
\n“`yaml
\npresets:
\n warning:
\n displayName: “Warning Ban”
\n reason: “First offense”
\n duration: “1h”
\n ipBan: false
\n sound: “BLOCK_NOTE_BLOCK_PLING”<\/p>\n
\n displayName: “7 Day Ban”
\n reason: “Serious rule violation”
\n duration: “7d”
\n ipBan: false
\n sound: “BLOCK_NOTE_BLOCK_BASS”<\/p>\n
\n displayName: “Permanent Ban”
\n reason: “Permanently banned”
\n duration: “permanent”
\n ipBan: true
\n sound: “BLOCK_ANVIL_LAND”
\n“`<\/p>\n
\n“`yaml
\nkickJailPresets:
\n quick_kick:
\n displayName: “Quick Kick”
\n reason: “Kicked from server”
\n # No duration = instant kick<\/p>\n
\n displayName: “30 Min Jail”
\n reason: “Jailed for 30 minutes”
\n duration: “30m” # Has duration = jail
\n“`<\/p>\n
\n– **Permission-based** – Granular permission system
\n– **SQL Injection Protected** – Prepared statements everywhere
\n– **Bypass Protection** – Immune players can’t be banned
\n– **Self-Protection** – Can’t ban yourself
\n– **Cooldown System** – Prevents spam abuse<\/p>\n
\n– \u2728 Targets Paper 26.1.2+ with the new Minecraft versioning
\n– \u2728 Requires Java 25
\n– \u2728 All deprecated APIs modernized (Adventure Components, no more legacy color codes)
\n– \u2728 Smart update checker filters by game version (1.21.x users won’t see 4.x updates)
\n– \u2728 Resource pack moved to separate download<\/p>\n
\n– \u2728 Folia Support (dual Paper\/Folia compatibility)
\n– \u2728 Ban Presets System with preset cycling
\n– \u2728 Kick\/Jail Presets System (separate from ban presets)
\n– \u2728 Essentials Jail Integration
\n– \u2728 Modrinth Update Checker with game version filtering
\n– \u2728 Complete translation system (DE\/EN)
\n– \u2728 Discord works without database requirement<\/p>\n
\n– **Java:** 25 or higher
\n– **Optional:** MySQL Server (for MySQL mode)
\n– **Optional:** Essentials Plugin (for enhanced jail system)<\/p>\n
\n– **Resource Pack:** BS-BanHammer Resource Pack
\n– **Libraries:** HikariCP, discord-webhooks, Adventure<\/p>\n