Introducción
Qué es ExyliaSpecials, qué cubre, qué necesita para funcionar y cómo está organizada esta documentación.
ExyliaSpecials es un plugin de objetos especiales: objetos que hacen algo cuando un jugador hace clic derecho, golpea, come, lanza, se agacha, rompe un bloque o simplemente los lleva encima. Un congelar que deja quietos a todos los que tienes alrededor, un pico que mina 3×3, un compresor que convierte minerales en bloques desde cualquier sitio del inventario, un bardo invocado que te da mejoras, un objeto que arrastra al jugador que golpeas a un 1v1.
Cada objeto es un archivo YAML. Su comportamiento es una lista de features: una habilidad es una cadena de pasos escrita en el lenguaje de acciones del propio plugin (apuntar, dañar, empujar, dar un estado, colocar bloques temporales, invocar, empezar un duelo...), y una feature de herramienta es un comportamiento ya hecho con unas pocas claves (romper en área, minar vetas, talar árboles, fundido automático, compresor...). Vienen 70 objetos listos para usar, y cada número de ellos se puede cambiar desde un formulario dentro del juego.
Alrededor de los objetos el plugin trae contadores de estadísticas que cuentan kills o bloques en cualquier objeto, y arenas de duelo para los objetos que empiezan una pelea. El combat tag y los cooldowns de objetos vanilla viven en ExyliaCombat; los objetos leen el combate del plugin de combate que esté instalado.
Es un plugin premium, a la venta en BuiltByBit e instalado a través de un cargador de licencias.
Qué incluye
Un archivo por objeto: el objeto en sí, ajustes editables en el juego, límites por usos o por tiempo, cooldowns, reglas de región y las features que se ejecutan con cada trigger.
Lenguaje de accionesCuarenta pasos para apuntar a jugadores, hacer daño, moverlos, dar efectos y estados, colocar bloques, invocar aliados y empezar duelos.
Objetos incluidosLos 70 objetos que vienen con el plugin, qué hace cada uno y qué ajustes expone.
HerramientasQuince comportamientos de herramienta: romper en área, minar vetas, talar árboles, replantar, arar, compresores, filtro del vacío, cubos infinitos, imán, telequinesis y más.
Contadores de estadísticasObjetos que, al hacer clic con ellos sobre una espada, un pico o una caña, cuentan en ella kills, bloques, flechas, daño o peces.
Combate, cooldowns y duelosCómo leen los objetos el combat tag, los cooldowns de los objetos especiales y las arenas de duelo.
Requisitos
| Requisito | Detalle |
|---|---|
| Servidor | Paper 1.21.1 o superior, o un fork suyo; Folia 1.21.4 o superior. Los cuerpos de maniquí de las invocaciones necesitan 1.21.9 y, antes, usan su entidad fallback. |
| Java | 21 |
| Dependencias obligatorias | packetevents, y ExyliaLib 1.448.0 o superior — se instala sola si falta |
| Dependencias opcionales | WorldGuard, PlaceholderAPI, ExyliaCombat, DeluxeCombat o PvPManager, ExyliaMines, FastAsyncWorldEdit |
La configuración y las traducciones, las plantillas de objetos, las líneas de efectos que reproduce cada habilidad, los menús, las regiones de las arenas de duelo, la base de datos y la visualización de cooldowns en clientes Lunar y Feather vienen de ExyliaLib. ExyliaSpecials está escrito encima de ella y no funciona sin ella; por eso el cargador la instala en un servidor que no la tiene.
Cómo funciona un objeto, en un párrafo
Un jugador usa un objeto. El plugin busca las features de ese objeto ligadas a lo que acaba de pasar — un clic derecho, un golpe, agacharse — y las comprueba en un orden fijo: silenciado, permiso, región, combo, cooldown, usos o caducidad. Si pasan, la feature se ejecuta; si ha hecho su trabajo, empieza el cooldown del objeto y se gasta un uso. Cuando se gasta el último uso, el objeto desaparece. Cada número del lore del objeto sale de los mismos valores que lee la feature, así que el lore nunca miente sobre el objeto.
Cómo leer esta documentación
Empezar
La instalación, y luego darte un objeto, cambiar un valor dentro del juego y escribir tu primer objeto.
Objetos especiales
El archivo de objeto, el lenguaje de acciones, los estados, cada objeto incluido, las features de herramienta y los contadores de estadísticas.
Sistemas
El combat tag, los cooldowns de los objetos y los duelos.
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 los que el plugin escribe la primera vez que arranca. Si un archivo ya existe, se conservan tus valores.
- Los identificadores entre
<y>son variables./specialsadmin give item <id>significa/specialsadmin give item freeze, no/specialsadmin give item <freeze>. - El id de un objeto es el nombre de su archivo, salvo que el archivo defina
id:. Su nombre visible es como lo llaman los mensajes y los menús. - Los colores usan los tokens de la paleta de ExyliaLib (
{primary},{info},{letters}), y también funcionan los códigos&. - Las duraciones de
config.ymlaceptan un número de segundos o una duración como15so1m30s.
¿Falta algo en esta página? Dínoslo en Discord