⚡ ChillSMP — Ban Hammer & Unban Hammer
A custom SMP plugin inspired by tomlwsm's Chill SMP. Two ritual items that turn banning and unbanning into a server-wide event, with boss bar timers, full-screen titles, and optional Discord bot alerts.
🔨 Ban Hammer
Right-click to open a menu listing all online players. Select a target to start a ban ritual :
- A full-screen title announces the ritual to all players
- A red boss bar with a countdown timer appears at the top of everyone's screen
- If the targeted player is killed or disconnects within the time limit → they are immediately banned
- If they survive the full duration → the ritual fails and they are not banned
Crafting recipe
✨ Unban Hammer
Right-click to open a menu listing all banned players. Select a target to start an unban ritual :
- The spawn coordinates of the protected block are displayed to all players via a full-screen title
- A green boss bar with a countdown timer appears
- A Reinforced Deepslate block at spawn must remain intact for the duration
- If the block survives the full timer → the player is unbanned
- If the block is broken during the ritual → the unban fails and the player stays banned
Crafting recipe
✅ Features
- Custom Mace items with configurable names and lore via
config.yml - Items cannot be used as weapons (attacks are cancelled)
- Full-screen titles and boss bar timers visible to all players
- Spawn block coordinates displayed during unban rituals
- Discord bot integration — send alerts with role mentions to a channel of your choice
- Admin commands :
/givebanhammer,/giveunbanhammer,/chillsetspawn,/chillreload - Fully configurable : durations, messages, item names/lore, Discord settings
⚙️ Configuration
Everything is customizable in plugins/ChillSMP/config.yml after first launch :
| Setting | Description | Default |
|---|---|---|
ban-duration |
Duration of the ban ritual (seconds) | 3600 (1h) |
unban-duration |
Duration of the unban ritual (seconds) | 1800 (30min) |
ban-hammer.name |
Display name of the Ban Hammer | ⚡ Ban Hammer ⚡ |
unban-hammer.name |
Display name of the Unban Hammer | ✨ Unban Hammer ✨ |
discord.enabled |
Enable Discord bot alerts | false |
discord.token |
Your Discord bot token | — |
discord.channel-id |
Channel ID to send alerts to | — |
discord.role-id |
Role ID to mention in alerts | — |
🤖 Discord Bot Setup
- Go to discord.com/developers/applications → New Application
- Go to the Bot tab → Add Bot → copy the Token
- Go to OAuth2 → URL Generator → check
bot+Send Messages→ invite the bot to your server - Enable Developer Mode in Discord (Settings → Advanced)
- Right-click your channel → Copy ID → paste in
channel-id - Right-click your role → Copy ID → paste in
role-id - Set
discord.enabled: trueinconfig.ymland restart the server
🛠️ Commands & Permissions
| Command | Description | Permission |
|---|---|---|
/givebanhammer [player] |
Give the Ban Hammer | chillsmp.admin (op) |
/giveunbanhammer [player] |
Give the Unban Hammer | chillsmp.admin (op) |
/chillsetspawn |
Place the protected Reinforced Deepslate block at your feet | chillsmp.admin (op) |
/chillreload |
Reload the config | chillsmp.admin (op) |
Ressource pack
Download here
📋 Requirements
- Paper 1.21.4 or higher
- Java 21 or higher
🙏 Credits
Inspired by the Chill SMP plugin and series by tomlwsm on YouTube. Check out the Chill SMP playlist !
