Lewati ke konten
RankForge LogoRankForge

Troubleshooting RankForge – Masalah Umum & Solusinya

Aktifkan settings.debug-mode: true di config.yml lalu /rankforge reload untuk melihat log [DEBUG] saat menelusuri masalah.

Plugin tidak load / UnsupportedClassVersionError

Section titled “Plugin tidak load / UnsupportedClassVersionError”

RankForge butuh Java 21+. Cek java -version. Di hosting panel, pilih image/Java 21 di pengaturan server.

Placeholder tampil mentah (%rankforge_points%)

Section titled “Placeholder tampil mentah (%rankforge_points%)”
  1. Pastikan PlaceholderAPI terpasang dan aktif. Log RankForge harus menampilkan PlaceholderAPI hooked successfully.
  2. Tes dengan /papi parse me %rankforge_points%. Jika ini bekerja tetapi plugin lain tidak, masalahnya ada di plugin tersebut (belum mendukung PlaceholderAPI di bagian itu).
  3. Restart server (bukan /reload) setelah memasang PlaceholderAPI.

Poin tidak bertambah saat membunuh

Section titled “Poin tidak bertambah saat membunuh”
  • Kill hanya dihitung jika korban dibunuh oleh pemain lain (getKiller()). Mati sendiri atau oleh mob tidak memberi poin ke siapa pun; korban tetap kehilangan poin.
  • Cek batas harian: settings.daily-limit.max-kills. Setelah tercapai, kill tidak memberi poin sampai hari berikutnya.
  • Cek settings.fixed-points.per-kill bukan 0.

Reward tier tidak diberikan

Section titled “Reward tier tidak diberikan”
  • Reward hanya dicek setelah membunuh. Mengubah poin dengan /rankforge setpoints atau lewat API tidak menjalankan reward tier.
  • Reward hanya sekali per tier per pemain. Jika sebelumnya sudah di-claim, tidak akan diulang.
  • Command reward dijalankan di console. Cek log untuk Unknown command. Default memakai eco give, ganti dengan command economy plugin kamu.

Database gagal, data tersimpan di JSON

Section titled “Database gagal, data tersimpan di JSON”

Log menampilkan Failed to initialize database (...) dan Falling back to local JSON storage. Periksa:

  • Host, port, nama database, username, dan password.
  • Database sudah dibuat dan user punya izin CREATE, INSERT, UPDATE, SELECT.
  • Firewall mengizinkan koneksi dari server Minecraft.
  • Penulisan database.type benar. Nilai tidak dikenal otomatis menjadi JSON.

Setelah diperbaiki, restart server. Data yang tertulis ke players.json saat fallback tidak otomatis dipindah ke database.

Perubahan config.yml tidak berlaku

Section titled “Perubahan config.yml tidak berlaku”

Jalankan /rankforge reload. Pengecualian: database.* dan settings.data-save.delay-seconds butuh restart.

Pencarian pemain di leaderboard tidak membuka papan

Section titled “Pencarian pemain di leaderboard tidak membuka papan”

Lihat log startup RankForge soal PacketEvents. Tanpa PacketEvents, pencarian otomatis memakai chat. Detail di PacketEvents.

Nama pemain tampil Unknown

Section titled “Nama pemain tampil Unknown”

Record dibuat lewat API untuk UUID yang belum pernah join. Nama akan terisi saat pemain tersebut join. Hindari menulis poin untuk UUID yang belum dikenal.

Tablist saling menimpa

Section titled “Tablist saling menimpa”

Jika memakai TAB atau plugin tablist lain, atur format di salah satunya saja. Lihat TAB & DecentHolograms.

Warna hex tidak muncul

Section titled “Warna hex tidak muncul”
  • Pastikan formatnya benar: <#RRGGBB>teks</#RRGGBB> (gradient) atau &#RRGGBB, 6 digit hex.
  • Plugin lain yang menerima teks dari RankForge harus mendukung warna hex.
  • Pakai %rankforge_rank_plain% jika target tidak mendukung warna.