SimpleBan
A simple and open-source ban system for Paper Minecraft servers.
Developed by WRN.
Features
- 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
Requirements
- Minecraft:
1.21+ - Server software:
- Paper
- Spigot
- Java:
21+
Installation
- 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
Commands
Permanent Ban
/permban <player> <reason>
Example:
/permban Steve Advertising
Temporary Ban
/tempban <player> <time> <reason>
Examples:
/tempban Steve 10m Spam
/tempban Alex 2h Toxicity
/tempban Player 7d Rule violation
Time Formats
| Format | Description |
|---|---|
| s | Seconds |
| m | Minutes |
| h | Hours |
| d | Days |
| w | Weeks |
Permissions
| Permission | Description | Default |
|---|---|---|
simpleban.permban |
Use /permban | OP |
simpleban.tempban |
Use /tempban | OP |
Configuration
Configuration file:
plugins/SimpleBan/config.yml
You can customize messages, logging and update settings.
Development
Source code:
src/main/java/de/wrn/simpleban/
Main classes:
SimpleBan.java
BanCommand.java
BanManager.java
BanListener.java
Planned Features
-
/unban -
/baninfo - Ban IDs
- Discord webhook integration
- MySQL/MariaDB support
- Web management panel
- WRN Update API integration
- Multi-server synchronization
License
This project is open source.
You are free to view, modify and contribute to the project according to the repository license.
Credits
Created by WRN
Minecraft plugin project.
