Overview

DeltaBan is a complete moderation solution built from scratch in Kotlin. It provides everything you need to manage player sanctions on your server with a clean, modern approach. No bloat, no unnecessary dependencies, just solid moderation tools that work.

Every command supports time-based durations, every message is fully customizable, and there's a built-in web dashboard so you can view all sanctions directly from your browser. No external hosting needed.



Features

• Ban System - Permanent and temporary bans with /ban and /tempban
• Mute System - Permanent and temporary mutes with /mute
• Warn System - Warnings with optional auto-expiry via /warn
• Web Dashboard - Built-in dark-themed web panel to view all sanctions
• Flexible Time Formats - Use 30s, 10m, 2h, 7d, 1a or combine like 1d12h
• Color Support - Full & color codes and &#RRGGBB hex colors in all messages
• Customizable Messages - Every single message is editable in messages.yml
• Staff Notifications - Private sanction alerts only for staff members
• Dual Database - SQLite (zero-config) or MySQL/MariaDB for larger setups
• Permission Based - Every command has its own permission, no wildcards
• Lightweight - Optimized async operations, connection pooling, lazy expiration
• Hot Reload - /deltaban reload applies config changes without restart

Commands

Time format examples:


Permissions

There are no wildcard permissions or bypass nodes. Each permission must be granted individually.



Web Dashboard Setup

The web dashboard runs inside the plugin. No external hosting, no nginx, no setup. Just works.

1. Make sure web.enabled is true in config.yml (enabled by default)
2. Set your desired port (default 8080)
3. Open http://your-server-ip:8080 in your browser
4. If behind a firewall, make sure the web port is open

The dashboard is read-only and public. It displays all sanctions with player avatars, type badges, time remaining, reason, staff, and date. Includes search by player name and filter by type.



Configuration

Database
By default DeltaBan uses SQLite which requires zero configuration. A database file is created automatically. For MySQL/MariaDB, change database.type to mysql and fill in your credentials.

Messages
All messages are in messages.yml. Supports standard & color codes, hex colors like &#FF5555, and placeholders like %player%, %reason%, %time%. Use /deltaban reload to apply changes without restart.

Network Mode
The network section in config.yml is for future BungeeCord/Velocity proxy support which is currently in development. Keep it disabled ( enabled: false) until proxy support is officially released.



Installation

1. Download DeltaBan-1.0.0.jar from the download button above
2. Place the JAR in your server's plugins/ folder
3. Start or restart the server
4. Edit plugins/DeltaBan/config.yml and messages.yml as needed
5. Run /deltaban reload to apply changes

Requirements:

• Java 17 or higher
• Paper or Spigot 1.17.1 - 1.21.x

Coming Soon

• BungeeCord proxy support with cross-server sanction sync
• Velocity proxy support
• Network-wide web dashboard from the proxy