HUONG DAN CAU HINH COWQUEST-PREMIUM
===================================

CAU TRUC THU MUC
  config.yml     cai dat chung (chu nho, nhan nhiem vu, resource pack...)
  messages.yml   tin nhan
  gui.yml        toan bo giao dien (vat pham, vi tri slot, tieu de, chu)
  quests/*.yml   MOI NHOM NHIEM VU LA 1 FILE. Ten file = ID nhom.
                 Them file = them nhom. Xoa file = xoa nhom.
  data.yml       du lieu nguoi choi (dung sua tay khi server dang chay)
Sau khi sua file, go /nv reload.

FILE NHOM NHIEM VU (quests/<id>.yml)
  order                thu tu trong menu (so nho len truoc)
  name, color          ten nhom, mau (&a hoac &#RRGGBB)
  icon                 Material cua Minecraft (IRON_AXE...)
  custom-model-data    so model cho resource pack (0 = khong dung)
  enabled              true/false
  levels               so cap (mac dinh 26, GUI mac dinh hien toi da 28)
  description          danh sach dong mo ta
  permission           quyen can co de lam nhom nay (de "" = ai cung duoc)
  requires:            dieu kien mo khoa
    category: tieuphu
    level: 10          can hoan thanh cap 10 cua nhom tieuphu
  worlds               chi tinh tien do o cac the gioi nay ([] = tat ca)
  on-accept-commands   lenh chay khi nhan nhiem vu
  on-complete-commands lenh chay khi xong TAT CA cap
  objectives           danh sach muc tieu (ben duoi)
  rewards              text: dong hien thi | commands: lenh chay moi cap
  milestones           thuong them o cap chi dinh (text + commands)
  level-overrides      tuy chinh rieng tung cap (ben duoi)

MUC TIEU (objectives)
  type       BREAK  PLACE  KILL_MOB  KILL_PLAYER  KILL_PLAYER_RANDOM  FISH
             CRAFT  SMELT  BREED  CONSUME  ENCHANT
  label      ten hien thi
  targets    ten Material hoac EntityType. Ho tro "*_LOG" va ANY
             BREAK/PLACE/CRAFT/SMELT/CONSUME/ENCHANT/FISH dung ten Material
             KILL_MOB/BREED dung ten EntityType
  base       so luong can o cap dau tien cua muc tieu
  growth     so luong tang them moi cap
  amount     so luong CO DINH (bo qua base/growth)
  amounts    so luong rieng tung cap, vd:  amounts: {10: 50, 20: 120}
  min-level  chi xuat hien tu cap nay
  every      chi xuat hien o cac cap chia het cho so nay
  ripe-only  true = chi tinh cay trong da chin (BREAK)
  enabled    true/false
  So luong can = base + growth * (cap - min-level)

TUY CHINH TUNG CAP (level-overrides)
  level-overrides:
    10:
      name: "Cap 10 - Thu thach"
      icon: DIAMOND
      custom-model-data: 1001
      description: ["Dong mo ta rieng cua cap nay"]
      amount-multiplier: 1.5       nhan so luong cua moi muc tieu o cap nay
      objectives: [...]            THAY THE hoan toan muc tieu cua cap nay
      add-objectives: [...]        THEM muc tieu vao cap nay
      rewards:
        replace: false             true = bo phan thuong mac dinh moi cap
        text: ["&d+ 1 Ngoc ender"]
        commands: ["give %player% ender_pearl 1"]
  Trong objectives/add-objectives cua override nen dung "amount" (so co dinh).

BIEN TRONG LENH: %player%  %level%  %category%

GUI (gui.yml)
  - Moi nut co: slot, material, name, lore, custom-model-data, glow, amount.
  - Bien trong name/lore: {category} {category-bold} {level} {max-level}
    {percent} {bar} {status} {description} {objectives} {rewards} {level-name}
    {level-state} {player} {done} {total} ...
  - Lore chi co 1 {bien} va bien rong thi dong do bi bo.
  - Doi slot, doi vat pham, doi chu: sua truc tiep gui.yml roi /nv reload.

RESOURCE PACK
  Cach 1 - Dung font de ve nen menu (kieu GUI tuy chinh):
    1. Dung pack mau di kem (CowQuest-GUI-ResourcePack.zip), thay anh trong
       assets/cowquest/textures/gui/ bang thiet ke cua ban (256x256).
    2. Ky tu \uE000 = main.png, \uE001 = category.png (xem font/default.json).
    3. Trong gui.yml dat title co ky tu do (xem dong mau trong file), dat
       fill.pattern: none va doi cac vat pham trang tri thanh material: AIR.
    4. Anh phai co o trong suot tai cac slot cua menu (vat pham nam duoi lop anh).
    5. Neu lech vi tri, chinh cac ky tu dich chuyen \uF8xx trong title.
       \uF801=-1 \uF802=-2 \uF804=-4 \uF808=-8 \uF810=-16 \uF820=-32 \uF840=-64
       \uF880=-128 \uF8A0=-256 | \uF901=+1 \uF902=+2 \uF904=+4 \uF908=+8 ...
  Cach 2 - Dung custom-model-data cho vat pham:
    Dat custom-model-data cho nut trong gui.yml, cho nhom/cap trong quests/*.yml,
    roi ghep model tuong ung trong resource pack cua ban.
  Gui pack tu dong: config.yml muc resourcepack (url, sha1, force).
  Lenh gui lai pack: /nv pack
  pack_format cua pack mau la 34 (Minecraft 1.21 - 1.21.1).

LENH
  /nv  /nhiemvu  /quest        mo menu
  /nv nhan <nhom>              nhan nhiem vu
  /nv huy <nhom>               huy nhiem vu (mat tien do cap hien tai)
  /nv pack [nguoi choi]        gui resource pack
  /nv reload                   tai lai cau hinh        (cowquest.admin)
  /nv reset <nguoi choi> [nhom]                        (cowquest.admin)
  /nv setlevel <nguoi choi> <nhom> <cap>               (cowquest.admin)


PHAN THUONG TUNG CAP (level-rewards)
  Moi cap co the co phan thuong rieng. Cac file nhom mac dinh da liet ke san 26 cap.
  level-rewards:
    1:
      text: ["&a+ 1 Ngoc luc bao"]          dong hien thi trong menu
      commands: ["give %player% emerald 1"]  lenh chay khi xong cap
    2: ...
  - Cap co trong level-rewards se THAY phan thuong chung ("rewards") o cap do.
  - Cap khong liet ke se dung "rewards" chung.
  - milestones van dung duoc (cong THEM vao phan thuong cua cap).
  - level-overrides.<cap>.rewards co the cong them hoac thay (replace: true).

BANG XEP HANG (TOP)
  /nv top           top 10 theo tong so cap da hoan thanh
  /nv top <nhom>    top 10 cua 1 nhom (vd /nv top tieuphu)
  Diem = so cap da hoan thanh. Du lieu cache 10 giay.

HOLOGRAM BANG XEP HANG
  Cach 1 - Hologram co san (khong can plugin khac, dung TextDisplay):
    /nv holo create <ten> [nhom]   tao tai cho ban dang dung (bo trong nhom = top tong)
    /nv holo move <ten>            chuyen den cho ban dang dung
    /nv holo remove <ten>
    /nv holo list
    Giao dien chinh trong config.yml muc hologram (tieu de, dong, so dong, thoi gian cap nhat).
  Cach 2 - PlaceholderAPI (DecentHolograms, FancyHolograms, HolographicDisplays...):
    Cai PlaceholderAPI, sau do dung cac bien:
      %cowquest_top_1_name%            ten nguoi hang 1 (tong)
      %cowquest_top_1_value%           so cap cua hang 1
      %cowquest_top_tieuphu_1_name%    ten nguoi hang 1 cua nhom tieuphu
      %cowquest_top_tieuphu_1_value%
      %cowquest_total%                 tong cap cua nguoi choi
      %cowquest_rank%                  hang cua nguoi choi (0 = chua co)
      %cowquest_active%                so nhom dang lam
      %cowquest_level_<nhom>%          cap hien tai cua nhom
      %cowquest_done_<nhom>%           so cap da xong cua nhom
      %cowquest_percent_<nhom>%        phan tram hoan thanh nhom
