Configuración
config.yml
yaml
# Ticks entre revisiones de los activadores por placeholder y de las
# condiciones de visibilidad. Cada revisión rellena los placeholders una vez
# por jugador y por condición, así que en servidores grandes mejor más de 1.
placeholder-interval: 10
web:
# Dónde guarda el editor web los hologramas entre el servidor y tu navegador.
# El público funciona; para que tus hologramas no pasen por él, monta el tuyo:
# docker run -p 3000:8080 ghcr.io/lucko/bytebin
bytebin: "https://bytebin.lucko.me"Ejecuta /hbb reload después de cambiarlo.
messages.yml
Todos los mensajes de HologramBB están en messages.yml, escritos en MiniMessage. Cambia colores, palabras o idioma libremente. Cuando una actualización trae mensajes nuevos, se añaden a tu archivo al arrancar, sin tocar lo que cambiaste.
Ajustes del holograma
Cada holograma tiene sus propios ajustes. En el editor web: Menú → Ajustes del holograma. Con comandos: /hbb set <id> <clave> <valor>.
| Ajuste | Clave | Por defecto | Qué hace |
|---|---|---|---|
| Id | Su nombre y el nombre de su archivo. Un id nuevo crea un holograma nuevo al aplicarlo. | ||
| Distancia de visión | view-distance | 48 | Desde qué distancia (en bloques) lo ven los jugadores. |
| Radio de mirada | look-radius | 1.0 | Qué tan cerca de su centro debe apuntar un jugador para contar como "lo mira". |
| Refresco | update-interval | 20 | Ticks entre refrescos de los placeholders de su texto; 0 para nunca. |
| Caja de click | hitbox | a la medida de las capas | [ancho, alto] de la caja que recibe los clicks. Solo existe cuando algo reacciona a clicks. |
| Permiso | visibility.permission | ninguno | Solo lo ven los jugadores que lo tienen. |
| Condición | visibility.condition | ninguna | Solo lo ven los jugadores para quienes es verdadera. |
| Escondido hasta mostrarlo | visibility.manual | false | Nadie lo ve hasta /hbb show. |
| Ubicación | location | Se pone con /hbb movehere. El servidor conserva la suya cuando aplicas desde la web. |
Archivos
plugins/HologramBB/
├── config.yml
├── messages.yml
├── clips.yml opcional: animaciones compartidas por todos los hologramas
└── holograms/
└── <id>.yml un archivo por holograma