Plugin Minecraft PhoenixCrates

🔌 Giới thiệu về Phoenix Crates

Phoenix Crates là một plugin Minecraft để vận hành hệ thống crate/phần thưởng trên máy chủ. Nó cung cấp các loại crate, chìa khóa (vật lý và ảo), chuỗi mở có hoạt ảnh, và một trình chỉnh sửa ngay trong game để tạo và quản lý crate cũng như phần thưởng mà không cần sửa các tệp thô. Dự án được phát hành bởi Phoenix Plugins và có bản miễn phí cùng phiên bản premium trả phí với các tính năng bổ sung.

🎯 Mục đích

Cung cấp cho quản trị viên máy chủ một hệ thống phần thưởng/crate có thể cấu hình, có thể hiển thị hoạt ảnh mở, quản lý chìa khóa và chìa khóa ảo kiểu tiền tệ, đồng thời cho phép nhân viên tạo hoặc chỉnh sửa crate và phần thưởng ngay trong game. Nó hướng tới các máy chủ muốn cơ chế kiểu sự kiện hoặc shop/phần thưởng (ví dụ: quà tặng phần thưởng, crate của cửa hàng, hoặc giải thưởng sự kiện).

⚙️ Tính năng

• Nhiều chế độ engine crate (khối vanilla, model vanilla, tích hợp Model Engine).
• Chuỗi mở có hoạt ảnh và hoạt ảnh chờ với các giai đoạn và tổ hợp có thể cấu hình.
• Chìa khóa vật lý và quản lý chìa khóa ảo (menu chìa khóa ảo, thanh toán/chuyển, lệnh give/take/set).
• Trình chỉnh sửa trong game để tạo/chỉnh sửa crate, chìa khóa, phần thưởng và hoạt ảnh.
• Các loại phần thưởng bao gồm phần thưởng ngẫu nhiên và chọn lọc (người chơi chọn), reroll và phần thưởng được đảm bảo.
• Add-on và các tính năng premium bổ sung (thêm hoạt ảnh, hỗ trợ MySQL, API, và cài add-on trong gói premium).
• Hỗ trợ xem cơ bản trên Bedrock/Geyser cho một số hoạt ảnh và model nhất định.
• Công cụ xem trước và quản lý phần thưởng phía máy chủ (giới hạn thắng toàn cục/theo người chơi, đặt lại cooldown).

🧩 Dành cho ai

• Các máy chủ Survival/SMP và kinh tế có hiển thị crate hoặc hệ thống phần thưởng.
• Các máy chủ muốn mở crate có hoạt ảnh/hình ảnh và hỗ trợ model (Model Engine).
• Quản trị viên thích dùng trình chỉnh sửa trong game để thiết lập crate thay vì sửa file thủ công.

🏗️ Ví dụ sử dụng

• Cấp cho người chơi các chìa khóa ảo mà họ có thể dùng trong GUI để mở crate trang trí hoặc crate vật phẩm.
• Tạo crate chủ đề ngày lễ với hoạt ảnh mở tùy chỉnh và phần thưởng giới hạn.
• Dùng trình chỉnh sửa trong game để di chuyển hoặc xây lại cấu hình crate mà không cần sửa YAML thủ công.

⌨️ Lệnh

(Các lệnh trên được lấy từ tài liệu chính thức và phần tham chiếu lệnh của Phoenix Crates.)

🔐 Quyền

(Chỉ các node quyền được tài liệu hóa rõ ràng bởi dự án mới được liệt kê.)

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR chính thức của plugin Phoenix Crates hoặc lấy từ kênh phân phối chính thức.
• Đặt JAR vào thư mục plugins/ của máy chủ bạn trên một server được hỗ trợ (xem Ghi chú kỹ thuật).
• Khởi động hoặc khởi động lại server và kiểm tra console để xác nhận plugin đã được tải.
• Dùng trình chỉnh sửa trong game hoặc các lệnh được cung cấp để tạo crate và chìa khóa; plugin cũng có lệnh reload và editor.

📦 Phụ thuộc

• Mặc định không liệt kê phụ thuộc bên thứ ba bắt buộc nào. Plugin tích hợp với các hệ thống tùy chọn như Model Engine cho model tùy chỉnh và cung cấp các placeholder được nhắc đến trong changelog.

🧠 Ghi chú kỹ thuật

• Phần mềm máy chủ được hỗ trợ (theo tác giả): Spigot và các fork của Spigot, Paper và các fork của Paper, và Folia.
• Các phiên bản Minecraft được hỗ trợ: theo tài liệu, Phoenix Crates (ở dòng phiên bản được nêu) hỗ trợ Minecraft 1.20.4+ (đã bỏ hỗ trợ các phiên bản cũ hơn kể từ bản phát hành lớn được nêu).
• Tích hợp tùy chọn: Model Engine (model hoạt ảnh tùy chỉnh), ghi chú tương thích GeyserMC cho Bedrock, và các placeholder PlaceholderAPI được đề cập trong các bản cập nhật.
• Dự án được cung cấp ở cả gói miễn phí và premium; premium thêm các tính năng như hỗ trợ MySQL, quyền truy cập API công khai, số lượng crate không giới hạn, hoạt ảnh bổ sung và add-on.

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

Nếu bạn cần một hệ thống crate có thể cấu hình, dựa trên hoạt ảnh, có trình chỉnh sửa trong game và hỗ trợ tùy chọn cho model/Bedrock, Phoenix Crates cung cấp cả hiệu ứng hiển thị cho người chơi lẫn công cụ quản trị để quản lý phần thưởng và chìa khóa từ máy chủ.