NPCs

Un NPC es una figura de jugador en un sitio, mirando hacia un lado. Como los hologramas, son solo paquetes: no se le puede herir, empujar ni matar, y no cuesta nada cuando no hay nadie cerca.

Crear uno

Se coloca donde estás. Con face-creator activo (por defecto) te mira; desactivado, mira hacia donde mirabas tú, en horizontal. Recibe el default-view-distance y el default-look de config.yml y una etiqueta con su nombre, o la etiqueta del preset (%npc% se convierte en su nombre) y sus acciones. La skin de un preset gana a la escrita, salvo que el preset no tenga.

Los presets que trae:

El editor

/npc <nombre> (o un clic izquierdo en la lista):

Skin

Pose, tamaño y contorno

Equipo

Huecos: head, chest, legs, feet, hand, off_hand.

/npc guia equip hand                    # el ítem de tu mano
/npc guia equip hand DIAMOND_SWORD
/npc guia equip head playerhead-Notch
/npc guia equip head basehead-<textura>
/npc guia equip hand air                # vacía el hueco
/npc guia equip clear                   # vacía todos los huecos

El archivo guarda cada hueco como un icono: un material, playerhead-<nombre>, basehead-<textura>, o un ítem bytes: para un ítem de tu mano que lleva más que un material.

Hacia dónde mira

El número es el alcance de la mirada en bloques (por defecto 8). each-viewer es el modo por defecto de los NPCs nuevos (default-look).

Con face-clicker activo (por defecto), un clic que ejecuta sus acciones también lo gira hacia quien hizo clic durante turn-back (por defecto 4 segundos), y luego vuelve. Ese giro nunca se guarda.

Quién lo ve

• /npc <nombre> viewdistance <bloques>: desde qué distancia se ve (por defecto 48).
• /npc <nombre> permission [nodo]: solo lo ven, con su etiqueta, los jugadores con el nodo. Sin nodo, se quita.

Un NPC en un mundo que no está cargado espera y aparece cuando el mundo carga.

La etiqueta

La etiqueta son las líneas sobre su cabeza, el nombre que leen los jugadores. Es un holograma, así que funcionan en ella todas las etiquetas de línea, y hacer clic en ella hace lo mismo que hacer clic en el NPC.

/npc guia label set <size:1.2><shine>{primary}&lGUÍA    # sustituye todas las líneas por esta
/npc guia label add <opacity:200>{letters_black}Clic derecho
/npc guia label remove 2
/npc guia label clear
/npc guia label height 0.4

height-offset es el hueco entre lo alto de su cabeza (que sigue su pose y su escala) y la línea inferior de la etiqueta. Por defecto 0.25. Una etiqueta sin líneas es que no hay etiqueta.

Un holograma enlazado

Para algo más que un nombre — páginas, una caja de clic propia, placeholders por espectador — enlaza cualquier holograma de holograms.yml:

/npc guia link tablon_guia
/npc guia unlink

El NPC coloca ese holograma sobre su cabeza (por encima de la etiqueta, si tiene) escribiendo su location en holograms.yml, y lo vuelve a hacer cada vez que el NPC se mueve. El holograma se sigue editando como holograma. Enlazar necesita el módulo de hologramas activo.

Estatuas

Una estatua es un NPC congelado en su sitio que lleva la skin de quien ocupe un puesto: el top 3 semanal en el spawn, el campeón de un torneo como trofeo.

1. Créalo con el preset statue: mira hacia donde se colocó, tiene contorno dorado y una etiqueta de placa.

2. Apunta su skin a un placeholder que dé un nombre de jugador, con una cuenta para cuando el puesto esté vacío. Cambia de skin solo cuando otro ocupa el puesto:

   /npc top1 skin %ajlb_lb_statistic_player_kills_1_alltime_name% Notch

3. La etiqueta es la placa, y los placeholders funcionan en ella:

   /npc top1 label set <size:1.3>{highlight}&l#1 {primary}&l%ajlb_lb_statistic_player_kills_1_alltime_name%
   /npc top1 label add {letters_black}▎ {letters}Kills {letters_black}» {info}%ajlb_lb_statistic_player_kills_1_alltime_value%

4. Dale una pose (/npc top1 pose sneaking), algo en la mano (/npc top1 equip hand) o ponlo a bailar siempre que haya alguien cerca, con un idle continuo:

   /npc top1 animation idle anim:<un clip en bucle>
   /npc top1 animation idle-continuous on

Construye el pedestal con bloques reales y coloca la estatua encima: los jugadores pueden subirse y rodearla.

Animaciones

Un NPC reproduce algo en cuatro disparadores: un clic izquierdo, un clic derecho, por su cuenta (idle) y para saludar a quien se acerca (greet, que solo ve ese jugador). Cada uno lleva movimientos vanilla o una actuación.

Una actuación es un cuerpo entero que ocupa el lugar del NPC para quien esté a menos de perform-range (24 bloques por defecto): hace una reverencia, baila o saluda en vez de mover un brazo. Su hitbox sigue ahí, así que los clics siguen llegando al NPC. Se reproduce una a la vez, y un NPC sentado nunca actúa.

npcs:
  guide:
    animations:
      left-click: flinch
      right-click: anim:wave
      idle: anim:sway
      idle-every: 20s           # cada cuánto se reproduce el idle; 0 nunca
      idle-continuous: false    # true: el idle se repite mientras haya alguien cerca
      idle-group: ''            # los NPCs de un grupo llevan sus idles sincronizados
      greet: bow
      greet-range: 4.0
      greet-cooldown: 30s
      perform-range: 24.0

Se configuran con /npc <nombre> animation <disparador> <valor> (none lo quita) o desde ANIMACIONES en el editor. /npc <nombre> play <valor> prueba una ahora y avisa si se omitió. El selector de actuaciones (shift-clic izquierdo en ANIMACIONES) muestra cada emote y cada clip: clic izquierdo para ponerlo en un disparador, clic derecho para probarlo.

La skin

El cuerpo lleva la skin del propio NPC, una cuenta o una textura. Con @mirror, un saludo (que ve un solo jugador) lleva la skin de ese jugador, y lo que ven todos lleva la de por defecto, porque el cuerpo es uno solo. Se dibuja con piezas de skin reales (Exylia Skins), así que no se sube nada a MineSkin ni hace falta un resource pack.

Idle continuo

Con idle-continuous: true el idle se reproduce sin fin mientras haya alguien a menos de perform-range; si no hay nadie cerca, no hay cuerpo ni coste:

/npc dancer animation idle anim:sway
/npc dancer animation idle-continuous on

• Un clic, un saludo o /npc <nombre> play se reproduce encima al momento, y el idle vuelve después.
• Escribe el idle como un bucle (un clip en bucle en Blockbench, o loop:true;anim:<clip>). Un clip que no se repite llega a su final y vuelve a empezar con un breve parpadeo.
• Quien llega a mitad del bucle ve el NPC normal hasta que acaba el ciclo, y entonces se une.
• Solo vale para actuaciones; los movimientos vanilla de idle siguen con idle-every.

Grupos

Un grupo es un conjunto de NPCs que se mueven a la vez: un coro, una fila de bailarines, las tres estatuas de un podio.

/npc left group stage
/npc middle group stage
/npc right group stage
/npcadmin group play stage anim:dance

• /npc <nombre> group <clave|none> lo mete en un grupo. El grupo es el idle-group del NPC, la misma clave que /npc <nombre> animation idle-group: un solo ajuste con dos nombres.
• Los idles continuos de un grupo comparten un reloj: un NPC que empieza más tarde, o vuelve tras un clic, espera al siguiente ciclo y va en la misma pose que los demás. Da a un grupo un solo clip de idle.
• /npcadmin group play <grupo> <animación> la empieza en todos los miembros en el mismo instante y al mismo tempo, y dice cuántos empezaron y cuántos se omitieron (ya actuando, fuera del mundo o sin nadie cerca).
• /npcadmin group stop <grupo>, /npcadmin group pause <grupo> y /npcadmin group resume <grupo> actúan sobre todos los miembros. /npcadmin group list muestra cada grupo con sus miembros.

Pausa y parada

La pausa no se guarda: un reinicio reanuda todos los NPCs. /npc <nombre> info, la tarjeta ANIMACIONES y el botón REPRODUCCIÓN del selector de actuaciones muestran el estado; el botón pausa o reanuda (izquierdo) y detiene (derecho).

Blockbench

anim: lee los proyectos de Blockbench directamente. Guarda el .bbmodel en plugins/ExyliaDisplays/animations y sus clips se reproducen al momento: sin exportar, sin recargar, y un proyecto guardado de nuevo reproduce sus fotogramas nuevos.

1. Al arrancar, el plugin escribe ahí dos plantillas, cada una solo si falta:

   Archivo	Modelo
   player_classic.bbmodel	Brazos de 4 píxeles (Steve)
   player_slim.bbmodel	Brazos de 3 píxeles (Alex)

   Las dos tienen los huesos que lee anim: (body, torso, head, right_arm, left_arm, right_leg, left_leg, cada extremidad con un hueso _bend para el codo o la rodilla) y un clip de ejemplo, wave.

2. Abre una en Blockbench, añade clips en Animate y guarda. Una copia con otro nombre también sirve.

3. /npcadmin animations lista cada archivo con sus clips, si se repiten y cuánto duran. /npcadmin animations <archivo> muestra uno. Haz clic en un clip para copiar su nombre anim:.

4. Reprodúcelo: /npc <nombre> play anim:<clip>, o ponlo en un disparador.

Un clip se llama por su nombre. Un archivo con un solo clip también responde al nombre del archivo. Arrastra una skin al modelo en Blockbench para verla; en el juego el cuerpo lleva la skin del NPC.

Comandos de un vistazo

Ver Comandos para la lista completa. /npc compite con el /npc de Citizens cuando están los dos; usa entonces /npcs <nombre> o /exylianpc <nombre>. /npcadmin nunca choca.