# MIRATH - Plugin Medieval para Minecraft (Spigot/Paper 1.20.x)
## Resumen
Mirath es un plugin integral para servidores medievales con economía avanzada, reinos y ciudades con rangos y permisos, gremios con misiones y mobs personalizados, subastas, religión con zonas sagradas, duelos, paneles GUI completos, integración con Discord y Dynmap, y sistema de expansión por chunks ligado a una economía del reino. Todo es configurable y multilenguaje.
## Requisitos
- Spigot/Paper 1.20.x
- Java 17
## Instalación
1. Coloca Mirath-<version>.jar en la carpeta plugins.
2. Inicia el servidor para generar la carpeta plugins/Mirath.
3. Configura `plugins/Mirath/config.yml` y los idiomas en `plugins/Mirath/lang/`.
4. Reinicia o usa `/mirath reload`.
## Multilenguaje
- Directorio: `plugins/Mirath/lang/`
- Idiomas incluidos: `es_ES.yml` (por defecto), `en_US.yml`, `pt_BR.yml`
- Cambia `config.yml -> language: es_ES | en_US | pt_BR`
- Todos los mensajes y textos de menús se cargan desde el idioma activo.
## Paneles GUI Unificados
- Menú principal: `/mirath` → accesos a Economía, Reinos, Ciudades, Religión, Trabajos, Subastas.
- Menús por sistema con navegación: iconos, páginas, búsqueda y confirmaciones.
## Economía General de Jugador
- Saldo por jugador, saldo inicial configurable.
- Subastas globales en menú con filtros, pujas y compra inmediata.
- Soporte de impuestos del reino aplicados a transacciones del jugador.
## Economía del Reino (Tesoro)
- Tesoro del reino distinto al saldo del jugador.
- Tienda del reino: vender objetos (bloques, drops, armas, etc.) con límite por ítem (máx. 10.000).
- Precios configurables por ítem, con límites globales y por categoría.
- Ingresos van al tesoro, usados para expansión y mantenimiento.
## Reinos Avanzados
- Creación de reinos y ciudades (ciudades se gestionan dentro de reinos).
- Rangos del reino: Rey/Líder, Noble, Caballero, Ciudadano (configurables y ampliables).
- Permisos por rango: romper/colocar dentro de territorio, abrir cofres, usar hornos, gestionar tienda, invitar/expulsar, declarar guerra/alianza, gestionar impuestos, gestionar gremios.
- Impuestos del reino: por miembro, porcentaje sobre ventas en tienda, configurable.
- Tienda del reino con categorías, compra/venta y control de stock.
- Expansión por chunks: reino inicia con 4 chunks; cada 100.000 del tesoro compra 1 chunk extra; cada 5 chunks comprados el coste sube +50.000, hasta tope entre 1.000.000 y 2.000.000 (configurable). Menú para ampliar: confirmación y resumen de costos.
- Alianzas y Guerras: sistema para proponer, aceptar y romper; efectos en PvP/duelos y territorios.
- Duelos y Arenas: crear zonas con herramienta (pala de oro) para delimitar arenas, colas de duelo y registro de resultados.
## Ciudades (dentro de Reinos)
- Creación, info y administración desde el menú de Reinos.
- Permisos locales por ciudad (sub-rangos) y roles de alcaldía.
- Expansión por chunks siguiendo reglas del reino o específicas por ciudad.
## Gremios
- Tipos: Aventureros, Alquimistas, Mercenarios (ampliables por config).
- Menú `/reino gremio <tipo>`: unirse, ver contratos, aceptar misiones, progreso y recompensas.
- Misiones autogeneradas: exterminar mobs, recolección, entrega de ítems, cacería de élites.
- Spawns de misión: aparecen a 500-1000 bloques del jugador más cercano, nunca a <300.
- Recompensas: monedas, reputación de gremio, objetos especiales.
## Mobs Personalizados
- Definidos en `config.yml`: stats (vida, daño, resistencia, velocidad), loot tables, raridad, efectos.
- Etiquetas y habilidades especiales (sangrado, veneno, empuje, grito).
- Usados por misiones y eventos de gremio.
## Religión e Iglesias
- Menú de religiones: listar, detalles, seguidores, beneficios.
- Creación de religión: solo Rey/Líder del reino.
- Herramienta de selección (pala de oro): seleccionar área 20x20 (altura infinita) para iglesia/templo.
- Zonas sagradas: buffs/debuffs configurables dentro de la zona, integradas a Dynmap.
- Subastas religiosas: objetos sagrados, reliquias, ofrendas.
## Subastas (Economía y Religión)
- Menú unificado de subastas con pestañas por categoría.
- Pujas, compra inmediata, anti-sniping, historial, tasas configurables.
## Dynmap (Opcional)
- Si está instalado, renderiza capas: límites de reinos, ciudades, iglesias y arenas.
- Popups con información: nombre, líder, impuestos, aliados/enemigos.
## Comandos (Juego)
- `/mirath` → Menú principal
- `/economia` (alias `/eco`)
- `ver <jugador>`
- `dar <jugador> <monto>`
- `quitar <jugador> <monto>`
- `/reino`
- `crear <nombre>`
- `info <nombre>`
- `invitar <jugador>`
- `setcapital`
- `menu` → Menú de gestión
- `ampliar` → Comprar chunk extra (según reglas)
- `gremio <tipo>` → Abrir menú de gremio
- `alianza <reino> <proponer|aceptar|romper>`
- `guerra <reino> <declarar|paz>`
- `duelo <reino>`
- `arena <crear|borrar|listar>`
- `/ciudad` (gestionado dentro del menú de reinos)
- `/religion` (alias `/faith`)
- `crear <nombre>` (solo Rey/Líder)
- `menu` → Menú de religiones
- `/trabajo` (alias `/jobs`)
- `menu` → Menú de trabajos
- `set <oficio>`
## Trabajos Disponibles
- Minero, Leñador, Granjero, Pescador, Cazador, Herrero, Alquimista, Explorador, Cantero, Carpintero.
- Cada trabajo con acciones recompensadas y progresión configurable.
## Permisos
- `mirath.admin` → administración general
- `mirath.economia.use`
- `mirath.reinos.use`
- `mirath.ciudades.use`
- `mirath.religion.use`
- `mirath.trabajos.use`
- Permisos avanzados por rango del reino son internos al sistema de rangos.
## Placeholders (Mensajes)
{player}, {target}, {amount}, {kingdom}, {city}, {religion}, {version}, {latest}, {guild}, {price}, {chunks}
## Ejemplos de Uso
### Economía y Subastas
- `/economia ver Steve` → Saldo de Steve
- Subasta: listar un ítem desde el menú, establecer precio y duración.
### Reinos y Expansión
- `/reino crear Avalon`
- `/reino menu` → Gestión de rangos, permisos, tienda, impuestos.
- `/reino ampliar` → Compra 1 chunk con fondos del tesoro.
### Gremios y Misiones
- `/reino gremio aventureros` → Unirse, aceptar misión de exterminio.
- Misión genera mobs a 500-1000 bloques; al completar, otorga recompensas.
### Religión e Iglesias
- `/religion crear Solis` (Rey)
- Selecciona 2 puntos con la pala de oro para área 20x20.
## Notas
- Colores con `&` (&0-&f, &l, &n, &o, &r).
- Datos persistentes en la carpeta del plugin.
- Compatible con Dynmap si se instala.
## Créditos
- MushhX