BansystemV1 - A Comprehensive Ban Management Plugin for Minecraft Servers
BansystemV1 is a robust and user-friendly ban management plugin designed for Minecraft servers running on Spigot or Paper. It provides server administrators with powerful tools to manage player bans, kicks, and unbans with ease, featuring customizable messages and seamless integration with the server's ban list. With support for temporary and permanent bans, this plugin ensures fair and efficient moderation for your Minecraft community.

Features

• Ban Command: Ban players with customizable durations (e.g., seconds, minutes, hours, days, months, years, or permanent) and provide a reason for the ban.
• Kick Command: Remove players from the server with a specified reason.
• Unban Command: Easily lift bans for players when appropriate.
• Customizable Messages: Fully configurable messages stored in a messages.yml file, supporting color codes and placeholders for dynamic content (e.g., %reason%, %source%, %duration%).
• Persistent Ban Storage: Bans are saved to a bans.dat file and synchronized with the server's ban list, ensuring reliability even after restarts.
• Automatic Ban Expiry: Temporary bans automatically expire when their duration ends, with synchronization to the server's ban list.
• Reload Command: Reload the messages.yml file without restarting the server, with change detection to avoid unnecessary reloads.
• Permission Support: Integrates with LuckPerms for fine-grained control over who can use ban, unban, and kick commands.
• Player Login Handling: Prevents banned players from joining and displays a formatted ban message with details like reason, source, and duration.
• Multilingual Ready: Messages can be easily translated or customized to suit your server's language and style.

Commands

• /ban : Bans a player for a specified duration (e.g., 10m, 1d, permanent) with a reason.
  • Permission: Bansystem.ban
• /unban : Unbans a specified player.
  • Permission: Bansystem.unban
• /kick : Kicks a player from the server with a reason.
  • Permission: Bansystem.kick
• /bansystem reload: Reloads the messages.yml configuration file.
  • Permission: Restricted to operators by default.

Permissions

• Bansystem.ban: Allows banning players.
• Bansystem.unban: Allows unbanning players.
• Bansystem.kick: Allows kicking players.

Configuration
The plugin includes a messages.yml file for customizing all messages displayed to players and administrators. Key placeholders include:

• %player%: The target player's name.
• %reason%: The reason for the ban or kick.
• %source%: The name of the command executor (e.g., admin or console).
• %duration%: The duration of the ban (e.g., "10 Minutes" or "Permanent").

Example messages.yml:

ban-message: |
§8§m--------------------------------------------
§c§l Your Server
§8§m--------------------------------------------
§7You have been §c§lbanned§7!
§f▸ §7Reason: §c%reason%
§f▸ §7By: §c%source%
§f▸ §7Duration: §c%duration%
§8§m--------------------------------------------
§7Unban possible at §fdiscord.gg/your discord server
§8§m--------------------------------------------

Dependencies

• LuckPerms: Required for permission management.

Installation

1. Download the plugin JAR file.
2. Place it in your server's plugins folder.
3. Ensure LuckPerms is installed.
4. Restart your server or use a plugin manager to load the plugin.
5. Configure the messages.yml file in the plugin's data folder (plugins/BansystemV1/).

Compatibility

• API Version: 1.13 and above
• Tested Minecraft Versions: 1.21
• Server Software: Spigot, Paper, or compatible forks

Why Choose BansystemV1?
This plugin is ideal for server owners who want a simple yet powerful ban management system. Its lightweight design ensures minimal performance impact, while its robust features provide everything needed for effective moderation. Whether you're running a small community server or a large network, BansystemV1 offers the flexibility and reliability to maintain a fair and enjoyable environment.

Support
For issues, suggestions, or feature requests, join our Discord server at