Dirigir una cinemática

Una cinemática puede reproducirse de un tirón o formar parte de una conversación: se para donde quien la ve debe leer, escribe sus líneas letra a letra, pone actores en escena y, al final, hace una pregunta cuya respuesta decide lo que pasa después. Todo vive en el mismo archivo cinematics/<id>.yml que lo básico, y todo es solo para quien la ve.

Paradas

Una parada congela la cinemática en un momento hasta que quien la ve hace clic. La cámara se mantiene, se desplaza un poco (hold-drift) para que la imagen siga viva, y un aviso pulsante invita al clic. La primera pulsación termina una línea que aún se está escribiendo; la siguiente continúa. Los subtítulos, los títulos, los actores y el reloj de la cinemática esperan con la cámara.

Cuatro formas de hacer una parada:

advance: CLICK                 # una parada tras cada subtítulo
keyframes:
  - { at: 'world,0.00,70.00,0.00', time: 4.0, wait: true }       # se para cuando la cámara se ha asentado
  - { at: 'world,5.00,70.00,0.00', time: 9.0, wait: { timeout: 20 } }
waits:
  - { time: 12.0, timeout: 30, text: '{letters}Press to continue' }
  - { at: { keyframe: 3, offset: 1.0 } }

timeout son los segundos hasta que la cinemática sigue sola. Sin él se aplica cinematics.wait-timeout (45 s por defecto); 0 espera para siempre. Así nadie se queda congelado y lejos del teclado.

text en una parada es una línea que se mantiene en pantalla mientras espera. El último subtítulo que empezó antes de una parada también se mantiene hasta que quien la ve sigue, así que la línea por la que se le pregunta nunca ha desaparecido ya. Dos paradas a menos de 0,3 segundos son una.

Líneas escritas

Las líneas pueden aparecer como si se tecleasen, a typewriter caracteres por segundo:

typewriter: 30     # esta cinemática; 0 muestra las líneas enteras
drift: 0.08        # bloques que respira la cámara en una parada; 0 se queda quieta

Suena un sonido suave mientras se escribe una línea, y otro cuando quien la ve continúa. Sin typewriter, se aplica el de config.yml.

Sacudidas

shakes:
  - { time: 6.0, length: 0.8, strength: 0.4 }

La cámara se sacude durante length segundos (al menos 0,05), apagándose; strength está en bloques, de 0 a 3, 0.25 por defecto.

Escenas

scenes es una forma de escribir una cinemática sin tiempos. Cada escena es un movimiento de cámara y las líneas dichas sobre él; el plugin calcula los fotogramas, los tiempos de las líneas, las paradas y los fundidos, y los compila en los mismos fotogramas, subtítulos y paradas de cualquier otra cinemática.

typewriter: 35
scenes:
  - title: '{highlight}&lThe Capital'
    from: { at: 'world,100.5,80.0,40.5', yaw: 140, pitch: 20 }
    to:   { at: 'world,120.5,74.0,60.5', yaw: 160, pitch: 15 }
    lines:
      - 'Guide: Welcome to the capital.'
      - '-: The city never sleeps.'
    sounds:
      - { sound: BLOCK_AMETHYST_BLOCK_CHIME, after: 0.5 }
  - from: { at: 'world,0.5,70.0,0.5', yaw: 0, pitch: 10 }
    look-at: 'npc:guide'
    lines: ['Guide: This is where it begins.']
    wait: false

Una cinemática con escenas teclea sus líneas a cinematics.scene-typewriter (42 caracteres por segundo) salvo que typewriter diga otra cosa. Las escenas pueden convivir con keyframes normales. El editor reescribe un archivo de escenas como fotogramas.

Actores

Un actor es un cuerpo en escena que solo ve quien la mira: nada queda en el mundo.

actors:
  - id: guide
    name: '{highlight}Guide'
    skin: viewer              # la skin de quien la ve; un valor de textura; o vacío para la de por defecto
    at: 'world,10.5,70.0,3.5'
    yaw: 180
    held: DIAMOND_SWORD
    cues:
      - { time: 1.0, walk-to: 'world,14.5,70.0,3.5', seconds: 3 }
      - { time: 4.5, look: camera }
      - { time: 5.0, swing: true }
      - { time: 6.0, pose: LYING }
      - { time: 8.0, hide: true }

Cada señal tiene un time y una de estas: walk-to (con seconds; por defecto 3 bloques por segundo), look (camera o world,x,y,z), pose (STANDING, LYING, CRAWLING, SNEAKING o SPINNING), swing: true, hurt: true o hide: true. Una señal que no dice ninguna se reporta y se omite. Los actores siguen el reloj de la cinemática, así que se quedan quietos mientras espera en una parada.

Respuestas y ramas

Una cinemática puede acabar con una pregunta:

choice-prompt: '{letters}What do you do?'
choices:
  - { text: '{success}Follow the guide', next: follow-guide, key: followed }
  - { text: '{error}Stay behind', key: stayed }

La pantalla se oscurece tras la pregunta. Cerrarla toma la primera respuesta, así que nadie queda fuera de la historia. Un paso puede esperar una respuesta con un objetivo CUSTOM sobre choice:followed, de modo que las dos respuestas lleven a cosas distintas (consulta Pasos). Los jugadores de Bedrock, que no pueden dibujar la cámara, no reciben la pregunta.

Cada parada a la que llega quien la ve, desde la que sigue (pulsando o por tiempo) o que abandona se cuenta en las estadísticas del plugin.

Valores por defecto

En config.yml, bajo cinematics: