Định dạng lưu trữ ExtralyCinematic
ExtralyCinematic lưu một file YAML cho mỗi cinematic.
plugins/ExtralyCinematic/cinematics/<name>.ymlVí dụ
Phần tiêu đề “Ví dụ”name: boss_introbgm: minecraft:music_disc.pigstepshake: 1.5zoom: start: 0 end: 3duration: 12focus: world: world x: 100.5 y: 72.0 z: -33.5frames: - 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
Phần tiêu đề “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
Phần tiêu đề “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
Phần tiêu đề “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
Phần tiêu đề “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 trongcmds. - 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
Phần tiêu đề “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.