Custom GUI

GUI Nền Ảnh Tuỳ Chỉnh (Custom GUI)

Đây là tính năng cho phép thay nền toàn bộ menu (danh sách phó bản, danh sách phòng, các GUI admin...) bằng 1 ảnh nền tuỳ chỉnh từ resource pack — theo đúng kỹ thuật "font-image GUI" quen thuộc với server dùng ItemsAdder/Oraxen (khác hoàn toàn so với việc chỉ đổi icon từng item lẻ).

Cách hoạt động

Bình thường tiêu đề GUI chỉ là chữ. Với ItemsAdder/Oraxen, bạn có thể đăng ký 1 font glyph đặc biệt (ảnh) và chèn glyph đó vào chuỗi tiêu đề — glyph sẽ hiển thị đè lên toàn bộ khung inventory, tạo cảm giác như 1 GUI có nền đồ hoạ riêng thay vì các ô kính màu vanilla. PhoBanX dựng sẵn cơ chế này cho 6 menu: dungeon-list, room-list, admin-edit, admin-reward, admin-reward-item, admin-mob-config.

Bật tính năng

Trong config.yml:

custom-gui:
  enabled: true
  menus:
    dungeon-list:
      id: "phobanx:dungeon_bg"   # ID font-image (ItemsAdder) hoặc glyph (Oraxen) đã đăng ký
      offset: 0                  # Dịch cả tấm ảnh nền sang trái/phải (pixel)
      text-offset: 0             # Dịch riêng phần CHỮ động ({page}, {dungeon_name}...) để canh vào khoảng trống đã chừa trên ảnh
    room-list: { id: "", offset: 0, text-offset: 0 }
    admin-edit: { id: "", offset: 0, text-offset: 0 }
    admin-reward: { id: "", offset: 0, text-offset: 0 }
    admin-reward-item: { id: "", offset: 0, text-offset: 0 }
    admin-mob-config: { id: "", offset: 0, text-offset: 0 }

• Để trống id (hoặc để enabled: false) → menu đó dùng tiêu đề chữ thường, không có ảnh nền.
• offset: dịch cả tấm ảnh nền — dùng khi ảnh bị lệch vị trí so với khung inventory 54 ô.
• text-offset: dịch riêng phần chữ phía sau ảnh (số trang, tên phó bản...) để nó rơi đúng vào khoảng trống bạn đã thiết kế sẵn trên ảnh nền. Số dương = dịch phải, số âm = dịch trái.

Yêu cầu

• Cần cài ItemsAdder hoặc Oraxen (1 trong 2, không bắt buộc cả 2) và đã tự đăng ký font-image/glyph nền GUI trong resource pack của bạn theo đúng hướng dẫn chính thức của plugin đó.
• PhoBanX không tạo giúp ảnh nền hay font glyph — bạn cần tự thiết kế ảnh và đăng ký ID bên ItemsAdder/Oraxen trước, sau đó chỉ cần dán đúng ID đó vào config.yml.
• Nếu ID không tồn tại bên plugin đang cài, hoặc server không cài cả ItemsAdder lẫn Oraxen, PhoBanX sẽ tự fallback về chữ mặc định và ghi cảnh báo ra console — không làm crash hay lỗi GUI.

Tuỳ chỉnh layout item bên trong (không cần ảnh nền)

Ngay cả khi không dùng ảnh nền, bạn vẫn tuỳ chỉnh được icon/vị trí item vanilla trong menu người chơi qua file plugins/PhoBanX/gui/gui.yml — mỗi menu định nghĩa bằng 1 "mask" ASCII 9 cột tương ứng slot trong inventory, mỗi ký tự map sang 1 item (material, tên, hành động):

menus:
  dungeon-list:
    title: "&8[&cPhoBanX&8] &7Chọn Phó Bản {page}/{max_page}"
    mask:
      - " C C C C C C C C C "
      - " C V D D D D D V C "
      - " # # # P # N # # # "
    items:
      'C': { material: CYAN_STAINED_GLASS_PANE, name: " " }
      'P': { material: SEA_PICKLE, name: "&c◀ Trang Trước", action: "PREV_PAGE" }
      'N': { material: SEA_PICKLE, name: "&aTrang Sau ▶", action: "NEXT_PAGE" }
    dungeon-item-format:
      material: CHEST
      name: "{dungeon_name}"

Sau khi sửa gui.yml, chạy /phoban admin reload để áp dụng.

➡️ Xem thêm: Cấu hình chung · Hướng dẫn Admin