zNClans

# zNClans

**Plugin avanzado de clanes para Paper/Spigot 1.20.x**

Un sistema de clanes completo, moderno y listo para producción, pensado para servidores que quieren algo más que el típico plugin básico de clanes.

## Dependencias
- Vault
- PlaceHolderAPI

---

## ¿Qué incluye?

### Gestión de clanes
- Crear, disolver y renombrar clanes (nombre + tag)
- Sistema de invitaciones con `invite` / `accept` / `deny`
- Rangos: **Líder**, **Oficial** y **Miembro** (`promote`, `demote`, `transfer`)
- Expulsión de miembros
- Descripción del clan editable

### Comunicación y utilidad
- Chat de clan con toggle (`/clan chat`) o prefijo rápido `!mensaje`
- Home de clan + **múltiples warps** (`setwarp`, `warp`, `delwarp`, `warps`)
- Tab-completion en todos los subcomandos

### Progresión y economía
- Sistema de puntos y **ranking** (`/clan top`)
- **Niveles de clan** que suben según los puntos acumulados
- **Banco virtual** del clan (`deposit`, `withdraw`, `balance`)

### Relaciones entre clanes
- Alianzas y enemigos (`ally` / `unally` / `enemy` / `unenemy`)

### Clan Premium (sistema exclusivo)
- Personalización avanzada del tag: insignias (dragón, corona, fuego, diamante, etc.) + color (hex sólido, gradiente o códigos `&`)
- Se desbloquea de forma permanente usando el ítem físico **“✦ Clan Premium”** (los admins lo dan con `/clan giveitem`)
- Menú visual de personalización (`/clan premium`)

### Interfaz gráfica completa
- Menú principal con información del clan (nivel, banco, aliados/enemigos)
- Lista de miembros con gestión directa (ascender, descender, expulsar)
- Acceso rápido a home, invitar jugadores, abandonar o disolver

### Técnico
- Persistencia en `clans.yml` con autoguardado configurable
- Permisos claros: `clans.use` (por defecto true) y `clans.admin`
- Código limpio y organizado, compatible con Paper/Spigot 1.20.x

---

## Ventajas frente a otros plugins de clanes

- **Todo en uno**: no necesitas combinar varios plugins para tener banco, niveles, warps, alianzas y personalización de tags.
- Sistema Premium elegante y no invasivo (se desbloquea con un ítem físico).
- GUI moderna e intuitiva que reduce la dependencia de comandos.
- Ligero y fácil de configurar.
- Preparado para crecer (fácil de extender con Vault, MySQL, claims, etc.).

Ideal para servidores survival, factions, skyblock o cualquier modo donde los clanes sean el centro de la comunidad.

---

**Comandos principales:** `/clan create`, `/clan gui`, `/clan premium`, `/clan bank`, `/clan top`, `/clan ally`… y muchos más.