Plugin Minecraft BreweryX

🔌 Giới thiệu BreweryX

BreweryX là một plugin Minecraft được làm lại hệ thống brewing thành quy trình nhiều bước (lên men, chưng cất, ủ) để tạo ra các loại đồ uống và potion tùy chỉnh. Đồ uống có thể gây hiệu ứng say xỉn (di chuyển loạng choạng, chat bị méo, đau đầu sau say), và plugin cũng có bộ công cụ để định nghĩa công thức, tinh chỉnh chất lượng, cũng như quản lý điểm thức dậy cho người chơi đang say.

🎯 Mục đích

BreweryX cung cấp một hệ thống brewing thay thế, sâu hơn cho các server muốn có đồ uống tiêu thụ được với hiệu ứng tồn tại lâu và các giai đoạn vòng đời (ferment → distill → age). Nó giải quyết hạn chế của cơ chế potion mặc định bằng cách cho chủ server các công thức có thể cấu hình, các cấp chất lượng, và gameplay xã hội xoay quanh brewing.

⚙️ Tính năng

• Vòng đời brewing nhiều bước: lên men, chưng cất và ủ trong thùng.
• Đồ uống có cồn gây hiệu ứng say xỉn: di chuyển loạng choạng, ảnh hưởng đến chat, đau đầu sau say và hành vi khi tỉnh dậy.
• Công thức có thể cấu hình: xác định nguyên liệu, giai đoạn, thuộc tính và quy trình tạo tùy chỉnh.
• Cơ chế tinh chỉnh chất lượng: đồ uống có thể được cải thiện hoặc gây hiệu ứng tiêu cực khi chất lượng thấp.
• Hỗ trợ item tùy chỉnh qua CustomModelData và tích hợp với ItemsAdder, Oraxen.
• Hỗ trợ PlaceholderAPI cho placeholder.
• Hỗ trợ RGB đầy đủ cho các phiên bản Minecraft hiện đại (1.16+ khi RGB có liên quan).
• Hỗ trợ addon và một hệ sinh thái addon nhỏ (ví dụ: addon công thức, addon hologram).

🧩 Dành cho ai

• Các server Survival / SMP muốn có vật phẩm tiêu thụ được chế tạo với yếu tố roleplay.
• Server roleplay hoặc tập trung vào tavern đang tìm cơ chế đồ uống và tương tác xã hội sâu hơn.
• Server dùng gói item tùy chỉnh (ItemsAdder/Oraxen) và muốn các item đó làm nguyên liệu brewing.

🏗️ Ví dụ sử dụng

• Quản trị viên tạo một bộ công thức bí mật mà người chơi phải tự khám phá qua thử nghiệm.
• Một khu tavern nơi người chơi nấu, ủ và bán đồ uống chế tạo với hiệu ứng trong game.
• Các server dùng item tùy chỉnh tích hợp tài nguyên ItemsAdder/Oraxen làm nguyên liệu cho đồ uống đặc biệt.

⌨️ Lệnh

(Lưu ý: mô tả lệnh và các liên kết quyền ở trên được lấy từ tài liệu chính thức của plugin; một số phân biệt admin/mod trong tài liệu là theo ngữ cảnh.)

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải file BreweryX .jar chính thức (các bản phát hành chính thức được đăng trên tài nguyên Spigot của dự án và GitHub releases).
• Đặt file .jar vào thư mục plugins/ của server.
• Khởi động hoặc restart server và xem console để নিশ্চিত rằng BreweryX đã được nạp.

📦 Phụ thuộc

• PlaceholderAPI (hỗ trợ tích hợp).
• ItemsAdder (hỗ trợ tích hợp, tùy chọn).
• Oraxen (hỗ trợ tích hợp, tùy chọn).

Chỉ cài các tích hợp bạn cần; BreweryX hoạt động như một plugin Bukkit/Spigot tiêu chuẩn.

🧠 Ghi chú kỹ thuật

• Phần mềm server được xác nhận hỗ trợ: Spigot, Paper và Folia (nguồn dự án cho biết hỗ trợ Spigot/Paper/Folia).
• Phiên bản Minecraft được xác nhận hỗ trợ (phạm vi do dự án cung cấp): từ 1.8.9 đến 1.21.8 (xem metadata chính thức của dự án để biết các phiên bản đã thử nghiệm).
• Dự án là mã nguồn mở và được cấp phép theo GPL-3.0.
• Plugin tạo các file cấu hình và ngôn ngữ (file ngôn ngữ được đặt trong plugins/brewery/languages/ theo tài liệu).
• Dự án cung cấp một API và có repository BreweryX API riêng được nhóm nhắc đến.

❓ FAQ (ngắn)

• Q: Tôi có thể tự tạo công thức của riêng mình không?
  A: Có — BreweryX hỗ trợ công thức tùy chỉnh có thể cấu hình, bao gồm nguyên liệu, giai đoạn và thuộc tính.
• Q: BreweryX có hoạt động với các gói item tùy chỉnh không?
  A: Có — dự án liệt kê hỗ trợ tích hợp ItemsAdder và Oraxen.

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

Nếu bạn muốn thêm một hệ thống brewing bền vững, có thể cấu hình với các yếu tố roleplay (say xỉn, ủ, chưng cất) và hỗ trợ item tùy chỉnh, BreweryX cung cấp bộ công cụ công thức và các tích hợp để chạy hệ thống đó trên server dựa trên Spigot/Paper.