Định dạng lưu trữ ExtralyCinematic

ExtralyCinematic lưu một file YAML cho mỗi cinematic.

plugins/ExtralyCinematic/cinematics/<name>.yml

Ví dụ

name: boss_intro
bgm: minecraft:music_disc.pigstep
shake: 1.5
zoom:
  start: 0
  end: 3
duration: 12
focus:
  world: world
  x: 100.5
  y: 72.0
  z: -33.5
frames:
  - w: world
    x: 92.2
    y: 75.0
    z: -40.0
    yaw: 45.0
    pitch: 10.0
    cmds:
      - "playsound minecraft:entity.ender_dragon.growl master %player%"
    title: "<red>The Warden wakes.</red>"
    subtitle: "<gray>Do not move.</gray>"
  - w: world
    x: 101.0
    y: 73.0
    z: -35.0
    yaw: 90.0
    pitch: 5.0
    cmds: []
    title: ""
    subtitle: ""

Root key

Key	Kiểu	Ý nghĩa
name	string	Tên cinematic. Plugin cũng dùng làm tên file.
bgm	string hoặc null	Bukkit sound ID phát lúc bắt đầu.
shake	number	Cường độ offset yaw/pitch ngẫu nhiên.
zoom.start	integer	Giá trị effect zoom bắt đầu.
zoom.end	integer	Giá trị effect zoom kết thúc.
duration	integer	Duration playback bằng giây. 0 nghĩa là timing theo frame count.
focus	object	Focus target tùy chọn.
frames	list	Các camera frame theo thứ tự.

Focus object

Key	Kiểu	Ý nghĩa
focus.world	string	World chứa focus target.
focus.x	number	Tọa độ X target.
focus.y	number	Tọa độ Y target.
focus.z	number	Tọa độ Z target.

Focus chỉ hoạt động khi world của camera segment khớp focus.world.

Frame object

Key	Kiểu	Ý nghĩa
w	string	Tên world.
x	number	Tọa độ X camera.
y	number	Tọa độ Y camera.
z	number	Tọa độ Z camera.
yaw	number	Yaw camera.
pitch	number	Pitch camera.
cmds	string list	Console command chạy khi frame được vượt qua.
title	string	Title text MiniMessage.
subtitle	string	Subtitle text MiniMessage.

Quy tắc chỉnh thủ công

• Giữ ít nhất hai frame để playback.
• Giữ thứ tự frame có chủ đích.
• Dùng tên world hợp lệ.
• Không thêm / trước command trong cmds.
• Quote chuỗi MiniMessage khi có ký tự nhạy cảm với YAML.
• Restart hoặc reload state plugin sau khi chỉnh file thủ công.

Hành vi xóa

Lệnh /cinematic delete <name> xóa cinematic khỏi memory và gọi save. Logic save hiện tại ghi các cinematic đang có, nhưng không xóa file mồ côi rõ ràng. Nếu file cinematic đã xóa vẫn còn trên disk, xóa file YAML thủ công trước lần full reload tiếp theo.