Plugin Minecraft SkBee

🔌 Giới thiệu về SkBee

SkBee là một addon cho Skript, mở rộng ngôn ngữ Skript với một bộ lớn các thành phần giúp lộ ra internals của server và các tính năng Minecraft hiện đại cho những người viết script. Nó cung cấp các cú pháp và tiện ích để làm việc với NBT, các thành phần văn bản nâng cao, scoreboard, recipe, dữ liệu block, cấu trúc, tạo world và region/bounds đơn giản — cho phép quản trị viên server triển khai các cơ chế phức tạp bằng Skript thay vì Java.

🎯 Mục đích

Mục đích cốt lõi của SkBee là cung cấp cho người dùng Skript quyền truy cập trực tiếp vào các tính năng của Bukkit/Paper server APIs và internals của Minecraft vốn rất khó hoặc gần như không thể đạt được bằng Skript vanilla. Nó dành cho chủ server và người viết script cần kiểm soát chính xác hơn đối với item, entity, định dạng văn bản, thao tác world và xử lý structure ngay trong các script Skript.

⚙️ Tính năng

• Các phần tử NBT: lấy/đặt NBT của item, tile entities (block) và entity (được ghi chú là có sẵn cho các phiên bản cũ hơn, xuống tới 1.8.8+ nếu được hỗ trợ).
• FastBoards: một hệ thống scoreboard được thiết kế để giảm nhấp nháy (có trên các phiên bản Minecraft mới hơn nếu được hỗ trợ).
• Recipes: thêm recipe tùy chỉnh và xóa recipe vanilla (các tính năng này được ghi chú là có sẵn từ các phiên bản muộn hơn, ví dụ 1.13+ cho recipe APIs).
• BlockData: truy cập lấy/đặt block data đơn giản hóa cho các block state hiện đại (có trên các phiên bản được hỗ trợ).
• Structures: lưu và dán các cấu trúc Minecraft vanilla bằng hệ thống structure của game.
• TextComponents: tạo và thao tác các tin nhắn kiểu JSON/TextComponent với sự kiện hover và click, cùng hỗ trợ hover item.
• WorldCreator: tạo world tùy chỉnh với các tùy chọn có thể cấu hình được cung cấp cho Skript.
• Bounds: tạo bounds/regions đơn giản tương tự bảo vệ region nhẹ để dùng trong Skript.
• GameEvents: móc vào hệ thống GameEvent của Minecraft (được dùng bởi skulk sensors và các cơ chế liên quan).

🧩 Dành cho ai

• Quản trị viên server dùng Skript và cần truy cập API sâu hơn mà không phải viết plugin Java.
• Nhà phát triển Skript xây dựng GUI nâng cao, item tùy chỉnh, tin nhắn có cấu trúc hoặc công cụ world/structure.
• Các server Survival, SMP và server game tùy chỉnh dựa vào Skript cho cơ chế gameplay và muốn mở rộng chức năng.

🏗️ Ví dụ sử dụng

• Một người viết script đọc và sửa NBT của item để triển khai hành vi và thuộc tính item tùy chỉnh ngay trong Skript.
• Một admin tạo recipe crafting tùy chỉnh và xóa các recipe vanilla không mong muốn bằng cú pháp Skript.
• Người thiết kế lưu và dán các structure dựng sẵn trong quá trình tạo world hoặc bằng công cụ xây dựng trong game.
• Hệ thống chat hoặc GUI cần các thành phần văn bản JSON với hành động hover/click và xem trước item.

⚙️ Cài đặt

📥 Thiết lập

• Lấy plugin SkBee .jar từ nguồn tải xuống chính thức và đặt vào thư mục plugins/ của server cùng với Skript.
• Khởi động lại server để Skript và các addon của nó được tải sạch sẽ.
• Kiểm tra log console của server để xác nhận SkBee đã được tải thành công và đã phát hiện phiên bản Skript được cài đặt.

📦 Phụ thuộc

• Skript (SkBee là một addon cho Skript; các bản dựng SkBee gần đây yêu cầu các bản phát hành Skript gần đây — hãy xem ghi chú phát hành của plugin để biết chính xác phiên bản Skript cần thiết).

🧠 Ghi chú kỹ thuật

• SkBee được duy trì như một dự án mã nguồn mở theo giấy phép GPL-3.0.
• Các tính năng khác nhau có thể bị ràng buộc theo phiên bản: một số phần tử (ví dụ xử lý NBT) có ghi chú tương thích cho các bản phát hành Minecraft cũ hơn (ví dụ trong tài liệu upstream, một số tính năng có sẵn từ 1.8.8+ và một số khác từ 1.13+).
• SkBee cung cấp JavaDocs và wiki cho các cú pháp; hãy tham khảo các tài liệu này khi viết các file Skript sử dụng tính năng SkBee.
• SkBee hướng tới hỗ trợ các bản phát hành Skript gần đây và các bản phát hành Minecraft gần đây; phiên bản Skript hoặc Minecraft cần thiết có thể khác nhau theo từng bản phát hành SkBee — hãy kiểm tra ghi chú phát hành của bản dựng bạn tải xuống.

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

Nếu bạn dùng Skript làm hệ thống scripting cho server và cần truy cập NBT, tin nhắn văn bản có cấu trúc, recipe tùy chỉnh, lưu/dán structure, hoặc các công cụ tạo region và world đơn giản mà không cần viết Java, SkBee cung cấp một bộ cú pháp và tiện ích rộng lớn, đã được xác nhận, để mở rộng những gì bạn có thể triển khai chỉ bằng Skript.