🔧 Version update log

###V1.4.0 (latest version) Major new features:

• 🆕 ** FakeBan: A brand new temporary ban feature that supports automatic expiration and secondary confirmation mechanisms
• 🆕 ** Whitelist Protection System * *: protects designated players from bans, kicks, and temporary bans, preventing administrators from being maliciously banned
• 🆕 ** Intelligent Tab Completion * *: Comprehensive command completion support to improve operational efficiency and accuracy
• 🆕 ** Double confirmation mechanism * *: Fakeban operation requires executing the same command again within the specified time to take effect
• 🆕 ** Automatic expiration cleaning * *: The temporary ban will be automatically lifted after it expires, without the need for manual intervention

User experience improvement:

• 🆕 ** Intelligent Tab Completion System * *: Comprehensive command completion support, greatly improving operational efficiency
• 🆕 ** Permission aware completion * *: intelligently display available commands based on user permissions
• 🆕 ** Intelligent player filtering * *: automatically excludes players protected by whitelist to avoid misoperation
• 🆕 ** Quick completion of common options * *: Quick selection of commonly used parameters such as ban reason and duration
• 🆕 ** State awareness completion * *: unban displays banned players, unfakeban displays temporarily banned players

New command: -Bantools Fakeban<Player>[Reason] - Temporary ban on player (requires secondary confirmation) -/batools unfakeban<player>- Lift temporary ban

User experience improvement: -Intelligent Tab Completion: Display available commands based on permissions, automatically complete player names and common parameters -Player name filtering: Automatically exclude players from the whitelist protection during Tab completion -Common options: Provide quick selection of common reasons and duration of bans -State awareness: The unban and unfakeban commands only display players in their corresponding states

Configuration enhancement: -Unified configuration file: All configurations are centralized in the main configuration file, including whitelist settings -Added 'fakeban' configuration section, supporting custom temporary ban duration and confirmation message -Support customizing default reasons for temporary bans and confirming timeout periods

Technical improvements: -Optimized command processing architecture, supporting dynamic completion -Improved player list acquisition mechanism -Enhanced unified management of configuration files

Security improvement: -All operations (ban, kick, fakeban) support whitelist protection -Prevent administrators from being maliciously banned due to permission leakage -Temporary ban and regular ban are completely independent and do not affect each other

Fixed some bugs

BanTools | v1.2 Features

• Ban Functionality:
  • Supports banning by UUID, IP address, or player name.
  • Default ban duration is permanent (if no duration is specified).
  • Supports specifying ban duration (e.g., 7d for 7 days, 2024/1/10-2025/01/10 for a custom date range).
  • Automatically kicks banned online players.
• Unban Functionality:
  • Supports unbanning a player using the /bantools unban command.
  • Unbanning does not delete the ban record but marks the ban status as invalid.
• Kick Functionality:
  • Supports immediately kicking a player using the /bantools kick command.
  • A custom kick reason can be specified (default uses the configured reason in the config file).
• Automatic Unban Mechanism:
  • If a ban duration is specified, the ban will automatically expire when the time ends.
• Multi-Condition Matching:
  • On login, checks if UUID, IP address, or player name matches any ban records.
  • If any condition matches, the player is considered banned.
• Configuration File Support:
  • All ban records are stored in the config.conf file, which supports manual editing.
  • The configuration file allows setting default ban and kick reasons.
• Dynamic Configuration Reload:
  • Supports dynamically reloading the configuration file via the /bantools reload command without restarting the server.
• Real-Time Synchronization:
  • All ban, unban, and kick operations are synchronized in real-time across all downstream servers.

更新日志： 优化了部分代码结构 删除了一些冗余代码 更新了英文版README.md

如果有bug，欢迎提交Issues！

BanTools - Velocity Ban Management Plugin

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.

Note: This plugin is AI-developed to help server administrators manage player bans more efficiently.

Features

• Multi-Dimensional Bans:
  • Supports banning players by UUID, IP address, or username.
  • Ban priority: UUID > IP > Username.
• Dynamic Ban Management:
  • Use /ban uuid <uuid>, /ban ip <ip>, and /ban name <name> to dynamically add bans.
  • Bans are instantly written to the configuration file (config.conf).
• Online Player Handling:
  • Banned players currently online are kicked immediately.
• Configuration Reload:
  • Use /bantools reload to reload the configuration file without restarting the server.
• User-Friendly:
  • Configuration files use HOCON format for easy maintenance and scalability.