Перейти к содержимому
Mineforgian

CraftersBan

A comprehensive punishment plugin for Minecraft servers

Загрузки
40
Подписчики
0
Обновлён
4 июля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 31 марта 2026 г.

CraftersBan

CraftersBan – Advanced Punishment & Moderation Suite for Spigot/Paper

CraftersBan is a complete punishment management plugin for Minecraft servers that want a fast, organized, and modern moderation workflow. It brings the most important staff tools into one place: bans, tempbans, mutes, tempmutes, warnings, tempwarnings, kicks, IP punishments, punishment history, active punishment lists, account investigation tools, lockdown controls, chat moderation, and Discord webhook support.

Designed for real production use, CraftersBan focuses on:

  • Clean staff workflows
  • Flexible YAML configuration
  • Useful moderation utilities
  • Support for both local and network-style server setups
  • Reliable storage with MySQL or H2

⚔️ Main Features

  • Full punishment systemban, mute, warn, tempwarn, kick, ipban and ipmute.
  • Staff-friendly commands – Check active punishments, view player history, and browse ban, mute and warning lists.
  • Warning managementunwarn and warning lookup commands.
  • Silent punishments – Staff-only moderation actions hidden from public chat.
  • Punishment templates – Quick reasons for faster staff responses.
  • Alt/account lookup – Investigate linked accounts through stored player IP history.
  • GeoIP lookup support – Know where players are connecting from.
  • Lockdown mode – Restrict server access during incidents.
  • Chat moderationclearchat and mutechat tools.
  • Discord webhook integration – Punishment logs and alerts sent to Discord.
  • Auto config merge – Updates never overwrite your existing customization.

🖼️ Screenshots

Ban screen shown to a punished player. Banned

Full punishment history view for a player. History

Kick message displayed when a player is removed from the server. Kick

Mute notification shown to the affected player. Mute

Temporary ban screen with expiration details. Tempbanned


📋 Command Highlights

  • Punishments: /ban, /ipban, /mute, /ipmute, /warn, /tempwarn, /unwarn, /kick
  • Lookup: /history, /checkban, /checkmute, /checkwarn, /alts, /geoip, /lastuuid
  • Lists: /banlist, /mutelist, /warnlist
  • Server: /lockdown, /clearchat, /mutechat, /punish, /craftersban

🔌 Storage & Integrations

  • Storage: MySQL, H2
  • Soft dependencies: LuckPerms, Vault, PlaceholderAPI
  • Notifications: Discord webhook support

✅ Compatibility

  • Platform: Bukkit / Spigot / Paper
  • Versions: 1.13+
  • Compiled against: Spigot API 1.21.5
  • Java: Java 11+
  • Velocity: Not supported

💡 Why CraftersBan?

CraftersBan is built for servers that want moderation tools to feel consistent and easy to use under pressure. Whether staff need to issue a fast punishment, review a player's full history, investigate linked accounts, or temporarily lock down the server, the plugin keeps everything in one focused system.

The goal is simple: reduce staff friction, improve consistency, and make punishment management easier to control as your server grows.


Developed by xUnknowns | Documentation: https://craftersdevelopment.pages.dev/

License & Intellectual Property

© 2026 Crafters Development. All rights reserved.

Redistribution, copying, or modification of this software is prohibited without the express permission of Crafters Development. This code is intellectual property protected by Chilean Intellectual Property Law 17.336.

[!IMPORTANT] Redistribution Clarification: The prohibition on redistribution applies strictly to hosting or uploading the software to external download websites or unauthorized third-party platforms.

This restriction DOES NOT apply to sharing information, screenshots, or official links through:

  • Messaging Apps: Discord, WhatsApp, Telegram, etc.
  • Social Media: Twitter (X), Facebook, etc.
  • Community Groups: Private server chats or staff groups.

Ченджлог

2.1Релиз1.21.3, 1.21.4, 1.21.5 · 4 июля 2026 г.

🚀 CraftersBan v2.1

CraftersBan v2.1 brings a significant architectural overhaul aimed at improving performance, scalability, and the administrator experience. This update focuses on intelligent command processing, fully unified punishment tracking, and robust cross-platform text formatting, ensuring zero performance impact on high-traffic networks.


✨ Key Features & Improvements

  • 🧠 Intelligent Command Unification The entire punishment command structure has been streamlined for maximum efficiency. The system now features a smart parser that automatically distinguishes between duration arguments and reasoning. Obsolete "temp" commands have been removed entirely in favor of a unified system.
  • 🗃️ Native Database ID Isolation The internal tracking of punishments has been architecturally split. Temporary and permanent actions now inherently use completely isolated identification pools, ensuring pristine sequential tracking for audits and scalability.
  • 🎨 Advanced Formatting Engine The core text processor has been upgraded to natively support and seamlessly convert multiple aesthetic formats simultaneously. Administrators can now mix legacy color codes, modern Hex combinations, gradients, external forum tags (BBCode), and raw JSON objects without breaking the server connection.
  • ⏱️ Dynamic Duration Injection Punishment notifications now dynamically inject precisely calculated duration formatting based on whether the action is temporary or permanent, directly in their notification messages.
  • ⚡ Zero-Impact Asynchronous Architecture All heavy data operations, including lookups and punishment registrations, have been offloaded to dedicated background threads to preserve flawless gameplay.
  • 🛡️ Silent Configuration Fallbacks & Fixes The configuration core has been hardened to inject default values silently into memory when outdated configurations are detected, preventing harmless missing keys from generating unnecessary warning spam in the server console. Geolocation mapping has also been perfected.

📋 Modernized Command Reference

The command suite has been purified. All commands are smart and automatically adapt based on your input:

  • /ban [-s] <player> [duration] [reason] — Bans a player
  • /ipban [-s] <player|IP> [duration] [reason] — IP bans a connection
  • /mute [-s] <player> [duration] [reason] — Mutes a player
  • /ipmute [-s] <player|IP> [duration] [reason] — IP mutes a connection
  • /warn [-s] <player> [duration] [reason] — Warns a player
  • (Plus all standard history, unpunish, and administrative commands...)

🗂️ Upgrade Guidelines

For network administrators upgrading to v2.1:

  1. Ensure the server is completely shut down.
  2. Create a full backup of your existing plugin directory.
  3. Deploy the new plugin version.
  4. Relocate or archive the old configuration files to allow the system to generate the new, modernized architecture templates upon startup.
  5. Manually transfer your preferred customizations into the newly generated templates.

⚠️ IMPORTANT NOTICE! To install version v2.1, you must delete the craftersban.db file (or empty your SQL tables) so that the new independent ID system is generated cleanly from scratch.

1.9Релиз1.21.3, 1.21.4, 1.21.5 · 16 апреля 2026 г.

CraftersBan v1.9 — Message System & Proxy Improvements


🔧 Changes

  • Removed plugin prefix from all formatted display messages (warn, history, banlist, etc.).
  • Prefix now appears only on notification messages, not on headers, footers or list entries.
  • Translated all help messages to Spanish.
  • Removed duplicate Permissions: line from help output.
  • Code cleanup: removed unused imports and variables across 14 files.

Affected commands:

  • /history, /warn, /banlist, /mutelist, /warnlist
  • /checkban, /checkmute, /checkwarn
  • /alts, /geoip
  • /craftersban help

🌐 Proxy Improvements

  • Added kick-screen templates to proxy-config.yml.
  • Proxy now blocks banned players before they connect to backend servers,
  • Added ban cache system in the proxy for instant ban checks.
  • Full proxy ban enforcement support for BungeeCord, Waterfall and Velocity.
1.5Релиз1.20.3, 1.20.4, 1.20.5 · 1 апреля 2026 г.

CraftersBan — Full Network Support & Universal JAR


🌐 Network Support (BungeeCord, Waterfall & Velocity)

CraftersBan now ships as a single universal JAR that automatically detects the environment it runs in — whether it's a standalone Spigot server or a proxy — eliminating the need to install separate versions for each platform.

Supported proxy platforms:

  • BungeeCord
  • Waterfall
  • Velocity

🆕 What's New

Universal JAR & Auto-Detection

  • A single JAR file now covers all platforms: Spigot, BungeeCord, Waterfall and Velocity.
  • The plugin automatically detects its runtime environment on startup and loads the appropriate modules.

Network-Wide Punishment Sync

  • Punishments are synchronized across all servers through a shared database.
  • A ban applied on one server is automatically enforced across the entire network in real time.

Network-Wide Punishment Broadcasting

  • Staff members on any server are notified in real time whenever a punishment is applied or revoked anywhere on the network.

Network Lockdown

  • Lockdown mode now operates at the network level.
  • A single command blocks access to all servers on the network simultaneously.

New proxy-config.yml

  • Dedicated configuration file for proxy environments.
  • Controls messaging channels, target servers and other proxy-specific behavior.

Simplified Database Support

  • Removed support for PostgreSQL, MariaDB and SQLite.
  • Supported databases are now H2 (local mode) and MySQL (network mode) only.
  • This simplifies maintenance and reduces the final JAR size.

Independent ID System per Sanction Type

  • Each sanction type (ban, mute, warn, kick, etc.) now has its own independent ID counter starting from 1.
  • Makes it easier to identify and manage sanctions without confusion between types.

Warnings Are Now Permanent

  • Warnings (warn) no longer support temporary durations.
  • All warnings are permanent until manually revoked by a staff member.

🗄️ Database Overview

Mode Database
Local (single server) H2
Network (multi-server) MySQL

These changes lay the foundation for CraftersBan to operate reliably in production network environments, with a focus on consistency, simplicity and real-time coordination across servers.

Комментарии

Загружаем…