Custom Items

Vật phẩm tuỳ chỉnh (Ticket / Reward / Icon)

Ba loại vật phẩm trong PhoBanX — vé vào cửa, phần thưởng, icon phó bản — đều dùng chung 1 cú pháp ID, hỗ trợ 4 nguồn vật phẩm.

Cú pháp ID

Nguồn	Cú pháp	Ví dụ
Vanilla	tên Material	DIAMOND_SWORD
Vanilla + CustomModelData	<material>#<số>	DIAMOND_SWORD#1001
ItemsAdder	ia:<namespace:id>	ia:myaddon:ruby_sword
Oraxen	ox:<id>	ox:ruby_sword
MMOItems	mmo:<type>:<id>	mmo:SWORD:RUBY_SWORD

Hậu tố #<số> (CustomModelData) gắn được vào bất kỳ nguồn nào ở trên, kể cả item ItemsAdder/Oraxen/MMOItems, để override model resource pack:

mmo:SWORD:RUBY_SWORD#500

Cách nhập nhanh: cầm item trên tay

Ở hầu hết các GUI admin (vé, icon, phần thưởng), thay vì gõ ID, bạn có thể cầm item cần dùng trên tay rồi bấm nút cập nhật — cách này giữ nguyên 100% NBT/meta của item đang cầm (kể cả CustomModelData hoặc NBT MMOItems có sẵn), không cần biết cú pháp ID.

Chỉ khi không cầm sẵn item (ví dụ đang cấu hình từ xa) mới cần Shift + Click để gõ ID qua chat.

Lưu ý về MMOItems

Khác với ItemsAdder/Oraxen (API rất ổn định giữa các bản), toạ độ Maven và tên lớp API public của MMOItems + MythicLib đã đổi vài lần giữa các phiên bản. Nếu bạn tự build plugin từ source, hãy đối chiếu lại đúng version MMOItems đang cài trên server (xem wiki chính thức MMOItems, mục "Setting up your dev environment") trước khi build.

Nếu type/id không khớp lúc runtime, MMOItemsHook sẽ log cảnh báo thay vì làm crash toàn bộ plugin — an toàn hơn cho production.

Vé vào cửa (Ticket)

Cấu hình trong dungeons/<id>.yml:

ticket:
  item: { material: DIAMOND }   # hoặc dùng ID theo cú pháp ở trên
  amount: 1

• Người chơi cần đủ số lượng vé (amount) — tính cả tổng vé của cả team nếu đi theo nhóm.
• Admin phát vé cho người chơi bằng lệnh /phoban admin giveve <id> <player|all> <amount>.
• Người chơi tự chia sẻ vé cho đồng đội bằng /phoban shareve <id> <player|party> <amount>.

Phần thưởng (Reward)

Mỗi phần thưởng có thể là:

• Vật phẩm thường: rớt ra trực tiếp vào túi đồ, số lượng ngẫu nhiên trong khoảng min-amount–max-amount
• "Hộp quà" gắn lệnh: item có gắn 1 hoặc nhiều lệnh console (commands: [...]), người chơi click chuột phải để kích hoạt — item bị tiêu hao sau khi dùng, lệnh chạy dưới quyền console (hỗ trợ placeholder %player% và PlaceholderAPI)

Icon phó bản

Icon hiển thị trong menu /phoban cho từng phó bản — mặc định là CHEST nếu không đặt riêng. Đặt icon riêng qua GUI chỉnh sửa (xem Hướng dẫn Admin, mục 3). Icon riêng được áp dụng cho mọi nơi hiển thị phó bản đó trong GUI (danh sách phó bản + danh sách phòng ở mọi trạng thái).