🛡️ 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 in plugins/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) en plugins/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.