Konfigurasi Tier, Rank & Reward di RankForge

Tier didefinisikan di section tiers: pada config.yml. Setiap tier punya ID unik (key YAML) dan satu ambang poin.

Struktur tier

tiers:
  lt_5:
    min: 100
    display: "<#CCCCCC>LT5</#999999>"
    sound: "ENTITY_PLAYER_LEVELUP"
    title:
      main: "&a&lRANK UP!"
      sub: "&7You have advanced to <#CCCCCC>LT5</#999999>"
    rewards:
      - "eco give <player> 10000"

Key	Wajib	Keterangan
ID (lt_5)	Ya	Dipakai di %rankforge_rank_id% dan untuk mencatat reward yang sudah di-claim. Jangan diganti setelah ada pemain yang meng-claim.
min	Ya	Poin minimal untuk masuk tier ini.
display	Disarankan	Nama tampil. Mendukung hex & gradient. Jika kosong, ID dipakai.
sound	Tidak	Nama enum Sound Bukkit, mis. ENTITY_PLAYER_LEVELUP. Jika kosong, dipakai ENTITY_PLAYER_LEVELUP. Jika namanya tidak valid, sound dilewati tanpa error.
title.main / title.sub	Tidak	Title & subtitle layar saat promosi. Dilewati jika main kosong.
rewards	Tidak	Daftar command konsol. Placeholder: <player>.

Aturan penting

1. Urutan di file tidak masalah. RankForge mengurutkan tier berdasarkan min dari tinggi ke rendah saat load.

2. Tier = tier tertinggi dengan min ≤ poin. Pemain dengan poin di bawah min terendah dianggap Unranked (%rankforge_rank% menampilkan Unranked, %rankforge_rank_id% menampilkan none).

3. Reward hanya sekali per tier per pemain. ID tier dicatat di data pemain setelah reward diberikan. Poin naik-turun tidak mengulang reward.

4. Promosi dicek setelah pemain membunuh lawan. Reward, title, sound, dan broadcast messages.tier-up dijalankan pada saat itu.

5. Command reward berjalan di console. Pastikan command valid dan aman.

Tier-up lewat command atau API

/rankforge setpoints mengubah poin tanpa menjalankan reward tier. Reward otomatis hanya dicek pada alur kill. Kalau kamu butuh reward untuk perubahan poin dari plugin lain, pakai event PlayerTierUpEvent dari Developer API.

Contoh: menambah tier baru

tiers:
  # ... tier lain ...
  master:
    min: 8000
    display: "<#B388FF>&lMASTER</#7C4DFF>"
    sound: "UI_TOAST_CHALLENGE_COMPLETE"
    title:
      main: "<#B388FF>&lMASTER!</#7C4DFF>"
      sub: "&7Kamu mencapai tier <#B388FF>MASTER</#7C4DFF>"
    rewards:
      - "broadcast &6<player> &emencapai tier MASTER!"
      - "give <player> diamond 16"

Lalu jalankan /rankforge reload.

Contoh: reward ke LuckPerms group

rewards:
  - "lp user <player> parent add pvp-elite"

Tier di tablist

RankForge menampilkan badge tier di tablist dengan format NamaPemain <display tier>. Diperbarui saat pemain join dan saat poinnya berubah karena kill/death. Kalau kamu memakai plugin TAB, lihat TAB & DecentHolograms untuk mengatur format sendiri.