Plugin Minecraft SCore

🔌 Giới thiệu về SCore

SCore là plugin lõi/thư viện do Ssomar tạo ra để tập trung các chức năng dùng chung trong toàn bộ bộ plugin của họ. Nó cung cấp các trình chỉnh sửa trong game và các tính năng runtime mà những plugin Ssomar khác phụ thuộc vào, đồng thời cũng có thể dùng độc lập để tạo và chạy projectile tùy chỉnh, quản lý biến và thực thi các lệnh tùy chỉnh đã đóng gói.

🎯 Mục đích

SCore tồn tại để cung cấp một nền tảng có thể tái sử dụng cho các nhà phát triển plugin (đặc biệt là họ plugin Ssomar), যাতে các tính năng được triển khai một lần và được nhiều plugin sử dụng. Nó hướng tới các nhà phát triển và quản trị viên máy chủ đang chạy một hoặc nhiều plugin Ssomar hoặc muốn có sẵn các cơ chế có thể tái sử dụng này trên máy chủ của họ.

⚙️ Tính năng

• Trình chỉnh sửa trong game để tạo và sửa projectile tùy chỉnh.
• Projectile tùy chỉnh runtime có thể được bắn hoặc kích hoạt.
• Biến toàn cục và theo người chơi với các kiểu (NUMBER, STRING, LIST).
• Hỗ trợ placeholder cho biến (token placeholder để dùng trong các plugin/cấu hình khác).
• Khung thực thi lệnh đóng gói/tùy chỉnh có thể truy cập từ console máy chủ hoặc các plugin khác.
• Được thiết kế để dùng làm dependency bởi các plugin Ssomar khác.

🧩 Dành cho ai

• Chủ máy chủ đang chạy các plugin Ssomar (ExecutableItems, ExecutableBlocks, v.v.).
• Nhà phát triển cần một thư viện có thể tái sử dụng cho projectile, biến và thực thi lệnh tùy chỉnh.
• Quản trị viên muốn có các trình chỉnh sửa nhẹ ngay trong server cho những tính năng đó.

🏗️ Ví dụ sử dụng

• Một máy chủ dùng SCore cùng với ExecutableItems để định nghĩa và kích hoạt hành vi projectile tùy chỉnh.
• Một admin tạo biến toàn cục hoặc theo người chơi và hiển thị chúng dưới dạng placeholder cho menu hoặc plugin khác.
• Một nhà phát triển plugin dựa vào SCore để tái sử dụng lưu trữ biến và đóng gói lệnh giữa nhiều plugin.

⌨️ Lệnh

Lưu ý: tài liệu chính thức cũng ghi nhận các token placeholder cho biến (ví dụ %score_variables_<var_name>% và %score_variables_<var_name>_int%). Các node quyền không được liệt kê trong metadata của plugin được tham chiếu.

⚙️ Cài đặt

📥 Thiết lập

• Tải file SCore .jar chính thức cho đúng phiên bản plugin tương ứng.
• Đặt file .jar vào thư mục plugins/ của máy chủ.
• Khởi động lại máy chủ và kiểm tra console để xác nhận SCore đã được tải.
• Nếu bạn chạy các plugin Ssomar khác, hãy cài bản build SCore khớp với hậu tố phiên bản của chúng như dự án khuyến nghị (khớp build SCore với build của plugin phụ thuộc).

🧠 Ghi chú kỹ thuật

• Các nền tảng hỗ trợ đã xác nhận: Bukkit, Spigot, Paper, Purpur, Folia.
• Các phiên bản Minecraft được hỗ trợ đã xác nhận bao gồm: 1.21.x xuống đến 1.8.x (theo danh sách của dự án).
• Metadata của dự án liệt kê nhãn giấy phép hạn chế (ARR / All Rights Reserved), trong khi bản phân phối của dự án cũng tham chiếu đến một kho Git để đóng góp; các mục này xuất hiện cùng nhau trong metadata chính thức.
• SCore được thiết kế để cài như một thư viện/dependency cho các plugin Ssomar khác; nó cung cấp các tính năng mà những plugin khác gọi ở runtime.

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

Nếu bạn chạy các plugin Ssomar hoặc cần một hệ thống sẵn dùng trong server cho projectile tùy chỉnh và placeholder biến, SCore cung cấp runtime dùng chung và các trình chỉnh sửa mà những plugin đó dựa vào mà không cần bạn tự triển khai lại các cơ chế tương tự.