Plugin Minecraft skript-reflect

🔌 Về skript-reflect

skript-reflect là một addon cho Skript, cung cấp khả năng reflection cho các script Skript. Nó cho phép người viết script import và tương tác với các lớp Java, gọi các method, đọc và ghi field, tạo proxy, và định nghĩa hoặc lắng nghe custom event, giúp Skript tiếp cận các API và hành vi không có sẵn qua các biểu thức mặc định.

🎯 Mục đích

Mục đích cốt lõi của plugin này là kết nối Skript và Java bằng cách cung cấp các tiện ích reflection cấp thấp. Nó giải quyết các hạn chế khi Skript không có biểu thức hoặc event trực tiếp, bằng cách cho phép người viết script nâng cao và nhà phát triển addon gọi vào runtime của server hoặc các plugin khác.

⚙️ Tính năng

• Import và tham chiếu các lớp Java từ Skript.
• Gọi method và tạo đối tượng thông qua reflection.
• Đọc và ghi field bằng reflection.
• Tạo proxy cho class và custom event có thể dùng bên trong Skript.
• Hỗ trợ lắng nghe các event bất đồng bộ.
• Cải tiến và sửa lỗi so với các fork cũ hơn (xử lý biến cục bộ, sửa class proxy).
• Được tuyên bố tương thích với các Java runtime mới hơn (maintainer có nhắc đến Java 13+ và hỗ trợ OpenJ9).

🧩 Dành cho ai

• Người viết script Skript cần truy cập vào API Java hoặc internals của plugin khác.
• Quản trị viên server chạy hành vi tùy chỉnh dựa trên Skript và muốn mở rộng Skript mà không cần viết một plugin Java hoàn chỉnh.
• Nhà phát triển addon xây dựng các phần mở rộng Skript cấp cao hơn bằng reflection.

🏗️ Ví dụ sử dụng

• Truy cập API của một plugin mà Skript không có biểu thức gốc bằng cách gọi các method Java của nó.
• Tạo một loại custom event trong Java rồi phát/nghe nó từ Skript.
• Dùng proxy để bọc các Java interface nhằm tạo hành vi động trong script.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR của plugin từ các bản phát hành chính thức của dự án.
• Đặt file JAR vào thư mục plugins/ của server cùng với Skript.
• Khởi động lại server và kiểm tra console để xác nhận skript-reflect đã được tải.

📦 Phụ thuộc

• Yêu cầu Skript 2.14 trở lên.

🧠 Ghi chú kỹ thuật

• Dự án được phân phối theo giấy phép MIT.
• Maintainer cho biết skript-reflect yêu cầu Skript 2.14+ và hỗ trợ cùng các nền tảng và phiên bản Minecraft mà Skript 2.14 hỗ trợ.
• Tài liệu và các bản phát hành của dự án được duy trì trong kho lưu trữ chính thức và các nguồn tài liệu của dự án.

🤝 Khi nào plugin này hữu ích

Nếu bạn cần mở rộng Skript với các chức năng không có trong biểu thức mặc định hoặc các addon hiện có (ví dụ như gọi API của plugin khác hoặc tạo các loại event tùy chỉnh), skript-reflect cung cấp các công cụ reflection để bạn làm điều đó ngay từ các script Skript mà không cần viết một plugin Java độc lập.