Empezar

Introducción

Qué es ExyliaMines, los dos tipos de mina que gestiona y cómo está organizada esta documentación.

ExyliaMines gestiona las minas de un servidor: zonas que los jugadores pican para sacar recursos y que vuelven solas. Todo lo que define una mina —dónde está, de qué está hecha, cuándo se rellena, qué paga— se crea y se edita dentro del juego desde un menú. No hay ningún archivo de minas que escribir a mano.

Es gratuito y de código abierto, publicado bajo la licencia GPL-3.0 y se descarga desde las releases de GitHub. Las minas vivían antes dentro de ExyliaSurvivalCore; ahora son un plugin propio, y un servidor que viene de allí recupera solo sus minas, ajustes, mensajes e historial de minería. Ver Migración.

Dos tipos de mina

Tipo	Cómo vuelve
Clásica	Toda el área se rellena de golpe a partir de una composición ponderada de bloques: con un temporizador, cuando se ha picado cierta proporción o cuando un admin lo fuerza. Los jugadores de dentro reciben un aviso antes y se les aparta de los bloques nuevos.
Realista	Nada se rellena. Cada bloque que el jugador rompe vuelve a crecer por su cuenta tras el tiempo de regeneración de su nivel, pasando opcionalmente por una cadena de degradación —piedra, luego roca, luego otra vez el mineral— que el jugador va picando.

Los dos tipos comparten todo lo demás: un permiso, autorrecogida, botín propio por bloque, efectos al romper, efectos de poción para quien está dentro, premios de suerte, reglas de Fortune, potenciadores, un holograma y el menú /mines de los jugadores.

Qué incluye

Minas clásicas

Una composición ponderada, un intervalo, un aviso, un umbral de vaciado, un teletransporte seguro y jugadores enterrados que se sacan al aire libre. El punto del ciclo de cada mina sobrevive a un reinicio.

Minas realistas

Niveles con su propio tiempo de regeneración, cadenas de degradación que se pican etapa a etapa y bloques rotos que se curan tras un reinicio.

Área y formas

Cubo, esfera o cilindro, recortados de la caja que selecciones. Ni explosiones, ni pistones, ni fluidos, ni bloques colocados pueden explotar una mina.

Botín y efectos

Botín de objetos, dinero y comandos por bloque en lugar del drop vanilla, sonidos y partículas por mina o por bloque, y efectos de poción dentro.

Premios de suerte y potenciadores

Premios raros que puede dar cualquier bloque, y multiplicadores temporales de drops, experiencia y dinero que se lanzan por comando o con un horario semanal.

Estadísticas

Bloques picados por jugador y por mina, un top diez por mina, todo legible con placeholders.

Requisitos

Requisito	Detalle
Servidor	Paper 1.21 o superior, o un fork suyo. Folia soportado. Spigot no: el plugin usa la API de Paper.
Java	21
Dependencias obligatorias	`packetevents`, y `ExyliaLib` 1.230.0 o superior — se instala sola si falta
Dependencias opcionales	`ExyliaSurvivalCore`, `PlaceholderAPI`, `Vault`, `Worlds` o `Multiverse-Core`

Sobre ExyliaLib

La configuración tipada, los menús, la base de datos, las regiones y el selector de bloques, los hologramas, las tablas de botín, las secuencias de efectos, los horarios, los teletransportes y la comprobación de actualizaciones vienen de ExyliaLib. ExyliaMines está escrito sobre ella y no funciona sin ella, por eso descarga la librería por su cuenta en un servidor que no la tiene. Ver Instalación.

Cómo leer esta documentación

Empezar

La instalación, y después una primera mina clásica y una primera mina realista en pocos minutos.

Configurar

Las pantallas de configuración, cada tipo de mina, el área, el botín y los efectos, Fortune, los premios de suerte y los potenciadores.

Sistemas

Hologramas, el menú de jugadores, estadísticas, lo que aportan otros plugins y cómo traer minas desde ExyliaSurvivalCore, CataMines o RealMines.

Referencia

Comandos, permisos, placeholders, cada clave de configuración, la API para desarrolladores y las preguntas más frecuentes.

Convenciones

Los valores marcados como por defecto son lo que el plugin escribe la primera vez que arranca. Si el archivo ya existe, se respeta tu valor.
Los identificadores entre < y > son variables. /mine <id> significa /mine coal, no /mine <coal>.
Una duración acepta un número de segundos o la forma escrita: 300, 5m y 1h30m funcionan, tanto en los archivos como en las preguntas del chat.
Los colores usan los tokens de paleta de ExyliaLib ({primary}, {highlight}, {muted}); las etiquetas MiniMessage como <click> y <hover> también funcionan, como muestra el anuncio de reinicio por defecto.

¿Falta algo en esta página? Dínoslo en Discord