CraftersBan v2.9 — Premium Edition

Release Date: October 2026
Minecraft Compatibility: 1.13–1.21+
Supported Platforms: Spigot, Paper, Purpur, BungeeCord, and Velocity

Overview

CraftersBan v2.9 introduces major improvements to punishment tracking, database reliability, message formatting, and PlaceholderAPI integration.

This release introduces independent sequential punishment IDs, new global and player-specific statistics placeholders, improved MiniMessage and Adventure support, safer dependency handling, and more reliable plugin initialization.

What's New

1. Independent Punishment IDs

Punishment IDs now use independent sequential counters for each punishment type.

• Permanent Bans: Independent counter for permanent bans issued with /ban.
• Temporary Bans: Independent counter for /tempban and /ban <duration>.
• IP Bans: Dedicated counter for /ipban.
• Mutes and IP Mutes: Separate counters for /mute and /ipmute.
• Kicks and Warnings: Independent counters for /kick and /warn.

Technical improvements:

• Added the getNextTypeId method to the punishment repository implementations.
• Updated the API to assign sequential punishment IDs automatically before database insertion.
• Updated the relevant punishment commands to support the new ID assignment system.

2. New Statistics and Placeholders

Added new placeholders for displaying punishment statistics in messages, kick screens, and PlaceholderAPI-supported plugins.

Server-wide message placeholders

Available in messages.yml and kick screen messages:

%craftersban_total_sanctions%
%craftersban_total_permanent_bans%
%craftersban_total_temporary_bans%
%craftersban_total_ip_bans%

PlaceholderAPI — Global statistics

These placeholders work without requiring a target player:

%craftersban_total_punishments%
%craftersban_total_sanctions%
%craftersban_total_permanent_bans%
%craftersban_total_perm_bans%
%craftersban_total_temporary_bans%
%craftersban_total_temp_bans%
%craftersban_total_ip_bans%
%craftersban_total_ipbans%

PlaceholderAPI — Player-specific statistics

%craftersban_player_total_sanctions%
%craftersban_player_total_punishments%
%craftersban_player_permanent_bans%
%craftersban_player_temporary_bans%
%craftersban_player_ip_bans%

These placeholders provide access to historical punishment counts and server-wide statistics.

3. MiniMessage and Adventure Formatting Fixes

• Fixed gradient formatting issues affecting the [CraftersBan] prefix.
• Removed legacy component re-serialization that could break MiniMessage gradients.
• Updated message delivery to preserve native Adventure components.
• Fixed formatting in mute notifications, IP mute messages, lockdown notifications, and blocked-word warnings.
• Standardized component-based message delivery across multiple commands and listeners.

4. Database and Startup Improvements

• Fixed database credential loading from settings/database.yml.
• Improved configuration access for database host, port, name, username, and password.
• Reduced the risk of unintended plugin disablement during startup.
• Added detailed connection initialization error logs, including full stack traces for HikariCP, MySQL, and H2 failures.

5. Dependency and Build Improvements

• Improved Guice and MaxMind library shading and relocation.
• Relocated internal libraries under dev.xunknown.craftersban.libs.* to reduce potential conflicts with other plugins.
• Improved the Maven build and CircleCI deployment workflow.
• Verified the build pipeline for supported Paper 1.20+ and 1.21+ environments.

6. Safer PlaceholderAPI Integration

PlaceholderAPI remains an optional dependency.

• Removed a static PlaceholderAPI class reference that could cause NoClassDefFoundError when PlaceholderAPI was absent.
• Improved compatibility with servers that do not have PlaceholderAPI installed.
• Added a clear console notice explaining how to enable PlaceholderAPI placeholders.

CraftersBan now starts normally without PlaceholderAPI. PlaceholderAPI-dependent variables require PlaceholderAPI to be installed.

Compatibility

• Server Software: Spigot, Paper, and Purpur
• Minecraft Versions: 1.13–1.21+
• Proxy Support: BungeeCord and Velocity
• Databases: MySQL and H2
• Optional Dependency: PlaceholderAPI

Summary

CraftersBan v2.9 focuses on more reliable punishment tracking, expanded statistics, consistent message formatting, improved database initialization, and safer optional integrations.

Thank you for using CraftersBan!

— Crafters Development