Referencia

Referencia de archivos

Cada clave de holograms.yml y npcs.yml, con su tipo, su valor por defecto y lo que hace.

Los dos archivos tienen un bloque por entrada, con su nombre como clave. Una entrada escrita a mano solo necesita las claves que cambia; todo lo demás toma el valor por defecto que se indica aquí. Ver Editar los archivos para cómo se aplica un guardado.

holograms.yml

plugins/ExyliaDisplays/holograms.yml

holograms:
  spawn:
    enabled: true
    location: {world: world, x: 0.5, y: 66.0, z: 0.5, yaw: 0.0, pitch: 0.0}
    lines:
      - '<size:2><shine>{primary}&lBIENVENIDO'
      - '{letters}al servidor'
    pages: []
    page-interval: 0
    permission: ''
    view-distance: 48.0
    per-player: false
    appearance:
      billboard: CENTER
      alignment: CENTER
      scale-x: 1.0
      scale-y: 1.0
      scale-z: 1.0
      shadow: true
      see-through: false
      line-width: 200
      line-spacing: 0.25
      text-opacity: 255
      default-background: false
      background-color: '#00000000'
      brightness: -1
      glowing: false
    refresh:
      update-interval: 20
      auto-update: true
    click:
      commands: []
      width: 1.5
      cooldown: 500
      hover-scale: 1.08
    visibility:
      mode: all
      shown-to: []
      hidden-from: []
    attach:
      entity: ''
      offset: 0.5

Clave	Tipo	Por defecto	Qué hace
`enabled`	booleano	`true`	`false` lo conserva en el archivo sin mostrarlo.
`location.world`	texto	`world`	El nombre de la carpeta del mundo. Un mundo no cargado se espera.
`location.x` `.y` `.z`	número	`0.5` `100` `0.5`	Dónde queda la línea inferior; las líneas se apilan hacia arriba. Con precisión de 0,001.
`location.yaw`	número	`0`	Hacia dónde mira, con billboard `FIXED`: 0 sur, 90 oeste, 180 norte, -90 este.
`location.pitch`	número	`0`	Cuánto se inclina, con billboard `FIXED`.
`lines`	lista	vacía	La página 1, de arriba abajo, con etiquetas de línea.
`pages`	lista	vacía	Las páginas tras la primera, cada una con `lines` y `click` (una lista de líneas de interacción). Ver Páginas.
`page-interval`	ticks	`0`	La página de cada jugador pasa sola cada esos ticks; 0 nunca.
`permission`	texto	vacío	Solo lo ven los jugadores con él.
`view-distance`	número	`48`	Desde qué distancia se ve, en bloques. 0 o menos se lee como 48.
`per-player`	booleano	`false`	Una copia por espectador. Se activa solo cuando una línea tiene un placeholder.
`appearance.billboard`	`CENTER` `VERTICAL` `HORIZONTAL` `FIXED`	`CENTER`	Cómo se gira hacia el jugador.
`appearance.alignment`	`CENTER` `LEFT` `RIGHT`	`CENTER`	Alineación del texto.
`appearance.scale-x` `-y` `-z`	número	`1.0`	Tamaño en cada eje.
`appearance.shadow`	booleano	`true`	Sombra del texto.
`appearance.see-through`	booleano	`false`	Visible a través de bloques.
`appearance.line-width`	entero	`200`	Píxeles antes de que el cliente parta una línea.
`appearance.line-spacing`	número	`0.25`	Bloques entre líneas.
`appearance.text-opacity`	0–255	`255`	Opacidad del texto.
`appearance.default-background`	booleano	`false`	Usar el fondo del cliente en lugar del color de abajo.
`appearance.background-color`	`#AARRGGBB`	`#00000000`	Fondo; `#00000000` es transparente.
`appearance.brightness`	-1–15	`-1`	Nivel de luz fijo, o -1 para la luz de donde está.
`appearance.glowing`	booleano	`false`	Si brilla. Solo se pone en el archivo.
`refresh.update-interval`	ticks	`20`	Ticks entre refrescos de placeholders. También lee `1s`, `500ms`.
`refresh.auto-update`	booleano	`true`	Si las líneas se refrescan solas. Las líneas sin placeholders nunca lo hacen.
`click.commands`	lista	vacía	Líneas de interacción de la página 1. Vacía: no es clicable.
`click.width`	número	`1.5`	Ancho de la caja de clic; es tan alta como las líneas.
`click.cooldown`	milisegundos	`500`	Espera entre dos clics del mismo jugador. También lee `500ms`, `1s`.
`click.hover-scale`	número	`1.08`	Crecimiento mientras un jugador lo mira; `1` lo desactiva.
`visibility.mode`	`all` `manual`	`all`	`all`: todos menos `hidden-from`. `manual`: solo `shown-to`. Cualquier otra cosa se lee como `all`.
`visibility.shown-to`	lista de UUIDs	vacía	Quién lo ve en `manual`.
`visibility.hidden-from`	lista de UUIDs	vacía	Quién no lo ve en `all`.
`attach.entity`	UUID	vacío	Un jugador o una entidad guardada que lleva encima. Ver Visibilidad y anclaje.
`attach.offset`	número	`0.5`	Altura sobre la entidad.

npcs.yml

plugins/ExyliaDisplays/npcs.yml

npcs:
  guia:
    enabled: true
    location: {world: lobby, x: 0.5, y: 64.0, z: -3.5, yaw: 180.0, pitch: 0.0}
    skin: {type: player, player: Notch, texture: '', signature: ''}
    pose: standing
    scale: 1.0
    glow: '#8a51c4'
    equipment: {hand: DIAMOND_SWORD, head: playerhead-Notch}
    look: {mode: each-viewer, range: 8.0}
    view-distance: 48.0
    permission: ''
    label:
      lines: ['<size:1.2><shine>{primary}&lGUÍA']
      height-offset: 0.25
    linked-hologram: ''
    interactions:
      actions: ['right: [SAY] ¡Hola, %player_name%!;5s']
      permission: ''
      cooldown: 2s
      deny-message: ''
      cooldown-message: ''
      face-clicker: true

Clave	Tipo	Por defecto	Qué hace
`enabled`	booleano	`true`	`false` lo conserva en el archivo sin mostrarlo.
`location`	world, x, y, z, yaw, pitch	`world`, `0.5`, `100`, `0.5`, `0`, `0`	Dónde está y hacia dónde mira. Yaw 0 sur, 90 oeste, 180 norte, -90 este; pitch de -90 a 90.
`skin.type`	`player` `texture` `mirror` `none`	`none`	De dónde sale la skin. Un tipo al que le falta lo que necesita dibuja la skin por defecto.
`skin.player`	texto	vacío	La cuenta, para `player`.
`skin.texture`	texto	vacío	El valor base64 de la textura, para `texture`.
`skin.signature`	texto	vacío	La firma de Mojang de la textura; sin ella el cliente dibuja la skin por defecto.
`pose`	`standing` `sneaking` `lying` `crawling` `spinning`	`standing`	Su postura.
`scale`	número	`1.0`	1 es el tamaño de un jugador; limitado a 0.0625–16.
`glow`	`#RRGGBB`	vacío	Un contorno, dibujado en el color de equipo más cercano. Vacío para ninguno.
`equipment`	mapa	vacío	Por hueco (`head`, `chest`, `legs`, `feet`, `hand`, `off_hand`): un material, `playerhead-<nombre>`, `basehead-<textura>` o un ítem `bytes:`.
`look.mode`	`fixed` `nearest` `each-viewer`	`each-viewer`	Hacia dónde gira la cabeza.
`look.range`	número	`8.0`	A qué distancia tiene que estar un jugador para que se gire hacia él.
`view-distance`	número	`48`	Desde qué distancia se ve.
`permission`	texto	vacío	Solo lo ven, con su etiqueta, los jugadores con él.
`label.lines`	lista	vacía	Las líneas sobre su cabeza, de arriba abajo, con etiquetas de línea. Vacía: sin etiqueta.
`label.height-offset`	número	`0.25`	Hueco entre lo alto de su cabeza y la línea inferior de la etiqueta.
`linked-hologram`	texto	vacío	Un holograma de `holograms.yml` que se mantiene sobre su cabeza. Ver NPCs.
`interactions.actions`	lista	vacía	Líneas de interacción, en orden.
`interactions.permission`	texto	vacío	Solo pueden usarlo los jugadores con él.
`interactions.cooldown`	duración	`0`	Espera entre dos usos del mismo jugador: `500ms`, `2s`, `1m`.
`interactions.deny-message`	texto	vacío	Lo que se le dice a un jugador sin el permiso; vacío usa `interaction-denied`.
`interactions.cooldown-message`	texto	vacío	Lo que se le dice a un jugador que aún espera (`%remaining%` segundos); vacío usa `interaction-cooldown`.
`interactions.face-clicker`	booleano	`true`	Girarse hacia quien hizo clic durante `turn-back`.

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