Diagnosis lag & auto-tune

Temukan chunk dan plugin penyebab lag, lihat riwayat performa, terima notifikasi lag, dan biarkan auto-tune menurunkan beban saat server berat.

Di halaman ini

Saat pemain bilang "server lag", halaman ini membantu Anda menjawab dua pertanyaan: di mana lag terjadi dan apa penyebabnya. Semua alat di sini hanya mengukur; tidak ada yang mengubah gameplay kecuali auto-tune dan lag shield yang harus Anda nyalakan sendiri.

Alur cepat saat server lag

  1. Cek kondisi sekarang dengan nusa status.
  2. Ukur penyebabnya dengan nusa lagchunks start 30.
  3. Baca laporan: chunk paling berat dan plugin paling berat.
  4. Datangi chunk itu dengan /nusa lagchunks tp 1 dan periksa isinya (farm, hopper, mob menumpuk).
  5. Jika lag sering berulang, lihat polanya dengan nusa perf dan nusa lagspikes.

Mencari chunk dan plugin berat (/nusa lagchunks)

nusa lagchunks start 30
nusa lagchunks status
nusa lagchunks report 20
PerintahFungsi
/nusa lagchunks start [detik]Mulai mengukur selama 5–300 detik (default 30)
/nusa lagchunks statusMelihat progres pengukuran
/nusa lagchunks stopMenghentikan pengukuran lebih awal
/nusa lagchunks report [baris]Menampilkan ulang laporan terakhir (maksimal 50 baris)
/nusa lagchunks tp <peringkat>Teleport ke chunk dari laporan terakhir
/nusa lagchunks history [n]Laporan-laporan sebelumnya, tetap ada setelah restart

Setiap baris laporan menunjukkan world dan chunk, waktu per tick (ms/tick), persentase dari total waktu yang diukur, kategori yang paling dominan, dan jenis yang paling mahal di chunk itu, misalnya minecraft:hopper.

Yang diukur: tick entity, tick block entity (hopper, furnace, dan sejenisnya), tick blok dan fluida terjadwal, random tick, dan spawn mob alami. Loading chunk dan jaringan tidak dihitung per chunk.

Laporan juga punya bagian Plugins: waktu yang dipakai setiap plugin untuk task terjadwal dan listener event, lengkap dengan task atau event yang paling mahal.

Riwayat performa (/nusa perf dan /nusa lagspikes)

  • /nusa perf menampilkan kondisi sekarang, satu jam terakhir, dan satu hari terakhir: TPS, rata-rata dan puncak MSPT, puncak pemain, entity, chunk yang dimuat, dan jumlah lonjakan lag.
  • /nusa lagspikes [halaman] menampilkan setiap lonjakan lag dari yang terbaru: kapan, puncaknya, berapa lama, dan penyebabnya.
  • /nusa lagspikes info <n> menampilkan detail satu lonjakan, dan /nusa lagspikes tp <n> membawa Anda ke chunk paling berat saat itu.

Riwayat disimpan di nusa-perf/history.json (24 jam terakhir dan 100 lonjakan terakhir), jadi tetap ada setelah restart.

Notifikasi lag untuk staf

Staf dengan izin nusaspigot.alerts (default OP) mendapat pesan di chat:

  1. Saat lag mulai: rata-rata ms per tick, TPS, dan apakah penyebabnya sedang diukur.
  2. Saat pengukuran selesai: penyebab utama dan porsinya, chunk dan plugin paling berat, dengan tombol Teleport, Full report, dan Details.
  3. Saat server pulih: berapa lama lag berlangsung dan puncaknya.

Ketik /nusa alerts off untuk mematikan notifikasi bagi Anda sendiri sampai restart berikutnya, dan /nusa alerts on untuk menyalakannya lagi.

Auto-tune: menurunkan beban otomatis

Auto-tune mati secara default karena pemain bisa merasakan efeknya. Saat dinyalakan, ia menurunkan beban server sedikit demi sedikit ketika server berat, lalu mengembalikannya setelah pulih.

Urutan langkahnya, dari yang paling tidak terasa oleh pemain:

  1. Mengurangi jangkauan aktivasi entity (mob jauh lebih jarang di-tick).
  2. Mengurangi simulation distance.
  3. Mengurangi view distance.

Auto-tune tidak pernah turun di bawah batas minimum yang Anda atur, dan tidak pernah mengubah server.properties atau spigot.yml. Saat level kembali ke 0 (atau saat shutdown), setiap world mendapatkan nilai aslinya lagi.

nusa autotune
nusa autotune on
nusa autotune off
  • nusa autotune menampilkan level saat ini, ambang batas, batas minimum, perubahan terakhir, serta nilai sekarang dan nilai asli tiap world.
  • nusa autotune on menyalakan auto-tune tanpa mengubah file konfigurasi (berlaku sampai restart).
  • nusa autotune off mengembalikan semua world ke nilai asli dan menghentikan auto-tune sampai restart.

Default ambang batasnya: turun satu langkah setelah 10 detik berturut-turut di 45 ms atau lebih, naik satu langkah setelah 60 detik berturut-turut di 35 ms atau kurang.

Langkah berikutnya

Dokumentasi produk Nusa · NusaSpigotFork Paper · Java 21 / 25

Memuat indeks…