A simple and open-source ban system for Paper Minecraft servers.
Developed by WRN.
- Permanent bans
- Temporary bans
- Custom ban reasons
- UUID-based player storage
- YAML data storage
- Automatic temporary ban expiration
- Join protection for banned players
- Configurable messages
- Expandable architecture
- Minecraft:
1.21+ - Server software:
- Paper
- Spigot
- Java:
21+
- Download the latest release from GitHub.
- Put the
.jarfile into your server plugin folder:
plugins/
- Restart your Minecraft server.
SimpleBan will automatically create:
plugins/
└── SimpleBan/
├── config.yml
└── bans.yml
/permban <player> <reason>
Example:
/permban Steve Advertising
/tempban <player> <time> <reason>
Examples:
/tempban Steve 10m Spam
/tempban Alex 2h Toxicity
/tempban Player 7d Rule violation
| Format | Description |
|---|---|
| s | Seconds |
| m | Minutes |
| h | Hours |
| d | Days |
| w | Weeks |
| Permission | Description | Default |
|---|---|---|
simpleban.permban |
Use /permban | OP |
simpleban.tempban |
Use /tempban | OP |
Configuration file:
plugins/SimpleBan/config.yml
You can customize messages, logging and update settings.
Source code:
src/main/java/de/wrn/simpleban/
Main classes:
SimpleBan.java
BanCommand.java
BanManager.java
BanListener.java
-
/unban -
/baninfo - Ban IDs
- Discord webhook integration
- MySQL/MariaDB support
- Web management panel
- WRN Update API integration
- Multi-server synchronization
This project is open source.
You are free to view, modify and contribute to the project according to the repository license.
Created by WRN
Minecraft plugin project.