BanTools

🔧 版本更新日志

v1.4.2 (最新版本)

新增功能：

• 🆕 可配置日志输出：新增 fakeban.log_loading_info 配置项，控制是否输出"加载了 X 个活跃的临时封禁记录"信息
• 🆕 可配置清理间隔：新增 fakeban.cleanup_interval_minutes 配置项，自定义过期记录检查间隔（默认1分钟）

配置优化：

• 管理员可以通过设置 log_loading_info = false 来关闭临时封禁加载日志
• 可以调整清理间隔来平衡性能和及时性（建议1-5分钟）

v1.4.1

重要修复：

• 🔧 修复空指针异常：解决了当封禁记录中UUID为null时导致的NullPointerException
• 🔧 改进离线玩家处理：完善了对离线封禁玩家的UUID和IP检查逻辑
• 🔧 增强稳定性：修复了临时封禁系统中的null值处理问题
• 🔧 登录拦截修复：确保离线封禁的玩家能够被正确拦截

技术改进：

• 在所有UUID和IP比较前添加null检查
• 优化了封禁匹配算法的安全性
• 改进了错误处理机制

🔧 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[Reason] - Temporary ban on player (requires secondary confirmation) -/batools unfakeban- 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！