# 🛡️ 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 ` ### 🗡️ 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 ` | Invite a player to join your clan | | `/clan accept ` | Accept a pending clan invitation | | `/clan deny ` | Decline a pending clan invitation | | `/clan invites` | View your pending invites | | `/clan leave` | Leave your current clan | | `/clan kick ` | Kick a member from your clan | | `/clan chat ` | Send a message to private clan chat *(or `/cc`)* | ### 👑 Hierarchy & Customization (Leaders) | Command | Description | | :--- | :--- | | `/clan promote ` | Promote a member to **Officer** | | `/clan demote ` | Demote an officer to **Member** | | `/clan transfer ` | 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 ` | Send or accept an alliance request | | `/clan enemy ` | Declare or remove an enemy clan | | `/clan info [clan]` | View clan stats, members, founded date, and relations | | `/clan who ` | 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 ` | Force disband any clan *(Admin)* | --- ## 🧩 PlaceholderAPI Placeholders Identifier: `%aleclans_%` | 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 ` ### 🗡️ 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 ` | Invita a un jugador a tu clan | | `/clan accept ` | Acepta una invitación pendiente | | `/clan deny ` | Rechaza una invitación de clan | | `/clan invites` | Consulta tus invitaciones pendientes | | `/clan leave` | Abandona tu clan actual | | `/clan kick ` | Expulsa a un miembro del clan | | `/clan chat ` | Envía un mensaje al chat privado *(o `/cc`)* | ### 👑 Jerarquía y Personalización (Líderes) | Comando | Descripción | | :--- | :--- | | `/clan promote ` | Asciende a un miembro a **Oficial** | | `/clan demote ` | Degrada a un oficial a **Miembro** | | `/clan transfer ` | 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 ` | Solicita o acepta una alianza con otro clan | | `/clan enemy ` | Declara o retira la enemistad hacia un clan | | `/clan info [clan]` | Muestra detalles, estadísticas, miembros y relaciones | | `/clan who ` | 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 ` | Fuerza la disolución de un clan *(Admin)* | --- ## 🧩 Placeholders de PlaceholderAPI Identificador: `%aleclans_%` | 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.

Ale_256

Organizations