Empezar

Primeros pasos

Date un objeto incluido, cambia sus números dentro del juego, reparte objetos a los jugadores y escribe tu primer objeto.

Esta página lleva una instalación recién hecha a un objeto funcionando en pocos minutos. Da por hecho que el plugin arrancó sin errores — ver Instalación.

Prueba un objeto incluido

Abre el menú de administración

Ejecuta /specialsadmin como operador. La pantalla principal tiene siete botones: Objetos especiales, Herramientas, Trackers, Arenas de duelo, Tus cooldowns, Ajustes y Recargar.

Coge un objeto

Abre Objetos especiales y haz clic izquierdo en Congelar. Llega a tu inventario con 3 usos, que se ven en su nombre como [3/3].

Úsalo

Ponte cerca de otro jugador y haz clic derecho. Todos los que estén a 5 bloques o menos quedan congelados 3 segundos, se gasta un uso y empieza un cooldown de 30 segundos, que se ve en la barra de acción. Si no hay nadie cerca, el objeto lo dice y no se gasta nada.

Cambia sus números

Haz clic derecho en Congelar en la lista de objetos. La pantalla del objeto muestra su límite, su cooldown y sus features, y un botón de ajustes. Abre un formulario con cada valor que expone el objeto — cooldown, usos, radio, segundos congelado — cada uno comprobado contra su mínimo y su máximo. Guarda, y el archivo del objeto se reescribe y los objetos se recargan. El lore sigue a los números: el lore de un objeto se construye con los mismos valores que lee su habilidad.

Los objetos que ya tienen los jugadores siguen los valores nuevos al momento. Solo el número de usos con el que empezó un objeto se queda como estaba: un valor nuevo de uses se aplica a los objetos que se den a partir de entonces.

Reparte objetos a los jugadores

/specialsadmin give item freeze Steve          un congelar, con sus usos por defecto
/specialsadmin give item freeze Steve 5        cinco
/specialsadmin give item freeze Steve 1 USES 10   uno, con 10 usos
/specialsadmin give item freeze Steve 1 TIMED 3600  uno que caduca en una hora
/specialsadmin giveall item freeze             uno para cada jugador conectado

La consola puede ejecutar todos, que es lo que debería llamar una tienda o una caja. Con el inventario lleno no se pierde el objeto: espera y se entrega cuando el jugador vuelve a conectarse. Ver Comandos.

Escribe tu propio objeto

Crea plugins/ExyliaSpecials/lang/en/items/lightning_rod.yml (usa la carpeta de tu idioma):

settings:
  cooldown: {value: 20, min: 1, max: 300, name: 'Cooldown (seconds)'}
  damage: {value: 6, min: 1, max: 20, name: 'Damage'}
 
item:
  material: LIGHTNING_ROD
  name: '{primary}&lLIGHTNING ROD &8[{success}%uses%&8/{warning}%max_uses%&8]'
  display-name: '{primary}LIGHTNING ROD'
  lore:
    - ''
    - '{letters}Strikes the player you look at'
    - '{letters}for {info}${damage} {letters}damage.'
    - ''
  glow: true
  max-stack-size: 1
 
limit:
  type: USES
  amount: 5
 
cooldown:
  seconds: '${cooldown}'
 
features:
  - type: ability
    trigger: RIGHT_CLICK
    actions:
      - action: target_look
        range: 30
      - action: require
        check: '%targets_found% >= 1'
        message: '%prefix% {error}Look at a player first.'
      - action: damage
        damage: '${damage}'
      - action: play
        at: targets
        effects:
          - '[LIGHTNING]'

Ejecuta /specialsadmin reload y luego /specialsadmin give item lightning_rod. Haz clic derecho mirando a un jugador: recibe 6 de daño bajo un rayo, se gasta un uso y empieza el cooldown. Si no miras a nadie, el paso require detiene la cadena — no se gasta nada.

El formato del archivo está en Objetos especiales, cada paso en Lenguaje de acciones, y los 70 archivos incluidos son los mejores ejemplos que hay: ver Objetos incluidos.

Mira cómo leen los objetos el combat tag, ahora en ExyliaCombat: Combate.
Ajusta los cooldowns de los objetos especiales y la barra de acción: Cooldowns.
Construye una arena para el objeto 1v1: Duelos.

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