# BanTools – Velocity Ban Management Plugin<\/p>\n
  <\/p>\n
**BanTools** is an advanced ban management plugin designed for Minecraft Velocity servers. It supports banning players by UUID, IP address, or username, and provides dynamic configuration reloading and real-time kicking of online players.<\/p>\n
> **Note**: This plugin is AI-developed to help server administrators manage player bans more efficiently.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Ban Functionality**:
\n – Supports banning by UUID, IP address, or player name.
\n – Default ban duration is permanent (if no duration is specified).
\n – Supports specifying ban duration (e.g., `7d` for 7 days, `2024\/1\/10-2025\/01\/10` for a custom date range).
\n – Automatically kicks banned online players.
\n– **Unban Functionality**:
\n – Supports unbanning a player using the `\/bantools unban` command.
\n – Unbanning does not delete the ban record but marks the ban status as invalid.
\n– **Kick Functionality**:
\n – Supports immediately kicking a player using the `\/bantools kick` command.
\n – A custom kick reason can be specified (default uses the configured reason in the config file).
\n– **Automatic Unban Mechanism**:
\n – If a ban duration is specified, the ban will automatically expire when the time ends.
\n– **Multi-Condition Matching**:
\n – On login, checks if UUID, IP address, or player name matches any ban records.
\n – If any condition matches, the player is considered banned.
\n– **Configuration File Support**:
\n – All ban records are stored in the `config.conf` file, which supports manual editing.
\n – The configuration file allows setting default ban and kick reasons.
\n– **Dynamic Configuration Reload**:
\n – Supports dynamically reloading the configuration file via the `\/bantools reload` command without restarting the server.
\n– **Real-Time Synchronization**:
\n – All ban, unban, and kick operations are synchronized in real-time across all downstream servers.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
### 1. Download the Plugin
\nDownload the latest version of `BanTools.jar` from GitHub or other distribution channels.<\/p>\n
### 2. Install the Plugin
\nPlace the downloaded `BanTools.jar` file into the `plugins\/` directory of your Velocity server.<\/p>\n
### 3. Start the Server
\nStart the Velocity server. The plugin will automatically generate a default configuration file at `plugins\/BanTools\/config.conf`.<\/p>\n
## Configuration\uff08`config.conf`\uff09
\n“`
\ndefaults {
\n ban_reason = “\u8fdd\u53cd\u670d\u52a1\u5668\u89c4\u5219”
\n kick_reason = “\u7ba1\u7406\u5458\u5f3a\u5236\u8e22\u51fa”
\n}<\/p>\n
bans {
\n “Player1”: {
\n name: “Player1”
\n uuid: “069a79f4-44e9-4726-a5be-fca90e38aaf5”
\n ip: “192.168.1.100”
\n reason: “\u4f5c\u5f0a\u884c\u4e3a”
\n start_time: 1698765432
\n end_time: null # \u6c38\u4e45\u5c01\u7981
\n state: true # \u5c01\u7981\u72b6\u6001\uff08true\uff1a\u751f\u6548\uff0cfalse\uff1a\u89e3\u9664\uff09
\n }
\n}
\n“`
\n– `defaults.ban_reason`: Default ban reason.
\n– `defaults.kick_reason`: Default kick reason.
\n– `bans`: Stores all ban records, each entry contains the following fields:
\n – `name`: Player name.
\n – `uuid`: Player UUID.
\n – `ip`: Player IP address.
\n – `reason`: Ban reason.
\n – `start_time`: Ban start time (Unix timestamp).
\n – `end_time`: Ban end time (Unix timestamp), set to `null` for permanent bans.
\n – `state`: Ban status (true for active, false for unban).<\/p>\n
—<\/p>\n
## Usage<\/p>\n
### Commands<\/p>\n
| Command | Permission Node | Description | ### Examples —<\/p>\n ### Support & Feedback – **GitHub Issues**: Submit an Issue<\/p>\n —<\/p>\n ### License & Disclaimer —<\/p>\n ### Acknowledgments – Velocity API BanTools is an advanced ban management plugin designed for Minecraft Velocity servers. It supports banning players by UUID, IP address, or username, and provides dynamic configuration reloading and real-time kicking of online players.<\/p>\n","protected":false},"featured_media":25468,"template":"","meta":{"_minecraft_slug":"bantools","_minecraft_project_id":"u9OtVM1S","_minecraft_author":"NSrank","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":846,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bantools.zip","_minecraft_size_bytes":124045,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T09:08:27.218329Z","_minecraft_date_created":"2025-04-22T21:29:38.775327Z","_minecraft_date_modified":"2026-01-20T00:42:38.527540Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bantools","_minecraft_icon_attachment_id":25468,"_minecraft_imported_at":"2026-06-01T09:11:47+00:00","_minecraft_import_hash":"a2d90613d0d7125f725771231a353c56","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,92,985],"mod_loader":[986],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-25467","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|————————————-|——————————-|————————————–|
\n| `\/bantools reload` | `bantools.command.reload` | Reloads the plugin configuration file. |
\n| `\/bantools ban
\n| `\/bantools unban
\n| `\/bantools kick
\n1. Ban a player named `Bianpao_xiaohai`: `\/bantools ban Bianpao_xiaohai` (default ban duration is permanent; a reason can be added afterward).
\n2. Unban a player named `Steve`: `\/bantools unban Steve`.
\n3. Kick a player named `Steve`: `\/bantools kick Steve`.<\/p>\n
\nIf you encounter issues or have suggestions, please contact us via:<\/p>\n
\n– **Development Notice**: This plugin is AI-developed to provide efficient ban management tools for the Minecraft Velocity community.
\n– **License**: Distributed under the GNU General Public License v3.0. You may use, modify, and distribute it under the license terms.
\n– **Disclaimer**: The developer is not responsible for any issues arising from the use of this plugin.<\/p>\n
\nSpecial thanks to the following technologies and tools:<\/p>\n
\n– Typesafe Config
\n– Adventure API<\/p>\n","protected":false},"excerpt":{"rendered":"