🛡️ AleClans
A modern, ultra-lightweight, and zero-interference clan management plugin for Minecraft.
Built for high-performance servers from 1.16 all the way to 1.21.x+
🌐 Language / Idioma
- 🇬🇧 English Version
- 🇪🇸 Versión en Español más abajo
🇬🇧 English
✨ Why AleClans?
Many clan plugins take over your chat, break your tablist, or bloat your server with heavy dependencies. AleClans is built differently:
- ⚡ Zero Interference: Does NOT force chat formatting, nametags, or tab prefixes. It provides full PlaceholderAPI support so you can customize everything using your favorite chat and tab plugins (e.g., TAB, EssentialsX, LPC).
- 🚀 High Performance & Async: Built from scratch with pure Bukkit API (no NMS). All database operations (SQLite/MySQL) run asynchronously.
- 🛡️ Complete Clan Hierarchy: Leader, Officer, and Member ranks with intuitive management.
- 🤝 Diplomacy System: Form alliances or declare rivalries with other clans.
- ⚔️ PvP Stats & Leaderboards: Track clan kills, deaths, and KDR with built-in top rankings.
- 🔒 Safe Actions & Anti-Spam: 30-second confirmation prompt for destructive actions (disband/kick) and configurable cooldowns.
⚡ Command Quick-Guide
Aliases:
/clan,/aleclans,/clans| Clan Chat Shortcut:/cc <message>
🗡️ Member & Clan Management
| Command | Description |
|---|---|
/clan create <"Name"> <"Tag"> |
Create a new clan (supports spaces with quotes) |
/clan disband |
Disband your clan (requires confirmation) |
/clan invite <player> |
Invite a player to join your clan |
/clan accept <clan> |
Accept a pending clan invitation |
/clan deny <clan> |
Decline a pending clan invitation |
/clan invites |
View your pending invites |
/clan leave |
Leave your current clan |
/clan kick <player> |
Kick a member from your clan |
/clan chat <message> |
Send a message to private clan chat (or /cc) |
👑 Hierarchy & Customization (Leaders)
| Command | Description |
|---|---|
/clan promote <player> |
Promote a member to Officer |
/clan demote <player> |
Demote an officer to Member |
/clan transfer <player> |
Transfer clan leadership to another member |
/clan settag <"Tag"> |
Change the clan tag (supports color codes) |
/clan rename <"Name"> |
Rename the clan |
🌐 Diplomacy & Info
| Command | Description |
|---|---|
/clan ally <clan> |
Send or accept an alliance request |
/clan enemy <clan> |
Declare or remove an enemy clan |
/clan info [clan] |
View clan stats, members, founded date, and relations |
/clan who <player> |
Check which clan a player belongs to |
/clan list [page] |
Paginated list of all server clans |
/clan top |
Top 10 clans ranked by PvP kills and members |
/clan reload |
Reload configuration and translations (Admin) |
/clan admin disband <clan> |
Force disband any clan (Admin) |
🧩 PlaceholderAPI Placeholders
Identifier: %aleclans_<placeholder>%
| Placeholder | Description |
|---|---|
%aleclans_has_clan% |
Returns true or false |
%aleclans_clan_name% |
Clan name (empty if no clan) |
%aleclans_clan_tag% |
Clan tag (empty if no clan) |
%aleclans_clan_leader% |
Clan leader's username |
%aleclans_clan_role% |
Player rank (Leader, Officer, Member) |
%aleclans_clan_members_count% |
Current member count |
%aleclans_clan_members_max% |
Maximum members allowed |
%aleclans_clan_created_date% |
Clan foundation date |
%aleclans_clan_kills% |
Total PvP kills by clan members |
%aleclans_clan_deaths% |
Total PvP deaths by clan members |
%aleclans_clan_kdr% |
Clan Kill/Death Ratio |
⚙️ Configuration & Storage
- Storage Options: Zero-setup SQLite (
clans.db) by default or MySQL with connection pooling. - Languages Included: English (
en.yml) and Spanish (es.yml) auto-generated inplugins/AleClans/translations/. - Protections: Configurable character limits, regex filters, and a forbidden word blacklist.
- Economy (Optional): Optional Vault integration for clan creation/rename costs.
🇪🇸 Español
✨ ¿Por qué AleClans?
Muchos plugins de clanes interfieren con el chat, rompen el tablist o sobrecargan el servidor. AleClans está diseñado para ser limpio y eficiente:
- ⚡ Cero Interferencia: NO modifica a la fuerza el chat, nametags ni tablist. Ofrece soporte completo para PlaceholderAPI para que personalices tu servidor con tus plugins favoritos (TAB, EssentialsX, LPC, etc.).
- 🚀 Alto Rendimiento y Asíncrono: Desarrollado con Bukkit API pura (sin NMS). Compatible desde la 1.16 hasta la 1.21.x+. Base de datos totalmente asíncrona.
- 🛡️ Jerarquía Completa: Rangos de Líder, Oficial y Miembro con gestión intuitiva.
- 🤝 Diplomacia: Sistema de alianzas y enemistades entre clanes.
- ⚔️ Estadísticas PvP y Tops: Registro de bajas, muertes y KDR con ranking
/clan top. - 🔒 Seguridad y Anti-Spam: Confirmación obligatoria de 30 segundos para acciones destructivas (
disband/kick) y cooldowns configurables.
⚡ Guía Rápida de Comandos
Alias:
/clan,/aleclans,/clans| Acceso Rápido al Chat de Clan:/cc <mensaje>
🗡️ Gestión de Miembros y Clan
| Comando | Descripción |
|---|---|
/clan create <"Nombre"> <"Tag"> |
Crea un clan (permite espacios con comillas) |
/clan disband |
Disuelve tu clan (requiere confirmación) |
/clan invite <jugador> |
Invita a un jugador a tu clan |
/clan accept <clan> |
Acepta una invitación pendiente |
/clan deny <clan> |
Rechaza una invitación de clan |
/clan invites |
Consulta tus invitaciones pendientes |
/clan leave |
Abandona tu clan actual |
/clan kick <jugador> |
Expulsa a un miembro del clan |
/clan chat <mensaje> |
Envía un mensaje al chat privado (o /cc) |
👑 Jerarquía y Personalización (Líderes)
| Comando | Descripción |
|---|---|
/clan promote <jugador> |
Asciende a un miembro a Oficial |
/clan demote <jugador> |
Degrada a un oficial a Miembro |
/clan transfer <jugador> |
Transfiere el liderazgo del clan |
/clan settag <"Tag"> |
Cambia el tag del clan (soporta colores) |
/clan rename <"Nombre"> |
Cambia el nombre del clan |
🌐 Diplomacia e Información
| Comando | Descripción |
|---|---|
/clan ally <clan> |
Solicita o acepta una alianza con otro clan |
/clan enemy <clan> |
Declara o retira la enemistad hacia un clan |
/clan info [clan] |
Muestra detalles, estadísticas, miembros y relaciones |
/clan who <jugador> |
Consulta a qué clan pertenece un jugador |
/clan list [página] |
Lista paginada de todos los clanes |
/clan top |
Top 10 de clanes por bajas PvP y miembros |
/clan reload |
Recarga configuración y traducciones (Admin) |
/clan admin disband <clan> |
Fuerza la disolución de un clan (Admin) |
🧩 Placeholders de PlaceholderAPI
Identificador: %aleclans_<placeholder>%
| Placeholder | Descripción |
|---|---|
%aleclans_has_clan% |
Devuelve true o false |
%aleclans_clan_name% |
Nombre del clan (vacío si no tiene) |
%aleclans_clan_tag% |
Tag del clan (vacío si no tiene) |
%aleclans_clan_leader% |
Nombre del líder del clan |
%aleclans_clan_role% |
Rango del jugador (Leader, Officer, Member) |
%aleclans_clan_members_count% |
Cantidad de miembros actuales |
%aleclans_clan_members_max% |
Límite máximo de miembros permitido |
%aleclans_clan_created_date% |
Fecha de creación del clan |
%aleclans_clan_kills% |
Bajas PvP totales acumuladas por el clan |
%aleclans_clan_deaths% |
Muertes PvP totales del clan |
%aleclans_clan_kdr% |
Ratio KDR (Kills/Deaths) del clan |
⚙️ Configuración y Almacenamiento
- Opciones de Base de Datos: SQLite (
clans.db) por defecto sin configuración previa, o MySQL con pool HikariCP. - Idiomas Incluidos: Inglés (
en.yml) y Español (es.yml) enplugins/AleClans/translations/. - Protecciones: Límites de caracteres configurables, validación por regex y lista negra de palabras prohibidas.
- Economía Opcional: Soporte opcional con Vault para costos de creación y cambios de tag/nombre.
No gallery available for this project.