Configuration

Cấu hình chung (config.yml)

File nằm ở plugins/PhoBanX/config.yml. Sau khi sửa, dùng lệnh /phoban admin reload để áp dụng ngay không cần restart server.

Khi cập nhật plugin lên bản mới có thêm cấu hình mới, PhoBanX tự động bổ sung các key còn thiếu vào file config.yml hiện tại của bạn mà không xoá phần bạn đã chỉnh — không cần xoá file cũ để tạo lại.

Bảng cấu hình đầy đủ

enabled: true

dungeon-timers:
  lobby-time: 60              # Thời gian chờ ở sảnh trước khi phó bản tự bắt đầu (giây)
  celebration-time: 30        # Thời gian ăn mừng/xem kết quả trước khi bị đẩy ra (giây)
  reconnect-grace-seconds: 180 # Thời gian chờ người chơi rớt mạng quay lại trước khi bị trừ mạng

anti-spam:
  enabled: true
  cooldowns:
    first-exit: 60           # Thoát lần 1: phạt cooldown 60s
    second-exit: 300         # Thoát lần 2: phạt 300s (5 phút)
    third-plus-exit: 1800    # Thoát lần 3 trở đi: phạt 1800s (30 phút)

difficulty-scaling:
  scale-by-players: true
  stat-scale-per-player-percent: 10.0   # Mỗi người chơi thêm vào phòng: +10% máu & sát thương quái

party:
  max-size: 4                 # Số thành viên tối đa 1 team
  invite-expire-seconds: 60   # Lời mời team tự hết hạn sau 60s

hooks:
  vault-economy: true

custom-gui:
  enabled: false               # Bật để dùng GUI custom (xem bên dưới)
  menus:
    dungeon-list: { id: "", offset: 0, text-offset: 0 }
    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 }

Giải thích chi tiết

dungeon-timers

• lobby-time: khi phòng tạo xong, người chơi sẽ đứng chờ ở sảnh bao lâu trước khi ải 1 tự bắt đầu. Đội trưởng (hoặc bất kỳ ai trong phòng) có thể ép bắt đầu sớm bằng /phoban start.
• reconnect-grace-seconds: nếu người chơi thoát game giữa trận, họ có khoảng thời gian này để /login lại và tự động được đưa về đúng vị trí. Hết thời gian mà chưa quay lại → bị trừ 1 mạng.

anti-spam

Chống việc người chơi vào-thoát phó bản liên tục để "né" cơ chế nào đó hoặc spam tạo phòng. Cooldown tăng dần theo số lần thoát tự nguyện (/phoban thoat), không áp dụng khi phòng tự kết thúc do thắng/thua.

difficulty-scaling

Tăng máu và sát thương quái theo số người trong phòng (không tính người chơi đầu tiên). Ví dụ với 10.0% và phòng 4 người: quái có 1 + 3×0.10 = 1.3x máu/damage so với phòng 1 người.

party

Giới hạn team để tránh phòng quá tải, và thời gian lời mời team tự hết hạn nếu không phản hồi.

custom-gui

Cho phép admin dùng GUI item pack/resource pack riêng (id item, offset slot) thay vì item vanilla mặc định cho các menu. Để enabled: false nếu bạn không có resource pack tuỳ chỉnh — plugin sẽ dùng giao diện vanilla mặc định trong gui/gui.yml.

---

Cấu hình từng phó bản (dungeons/<id>.yml)

Mỗi phó bản là 1 file YAML riêng trong plugins/PhoBanX/dungeons/. Bạn không cần sửa tay file này — mọi thứ chỉnh được qua GUI trong game (xem Hướng dẫn Admin). Phần dưới đây chỉ để tham khảo cấu trúc, hữu ích khi cần backup/restore hoặc debug.

display-name: "&c&lĐộng Nhện Độc"
description: "Vào hang nhện và tiêu diệt quái!"
max-waves: 1
max-players: 4
max-active-rooms: 5        # Số phòng cùng loại được mở song song tối đa
schematic-name: default    # Tên file .schem trong plugins/PhoBanX/schematics/
scale-difficulty: true

boss:
  manual-complete: false   # true = ải boss không tự kết thúc khi hết máu, phải trigger complete thủ công qua MythicMobs skill

rewards:
  limit: 0                 # 0 = không giới hạn số phần thưởng rớt ra cùng lúc
  global-chance: 100.0     # % cơ hội kích hoạt vòng roll thưởng
  victory-rewards:
    reward0:
      item: { material: EXPERIENCE_BOTTLE, name: "&e&lBình Kinh Nghiệm" }
      chance: 100.0
      commands: ["eco give %player% 5000"]
    reward1:
      item: { material: DIAMOND }
      chance: 50.0
      min-amount: 1
      max-amount: 3

player-spawn:
  enabled: true
  x: 60.6
  y: -38.0
  z: -58.5
  yaw: 0.0
  pitch: 0.0

mob-spawn-points:
  8585b0ae:
    wave: 1
    mob: CAVE_SPIDER      # Tên mob MythicMobs
    amount: 1
    x: 60.5
    y: -38.0
    z: -58.5
    boss: false

boss-mobs:
  "1": SkeletonKing        # Danh sách mob boss của từng ải, phân tách bằng dấu phẩy nếu nhiều boss

ticket:
  item: { material: DIAMOND }
  amount: 1

spawn:
  radius: 4.0               # Bán kính spawn ngẫu nhiên quanh điểm đặt (né spawn chồng nhau)
  interval-ticks: 5         # 20 tick = 1s. 0 = spawn hết quái ngay lập tức

➡️ Xem Vật phẩm tuỳ chỉnh để biết cú pháp item: hỗ trợ ItemsAdder/Oraxen/MMOItems như thế nào.