Cài đặt ExtralyCinematic

Hướng dẫn này cài ExtralyCinematic trên server Paper và kiểm tra command, thư mục storage, cùng hook tùy chọn.

Yêu cầu

• Server Paper tương thích API 1.21
• Java 21
• Permission system hoặc operator access cho cinematic.cmd
• Tùy chọn: PlaceholderAPI, WorldGuard, MythicMobs

Build từ source

Từ thư mục sản phẩm:

cd ExtralyCinematic
./gradlew clean shadowJar

Jar shaded được tạo tại:

ExtralyCinematic/build/libs/

Gradle build relocate class command ACF vào jar plugin. Soft dependency bên ngoài là compile-only và phải được cài riêng khi muốn dùng hook.

Cài vào server

1. Dừng server.
2. Copy jar đã build vào thư mục plugins/.
3. Cài dependency tùy chọn nếu cần:
   • PlaceholderAPI cho placeholder
   • WorldGuard cho region trigger
   • MythicMobs cho boss/skill trigger
4. Start server.
5. Xác nhận plugin enable trong console.

Lệnh mong đợi:

/cinematic

Permission mong đợi:

cinematic.cmd

Kiểm tra file runtime

Sau lần boot đầu, kiểm tra:

plugins/ExtralyCinematic/config.yml
plugins/ExtralyCinematic/cinematics/

Nếu WorldGuard được cài, file này được tạo khi hook khởi động lần đầu:

plugins/ExtralyCinematic/worldguard.yml

Smoke Test

Chạy:

/cinematic list

Sau đó tạo path nhỏ hai frame:

/cinematic addframe smoke
/cinematic addframe smoke
/cinematic duration smoke 3
/cinematic play <your_name> smoke

Người xem nên vào spectator mode, chạy camera sequence, rồi quay lại vị trí và game mode ban đầu.

Lỗi cài đặt thường gặp

• Chạy Java thấp hơn 21.
• Copy jar chưa shade thay vì shadow jar.
• Thiếu cinematic.cmd.
• Test WorldGuard/MythicMobs khi các plugin đó chưa cài và enable.