Tabel lengkap semua key
Daftar lengkap seluruh key pengaturan, nilai default, batas angka, dan penjelasan singkat di nusa-global.yml.
Di halaman ini
- Indeks cepat semua key
- Feature flags (feature-flags.)
- Optimasi Bedrock & Geyser (bedrock-optimization.)
- Entity, hopper & AI (entity-behavior., hopper-tick-spreading.)
- Tick budget, world & PvP (tick-budgets., world-mechanics., pvp-mechanics.)
- Penyimpanan & async I/O (async-chunk-io., region-file-compression., async-playerdata-save.)
- Jaringan & hub ramai (hub-networking., combat-priority-override., networking.)
- Pre-generasi world (pre-generation.)
- Keamanan & pelindung paket (security.)
- Dashboard & notifikasi Discord (management.)
Tekan Ctrl K (atau klik tombol cari di bagian atas) untuk langsung melompat ke nama key mana saja, atau telusuri per kategori di bawah ini. Seluruh pengaturan berada di nusa-global.yml dan aktif setelah restart penuh.
Indeks cepat semua key
176 opsi pengaturan di nusa-global.yml. Klik key mana saja untuk melihat penjelasan lengkapnya di bawah.
Feature flags (feature-flags.*)
Saklar utama untuk menyalakan atau mematikan masing-masing modul NusaSpigot.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
feature-flags.async-chunk-io | booleantrue | true / false | Memindahkan baca/tulis file region chunk ke worker I/O terpisah agar main thread tidak tertahan disk.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.region-file-compression | booleantrue | true / false | Menyimpan sector region baru dengan kompresi Zstandard (zstd) yang hemat ruang. Matikan sebelum pindah balik ke Paper murni.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.async-playerdata-save | booleantrue | true / false | Menyimpan data NBT pemain di background setelah snapshot diambil di main thread.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.ai-precompute-queue | booleantrue | true / false | Menghitung kandidat target mob di background dari snapshot tanpa mengubah AI di main thread.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.entity-tracking-culling | booleantrue | true / false | Menyembunyikan paket entity yang tertutup tembok padat agar hemat bandwidth dan CPU client.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.hopper-tick-spreading | booleantrue | true / false | Menyebar pengecekan hopper menganggur ke beberapa grup tick supaya farm besar tidak membebani satu tick.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.entity-behavior-switches | booleantrue | true / false | Saklar utama pengatur perilaku mob, preset HUB, brain scaling, dan sensor cadence.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.nbt-packet-validation | booleantrue | true / false | Memeriksa ukuran dan kedalaman NBT paket masuk sebelum dibaca server untuk mencegah item crash.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.crash-pattern-guard | booleantrue | true / false | Memblokir ukuran custom payload berlebih dan pola paket exploit yang didaftarkan.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.packet-flood-detection | booleantrue | true / false | Membatasi lonjakan jumlah paket per detik dari satu koneksi pemain.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.tick-starvation-guard | booleantrue | true / false | Membatasi jatah waktu main thread untuk memproses paket dari satu pemain di tiap tick.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.redstone-abuse-limiter | booleantrue | true / false | Menahan lonjakan update redstone ekstrem per chunk agar mesin lag tidak menjatuhkan TPS.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.miscellaneous-security | booleantrue | true / false | Mengaktifkan proteksi NBT blok yang dipasang dan pembatas request mod World Downloader.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.netty-native-transport | booleantrue | true / false | Memakai transport jaringan native OS (seperti epoll di Linux) bila tersedia.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.chunk-compression-batching | booleantrue | true / false | Mengelompokkan pengiriman paket chunk agar kompresi dan flush jaringan lebih efisien.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.netty-tuning | booleantrue | true / false | Menerapkan tuning socket rendah latensi (flush consolidation, IP_TOS, TCP FastOpen).Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.pre-generation | booleantrue | true / false | Mengaktifkan fitur dan perintah pre-generasi world pintar (/nusa pregen).Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.shared-packet-encoding | booleantrue | true / false | Mengencode paket broadcast sekali lalu memakai ulang buffernya untuk banyak pemain.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.tiered-entity-updates | booleantrue | true / false | Mengurangi frekuensi update gerak pemain yang jauh di area ramai seperti lobby.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.batch-tab-list | booleantrue | true / false | Menggabungkan update tab list cepat ke jendela waktu singkat agar tidak membanjiri paket.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.pooled-broadcast-buffers | booleantrue | true / false | Memakai ulang buffer memori langsung untuk broadcast ke banyak pemain.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.tuning-wizard | booleantrue | true / false | Mengaktifkan panduan profil dan pengarahan setup (/nusa setup).Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.live-dashboard | booleantrue | true / false | Mengaktifkan pemantauan metrik langsung (/nusa status dan panel in-game /nusa gui).Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
feature-flags.discord-webhook | booleanfalse | true / false | Mengirim notifikasi TPS rendah atau peringatan keamanan ke webhook Discord privat Anda.Berlaku saat: startup; dilewati sementara saat /nusa safemode on (kecuali manajemen) |
Optimasi Bedrock & Geyser (bedrock-optimization.*)
Deteksi otomatis pemain Floodgate/Geyser, toleransi anti-setback di tangga/slab, batas partikel HP, dan pengaturan kirim chunk.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
bedrock-optimization.enabled | booleantrue | true / false | Saklar utama optimasi anti-setback, hemat partikel, dan pacing chunk untuk pemain Bedrock (Geyser/Floodgate).Berlaku saat: startup |
bedrock-optimization.detect-floodgate-uuid | booleantrue | true / false | Mendeteksi pemain Bedrock secara otomatis dari format UUID XUID Floodgate.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.detect-geyser-brand | booleantrue | true / false | Mendeteksi pemain Bedrock secara otomatis dari identitas client brand Geyser.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.username-prefix | string. | 0..16 karakter ASCII tanpa spasi | Awalan nama pemain Floodgate sebagai cadangan deteksi Bedrock (kosongkan untuk mematikan pencocokan prefix).Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.moved-wrongly-multiplier | number2.5 | 1..16 kali | Melonggarkan batas moved-wrongly khusus pemain Bedrock agar tidak mudah rubberband di tangga, slab, atau karpet.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.moved-too-quickly-multiplier | number1.5 | 1..10 kali | Melonggarkan batas gerak cepat pemain Bedrock untuk menoleransi jitter koneksi seluler RakNet.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.extra-floating-tolerance-ticks | integer40 | 0..400 tick | Tambahan toleransi waktu melayang sebelum kick bagi pemain Bedrock di tepi blok tipis.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.near-distance | number6 | >0..4096 blok | Jarak dekat tempat pemain Bedrock selalu menerima update posisi entity setiap tick.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.far-entity-update-interval | integer6 | 1..20 tick | Jeda tick pengiriman update posisi entity jauh ke pemain Bedrock agar HP tidak panas dan Geyser lebih ringan.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.cull-micro-rotation-updates | booleantrue | true / false | Melewati pengiriman putaran kepala kecil (< 5,6 derajat) untuk entity yang jauh dari pemain Bedrock.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.max-particles-per-packet | integer16 | 1..1024 partikel | Batas jumlah partikel per paket ke pemain Bedrock untuk mencegah FPS drop di HP.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.max-particle-distance | number24 | >0..512 blok | Jarak pandang maksimal partikel biasa yang dikirim ke pemain Bedrock.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.max-chunks-per-tick | number2 | 0.25..64 chunk/tick | Batas pengiriman chunk per tick ke pemain Bedrock agar translasi chunk Geyser mulus tanpa freeze.Berlaku saat: bedrock-optimization.enabled |
bedrock-optimization.tab-window-millis | integer400 | 50..2000 ms | Jendela penggabungan update tab list khusus pemain Bedrock agar UI layar sentuh tidak tersendat.Berlaku saat: bedrock-optimization.enabled |
Entity, hopper & AI (entity-behavior.*, hopper-tick-spreading.*)
Antrean worker AI/culling, jeda hopper penuh, preset DEFAULT/HUB, penghematan AI mob jauh, Brain distance scaling, dan sensor cadence.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
ai-precompute-queue.threads | integer0 | 0..256 thread | Jumlah worker thread (0 = otomatis hingga 4 thread sesuai CPU).Berlaku saat: feature-flags.ai-precompute-queue |
ai-precompute-queue.max-queued | integer256 | 1..65536 pekerjaan | Batas antrean per tick. Jika penuh, server otomatis memakai jalur standar tanpa error.Berlaku saat: feature-flags.ai-precompute-queue |
entity-tracking-culling.threads | integer0 | 0..256 thread | Jumlah worker thread (0 = otomatis hingga 4 thread sesuai CPU).Berlaku saat: feature-flags.entity-tracking-culling |
entity-tracking-culling.max-queued | integer256 | 1..65536 pekerjaan | Batas antrean per tick. Jika penuh, server otomatis memakai jalur standar tanpa error.Berlaku saat: feature-flags.entity-tracking-culling |
ai-precompute-queue.max-candidates | integer128 | 1..4096 kandidat | Jumlah maksimal kandidat target yang diperiksa per mob di snapshot.Berlaku saat: feature-flags.ai-precompute-queue |
ai-precompute-queue.exclude-mob-types | list[] | ID namespaced, contoh minecraft:zombie | Daftar tipe mob yang dikecualikan agar memakai pencarian target vanilla.Berlaku saat: feature-flags.ai-precompute-queue |
entity-tracking-culling.max-ray-blocks | integer128 | 1..1024 blok | Jarak maksimal pengecekan garis pandang tembok untuk culling entity.Berlaku saat: feature-flags.entity-tracking-culling |
entity-tracking-culling.max-snapshot-boxes | integer1024 | 1..16384 kotak | Batas kotak blok pada snapshot visibilitas. Biarkan default untuk penggunaan umum.Berlaku saat: feature-flags.entity-tracking-culling |
hopper-tick-spreading.groups | integer4 | 1..64 grup | Membagi jadwal cek hopper idle ke beberapa grup tick (1 = tanpa pembagian).Berlaku saat: feature-flags.hopper-tick-spreading |
hopper-tick-spreading.full-container-backoff-ticks | integer5 | 0..600 tick | Jeda tunggu hopper saat chest tujuan penuh sebelum mencoba lagi (naikkan ke 8 untuk server penuh hopper).Berlaku saat: feature-flags.hopper-tick-spreading |
entity-behavior.mob-tracker | booleantrue | true / false | Menampilkan mob ke client pemain. Jika false, mob tetap ada di server tetapi tidak terlihat.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.entity-collision | booleantrue | true / false | Mengaktifkan dorong-mendorong antar-entity. Matikan di lobby ramai untuk menghemat CPU.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.mob-ai | booleantrue | true / false | Saklar utama otak, navigasi, dan pergerakan AI semua mob.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.mob-item-pickup | booleantrue | true / false | Mengizinkan mob mengambil item jatuh di tanah dan memakai equipment.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.baby-mob-spawn-from-spawners | booleantrue | true / false | Mengizinkan monster spawner memunculkan varian mob bayi.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.mob-spawning | booleantrue | true / false | Mengaktifkan kemunculan mob alami. Spawner, command, dan plugin tetap punya aturan sendiri.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.chunk-ticking | booleantrue | true / false | Mengaktifkan random tick tanaman, air/lava terjadwal, dan block entity di chunk aktif.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.weather-ticking | booleantrue | true / false | Mengaktifkan siklus perubahan hujan dan petir otomatis.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
entity-behavior.villager-ticking | booleantrue | true / false | Mengaktifkan AI, pekerjaan, dan restock villager. Matikan hanya pada lobby statis.Berlaku saat: feature-flags.entity-behavior-switches; preset HUB mematikan 5 opsi otomatis |
tuning-preset | stringDEFAULT | DEFAULT / HUB | DEFAULT memakai pengaturan normal untuk SMP/gamemode. HUB otomatis mematikan collision, mob spawn alami, chunk tick, cuaca, dan villager untuk server lobby.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.ticking-mode | stringVANILLA | VANILLA / OPTIMIZED / EXTRA_OPTIMIZED | Tingkat penghematan evaluasi AI mob jauh. Gunakan OPTIMIZED untuk SMP ramai tanpa merusak perilaku mob dekat.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.goal-selector-throttle.enabled | booleantrue | true / false | Mengizinkan perlambatan evaluasi ulang AI untuk mob yang jauh saat mode OPTIMIZED aktif.Berlaku saat: ticking-mode bukan VANILLA |
entity-behavior.goal-selector-throttle.interval | integer4 | 1..600 tick | Jeda tick antar evaluasi AI untuk mob jauh (EXTRA_OPTIMIZED memakai 2x nilai ini).Berlaku saat: goal-selector-throttle aktif |
entity-behavior.goal-selector-throttle.min-player-distance | number32 | >0..4096 blok | Jarak minimal dari pemain terdekat sebelum AI mob mulai dihemat.Berlaku saat: goal-selector-throttle aktif |
entity-behavior.skip-idle-goal-ticks | booleantrue | true / false | Melewati pengecekan AI dan target saat entity sedang berstatus inaktif/jauh.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.brain-distance-scaling.enabled | booleantrue | true / false | Menyesuaikan frekuensi sensor AI Brain (villager, piglin, warden, dll.) berdasarkan jarak ke pemain.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.brain-distance-scaling.near-radius | number12 | >0..4096 blok | Jarak dekat dari pemain tempat mob Brain selalu berpikir penuh setiap tick.Berlaku saat: entity-behavior.brain-distance-scaling.enabled |
entity-behavior.brain-distance-scaling.max-interval | integer20 | 1..600 tick | Jeda maksimal antar update sensor Brain untuk mob yang sangat jauh.Berlaku saat: entity-behavior.brain-distance-scaling.enabled |
entity-behavior.brain-distance-scaling.distance-shift | integer9 | 1..20 tingkat | Pengatur seberapa cepat jeda Brain membesar seiring kuadrat jarak (default 9 seimbang).Berlaku saat: entity-behavior.brain-distance-scaling.enabled |
entity-behavior.sensor-cadence.water-check-interval | integer1 | 1..20 tick | Jeda tick pengecekan status air pada entity non-player (naikkan ke 4 jika entity sangat padat).Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.eye-fluid-interval | integer1 | 1..20 tick | Jeda tick pengecekan cairan di posisi mata entity non-player.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.equipment-sync-interval | integer1 | 1..20 tick | Jeda tick pemindaian perubahan armor/item pada mob.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.line-of-sight-interval | integer1 | 1..40 tick | Jeda tick pembersihan cache garis pandang mob (4–10 cocok untuk SMP ramai mob).Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.turtle-helmet-effect | booleantrue | true / false | Memproses efek pasif Water Breathing dari Turtle Helmet pemain.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.dolphin-treasure-seek | booleanfalse | true / false | Mengaktifkan AI lumba-lumba mencari harta karun (default false karena pencarian struktur bisa memicu lag spike).Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.waypoint-locator-bar | booleantrue | true / false | Mengaktifkan sistem bar penunjuk lokasi pemain (Waypoint Locator 1.21.6+).Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.powder-snow-freezing | booleantrue | true / false | Memeriksa efek beku powder snow pada entity non-player.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.wall-suffocation-check | booleantrue | true / false | Memeriksa damage terjepit tembok pada entity non-player setiap tick.Berlaku saat: feature-flags.entity-behavior-switches |
entity-behavior.sensor-cadence.player-only-pushing | booleanfalse | true / false | Jika true, hanya pemain yang bisa mendorong entity sehingga kerumunan mob di farm tidak saling dorong.Berlaku saat: feature-flags.entity-behavior-switches |
Tick budget, world & PvP (tick-budgets.*, world-mechanics.*, pvp-mechanics.*)
Batas penggabungan item jatuh/proyektil per tick, aturan world & partikel, batas damage Mace, opsi PvP 1.8, dan knockback kustom.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
tick-budgets.item-merge-scans-per-tick | integer150 | 1..100000 scan/tick | Batas penggabungan tumpukan item jatuh di seluruh server per tick agar ledakan drop tidak membekukan tick.Berlaku saat: startup |
tick-budgets.projectile-chunk-loads-per-tick | integer10 | 1..10000 chunk/tick | Batas total chunk baru yang boleh dimuat oleh seluruh proyektil terbang per tick.Berlaku saat: startup |
tick-budgets.projectile-max-chunk-loads | integer10 | 1..10000 chunk | Batas maksimal chunk yang boleh dimuat satu proyektil sebelum dihapus otomatis.Berlaku saat: startup |
tick-budgets.vehicle-collision-stack-limit | integer0 | 0..1000 kendaraan | Menghapus tumpukan minecart/boat berlebih di satu titik (0 = nonaktif; isi 10 untuk cegah mesin lag boat/minecart).Berlaku saat: startup |
world-mechanics.persist-transient-projectiles | booleanfalse | true / false | Menyimpan snowball dan firework ke disk saat chunk unload (default false agar bebas mesin lag proyektil).Berlaku saat: startup |
world-mechanics.suppress-zero-velocity-packets | booleantrue | true / false | Melewati pengiriman paket velocity saat perubahan knockback bernilai nol.Berlaku saat: startup |
world-mechanics.suppress-immune-fire-packets | booleantrue | true / false | Menyembunyikan paket efek api visual jika target memiliki Fire Resistance.Berlaku saat: startup |
world-mechanics.advancement-criterion-triggers | booleantrue | true / false | Menjalankan pengecekan progres Advancement pemain. Matikan hanya pada server minigame/lobby yang tidak memakai advancement.Berlaku saat: startup |
world-mechanics.compact-death-drops | booleanfalse | true / false | Mengumpulkan item drop kematian pemain di satu titik rapi agar tidak terpental jauh.Berlaku saat: startup |
world-mechanics.bypass-chest-top-obstruction | booleanfalse | true / false | Mengizinkan pemain membuka chest meskipun tertutup blok padat di atasnya.Berlaku saat: startup |
world-mechanics.spawner-check-spawn-rules | booleantrue | true / false | Mengecek syarat cahaya dan biome sebelum spawner memunculkan mob (false cocok untuk grinder Skyblock/Prison).Berlaku saat: startup |
world-mechanics.visual-effects.fall-impact-particles | booleantrue | true / false | Mengirim partikel debu saat entity jatuh mendarat di blok. Matikan untuk mengurangi paket partikel.Berlaku saat: startup |
world-mechanics.visual-effects.death-poof-particles | booleantrue | true / false | Mengirim partikel asap putih saat entity mati. Matikan untuk mengurangi paket partikel.Berlaku saat: startup |
world-mechanics.visual-effects.water-splash-particles | booleantrue | true / false | Mengirim partikel cipratan saat entity masuk ke air. Matikan untuk mengurangi paket partikel.Berlaku saat: startup |
world-mechanics.visual-effects.bubble-column-particles | booleantrue | true / false | Mengirim partikel cipratan kolom gelembung air. Matikan untuk mengurangi paket partikel.Berlaku saat: startup |
world-mechanics.visual-effects.spawner-flame-particles | booleantrue | true / false | Mengirim partikel api dan asap dari blok monster spawner. Matikan untuk mengurangi paket partikel.Berlaku saat: startup |
pvp-mechanics.allow-sprint-criticals | booleanfalse | true / false | Mengizinkan serangan critical hit sambil tetap berlari sprint (gaya PvP 1.8).Berlaku saat: startup |
pvp-mechanics.fishing-hook-pull-entities | booleantrue | true / false | Menarik entity yang terkait kail pancing saat pancing ditarik kembali.Berlaku saat: startup |
pvp-mechanics.fishing-hook-knockback | booleanfalse | true / false | Memberi knockback dan efek pukul saat kail pancing mengenai entity hidup (gaya rod PvP).Berlaku saat: startup |
pvp-mechanics.ignore-netherite-kb-resistance | booleanfalse | true / false | Mengabaikan ketahanan knockback bawaan armor Netherite saat duel PvP.Berlaku saat: startup |
pvp-mechanics.mace.fall-distance-cap | number-1 | -1.0 atau >0..4096 blok | Batas jarak jatuh maksimal yang dihitung untuk damage senjata Mace (-1.0 = tanpa batas; contoh 30.0 cegah one-shot trap).Berlaku saat: startup |
pvp-mechanics.mace.flatten-fall-scaling | booleanfalse | true / false | Menonaktifkan bonus damage jarak jatuh Mace sepenuhnya.Berlaku saat: startup |
pvp-mechanics.knockback.custom-profile | booleanfalse | true / false | Mengaktifkan pengali knockback horizontal, vertikal, dan friksi kustom di bawah ini.Berlaku saat: startup |
pvp-mechanics.knockback.horizontal | number0.4 | 0..10 nilai | Kekuatan dorongan knockback mendatar (horizontal).Berlaku saat: pvp-mechanics.knockback.custom-profile |
pvp-mechanics.knockback.vertical | number0.4 | 0..10 nilai | Angkatan knockback ke atas saat target berpijak di tanah.Berlaku saat: pvp-mechanics.knockback.custom-profile |
pvp-mechanics.knockback.vertical-limit | number0.4 | 0..10 nilai | Batas kecepatan naik vertikal maksimal setelah terkena knockback.Berlaku saat: pvp-mechanics.knockback.custom-profile |
pvp-mechanics.knockback.friction | number2 | 0.1..100 nilai | Pembagi kecepatan gerak lama sebelum knockback baru diterapkan.Berlaku saat: pvp-mechanics.knockback.custom-profile |
Penyimpanan & async I/O (async-chunk-io.*, region-file-compression.*, async-playerdata-save.*)
Worker baca/tulis disk chunk, level kompresi Zstandard region, dan penyimpanan data pemain di background.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
async-chunk-io.threads | integer0 | 0..256 thread | Jumlah thread I/O chunk. Nilai 0 otomatis menyesuaikan jumlah core CPU.Berlaku saat: feature-flags.async-chunk-io |
region-file-compression.level | integer3 | -5..22 level zstd | Level kompresi zstd untuk region baru. Default 3 seimbang antara hemat disk dan ringan CPU.Berlaku saat: feature-flags.region-file-compression |
async-playerdata-save.threads | integer0 | 0..256 thread | Jumlah thread penyimpanan data pemain. Nilai 0 otomatis (maksimal 2 thread).Berlaku saat: feature-flags.async-playerdata-save |
async-playerdata-save.warn-queued-players | integer1024 | 1..2147483647 player | Batas jumlah antrean simpan pemain sebelum muncul peringatan disk lambat di log.Berlaku saat: feature-flags.async-playerdata-save |
async-playerdata-save.warn-queued-mib | integer64 | 1..2147483647 MiB | Batas ukuran memori antrean simpan pemain sebelum muncul peringatan di log.Berlaku saat: feature-flags.async-playerdata-save |
Jaringan & hub ramai (hub-networking.*, combat-priority-override.*, networking.*)
Cache paket broadcast, pembagian tier jarak pemain, prioritas pemain PvP, penggabungan tab list, dan tuning socket Netty.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
hub-networking.shared-cache-entries | integer8192 | 1..65536 entri | Kapasitas cache sementara untuk hasil encode paket broadcast.Berlaku saat: feature-flags.shared-packet-encoding |
hub-networking.near-distance | number8 | >0..4096 blok | Jarak dekat pemain yang selalu mendapat update posisi setiap tick.Berlaku saat: feature-flags.tiered-entity-updates |
hub-networking.far-interval | integer4 | 1..20 tick | Jeda tick pengiriman posisi pemain yang berada lebih jauh dari near-distance.Berlaku saat: feature-flags.tiered-entity-updates |
hub-networking.waypoint-far-interval | integer1 | 1..4 tick | Jeda tick update indikator locator pemain jauh (isi 4 untuk menghemat paket di lobby ramai).Berlaku saat: feature-flags.tiered-entity-updates |
hub-networking.snapshot-interval | integer4 | 1..20 tick | Jeda tick pembuatan ulang indeks jarak antar-pemain.Berlaku saat: feature-flags.tiered-entity-updates |
hub-networking.max-snapshot-players | integer1024 | 2..2048 player | Batas pemain pada indeks snapshot jarak (selebihnya memakai pengecekan langsung).Berlaku saat: feature-flags.tiered-entity-updates |
hub-networking.tab-window-millis | integer200 | 1..1000 ms | Jendela waktu penggabungan paket update tab list.Berlaku saat: feature-flags.batch-tab-list |
hub-networking.max-tab-entries | integer4096 | 1..16384 entri | Batas entri tab sebelum langsung dikirim tanpa menunggu jendela selesai.Berlaku saat: feature-flags.batch-tab-list |
combat-priority-override.enabled | booleantrue | true / false | Memastikan pasangan pemain yang sedang bertarung tetap mendapat update posisi 1-tick meski berjauhan.Berlaku saat: feature-flags.tiered-entity-updates |
combat-priority-override.window-ticks | integer80 | 1..1200 tick | Lama prioritas update penuh setelah pukulan terakhir (80 tick = 4 detik).Berlaku saat: combat-priority-override.enabled |
networking.flush-consolidation | booleantrue | true / false | Menggabungkan syscall pengiriman jaringan Netty saat server sibuk.Berlaku saat: feature-flags.netty-tuning |
networking.ip-tos | integer24 | 0..255 | Header penanda prioritas paket game rendah latensi (0 = ikuti default OS).Berlaku saat: feature-flags.netty-tuning |
networking.tcp-fastopen | booleantrue | true / false | Mengaktifkan TCP FastOpen pada socket server bila didukung sistem operasi.Berlaku saat: feature-flags.netty-tuning |
networking.tcp-fastopen-backlog | integer256 | 1..65535 koneksi | Kapasitas antrean koneksi TCP FastOpen.Berlaku saat: networking.tcp-fastopen |
networking.chunk-batch-max-packets | integer32 | 1..1024 paket | Jumlah maksimal paket chunk yang digabung dalam satu giliran kirim.Berlaku saat: feature-flags.chunk-compression-batching |
networking.chunk-batch-max-bytes | integer2097152 | 1024..8388608 byte | Batas total ukuran byte per kelompok pengiriman chunk.Berlaku saat: feature-flags.chunk-compression-batching |
networking.chunk-batch-delay-millis | integer1 | 0..10 ms | Batas tunggu maksimal sebelum paket chunk terkumpul dikirim ke pemain.Berlaku saat: feature-flags.chunk-compression-batching |
Pre-generasi world (pre-generation.*)
Ambang aman TPS/MSPT serta batas kecepatan pembuatan chunk untuk perintah /nusa pregen.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
pre-generation.minimum-tps | number18 | 1..20 TPS | Menjeda pre-generasi otomatis saat TPS server turun di bawah nilai ini.Berlaku saat: feature-flags.pre-generation |
pre-generation.resume-tps | number19 | 1..20 TPS, ≥ minimum-tps | Melanjutkan kembali pre-generasi setelah TPS pulih mencapai nilai ini.Berlaku saat: feature-flags.pre-generation |
pre-generation.max-average-mspt | number40 | >0..50 ms | Menjeda pre-generasi jika rata-rata beban MSPT melebihi batas ini.Berlaku saat: feature-flags.pre-generation |
pre-generation.max-in-flight | integer2 | 1..64 request | Jumlah chunk yang boleh digenerasi bersamaan (bisa dinaikkan saat maintenance tanpa pemain).Berlaku saat: feature-flags.pre-generation |
pre-generation.requests-per-tick | integer1 | 1..64 request/tick | Jumlah tugas chunk baru yang dimulai setiap tick.Berlaku saat: feature-flags.pre-generation |
pre-generation.progress-interval-ticks | integer200 | 20..72000 tick | Jeda laporan progres pre-generasi di console (200 tick ≈ 10 detik).Berlaku saat: feature-flags.pre-generation |
pre-generation.max-radius-chunks | integer256 | 1..2048 chunk | Batas maksimal radius (dalam chunk) untuk satu perintah /nusa pregen <radius> <world>.Berlaku saat: feature-flags.pre-generation |
pre-generation.player-buffer-chunks | integer2 | 0..32 chunk | Jarak aman di sekitar pemain aktif yang dilewati sementara oleh pregen.Berlaku saat: feature-flags.pre-generation |
Keamanan & pelindung paket (security.*)
Validasi ukuran/kedalaman NBT, filter pola crash, pembatas banjir paket, jatah waktu main thread per pemain, dan penahan redstone ekstrem.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
security.warning-interval-ticks | integer200 | 1..72000 tick | Jeda waktu minimal antar pesan peringatan keamanan di console agar log tidak banjir.Berlaku saat: guard paket aktif |
security.max-warnings-per-interval | integer32 | 1..4096 warning | Batas jumlah baris peringatan keamanan yang dicetak setiap interval.Berlaku saat: guard paket aktif |
security.max-log-value-length | integer128 | 16..1024 karakter | Batas panjang teks data asing yang ditampilkan di log keamanan.Berlaku saat: guard paket aktif |
security.nbt-packet-validation.action | stringSKIP | SKIP / DISCONNECT; KICK = alias | Tindakan saat paket melanggar batas struktur NBT (SKIP = tolak paketnya saja, DISCONNECT = putus koneksi).Berlaku saat: feature-flags.nbt-packet-validation |
security.nbt-packet-validation.max-bytes | integer2097152 | 1024..2097152 byte | Batas ukuran byte payload NBT yang diizinkan masuk.Berlaku saat: feature-flags.nbt-packet-validation |
security.nbt-packet-validation.max-depth | integer512 | 1..512 tingkat | Batas kedalaman susunan tag NBT bertingkat.Berlaku saat: feature-flags.nbt-packet-validation |
security.nbt-packet-validation.max-nodes | integer2097152 | 1..2097152 node | Batas jumlah total elemen/tag di dalam satu payload NBT.Berlaku saat: feature-flags.nbt-packet-validation |
security.crash-pattern-guard.action | stringSKIP | SKIP / DISCONNECT; KICK = alias | Tindakan saat custom payload melanggar ukuran atau cocok dengan aturan blokir.Berlaku saat: feature-flags.crash-pattern-guard |
security.crash-pattern-guard.max-payload-bytes | integer2097152 | 1024..2097152 byte | Batas ukuran byte paket custom payload.Berlaku saat: feature-flags.crash-pattern-guard |
security.crash-pattern-guard.patterns | list[] | 0..128 objek aturan | Daftar aturan filter literal (id, channel, substring, max-bytes) untuk memblokir payload exploit tertentu.Berlaku saat: feature-flags.crash-pattern-guard |
security.packet-flood-detection.action | stringSKIP | SKIP / DISCONNECT; KICK = alias | Tindakan saat pemain mengirim paket melebihi batas wajar per detik.Berlaku saat: feature-flags.packet-flood-detection |
security.packet-flood-detection.rate-per-second | integer300 | 1..1000000 paket/detik | Batas rata-rata paket masuk per detik untuk tiap pemain.Berlaku saat: feature-flags.packet-flood-detection |
security.packet-flood-detection.burst | integer600 | 1..1000000 token | Toleransi lonjakan paket sesaat (misalnya saat membuka UI cepat atau berpindah dimensi).Berlaku saat: feature-flags.packet-flood-detection |
security.tick-starvation-guard.action | stringSKIP | SKIP / DISCONNECT; KICK = alias | SKIP menunda sisa paket pemain ke tick berikutnya; DISCONNECT memutus pemain yang menghabiskan jatah.Berlaku saat: feature-flags.tick-starvation-guard |
security.tick-starvation-guard.max-packets-per-tick | integer64 | 1..65536 paket/player/tick | Batas jumlah paket satu pemain yang diproses di main thread pada satu tick.Berlaku saat: feature-flags.tick-starvation-guard |
security.tick-starvation-guard.max-processing-micros | integer2000 | 1..50000 µs/player/tick | Batas waktu main thread per pemain tiap tick (2000 µs = 2 ms).Berlaku saat: feature-flags.tick-starvation-guard |
security.redstone-abuse-limiter.max-updates-per-chunk-per-tick | integer4096 | 1..1048576 update | Batas update redstone per chunk tiap tick sebelum sisanya ditunda ke antrean.Berlaku saat: feature-flags.redstone-abuse-limiter |
security.redstone-abuse-limiter.max-deferred-per-chunk | integer8192 | 1..1048576 entri | Kapasitas antrean tunda redstone per chunk.Berlaku saat: feature-flags.redstone-abuse-limiter |
security.redstone-abuse-limiter.max-deferred-total | integer65536 | 1..16777216 entri/world | Kapasitas antrean tunda redstone total satu world (minimal sebesar max-deferred-per-chunk).Berlaku saat: feature-flags.redstone-abuse-limiter |
security.redstone-abuse-limiter.warning-interval-ticks | integer200 | 1..72000 tick | Jeda minimal antar peringatan pembatasan redstone di console.Berlaku saat: feature-flags.redstone-abuse-limiter |
security.miscellaneous-security.disable-placed-block-nbt-reading | booleanfalse | true / false | Mencegah pembacaan data BlockEntityTag mentah saat pemain memasang blok (aktifkan di server creative publik).Berlaku saat: feature-flags.miscellaneous-security |
security.miscellaneous-security.downloader-request-channels | list["wdl:request"] | 0..128 channel namespaced | Daftar channel plugin yang dipantau untuk membatasi request mod pengunduh map.Berlaku saat: feature-flags.miscellaneous-security |
security.miscellaneous-security.downloader-request-rate-per-second | integer2 | 1..10000 request/detik | Batas request channel downloader per detik.Berlaku saat: feature-flags.miscellaneous-security |
security.miscellaneous-security.downloader-request-burst | integer8 | 1..1000000 token | Batas lonjakan sesaat request channel downloader.Berlaku saat: feature-flags.miscellaneous-security |
security.miscellaneous-security.downloader-action | stringSKIP | SKIP / DISCONNECT; KICK = alias | Tindakan saat request mod downloader melebihi batas.Berlaku saat: feature-flags.miscellaneous-security |
Dashboard & notifikasi Discord (management.*)
Interval pembaruan /nusa status, endpoint metrik JSON lokal opsional, serta pengaturan webhook peringatan Discord.
Semua opsi di bawah ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis akan memakai nilai default.
| Key lengkap | Tipe / default | Rentang / satuan | Fungsi & kapan berlaku |
|---|---|---|---|
management.dashboard.update-interval-seconds | integer3 | 1..60 detik | Jeda pembaruan otomatis saat memantau /nusa status watch.Berlaku saat: feature-flags.live-dashboard |
management.dashboard.max-subscribers | integer16 | 1..128 subscriber | Batas jumlah admin yang bisa menjalankan /nusa status watch secara bersamaan.Berlaku saat: feature-flags.live-dashboard |
management.dashboard.json-endpoint-enabled | booleanfalse | true / false | Membuka endpoint metrik JSON lokal (read-only) untuk tool monitoring eksternal Anda sendiri.Berlaku saat: feature-flags.live-dashboard; json-token wajib diisi |
management.dashboard.json-port | integer9240 | 1..65535 port | Port TCP lokal untuk endpoint metrik JSON (terpisah dari port game dan tidak diperlukan untuk Cloud Bridge).Berlaku saat: management.dashboard.json-endpoint-enabled |
management.dashboard.json-token | string'' | 20..256 ASCII printable tanpa spasi bila aktif | Token rahasia Bearer untuk mengakses endpoint JSON lokal. Biarkan kosong jika fitur tidak dipakai.Berlaku saat: management.dashboard.json-endpoint-enabled |
management.discord.webhook-url | string'' | kosong atau URL webhook HTTPS resmi Discord | URL webhook Discord privat tujuan pengiriman notifikasi kesehatan server.Berlaku saat: feature-flags.discord-webhook |
management.discord.low-tps-threshold | number15 | 1..20 TPS | Batas TPS rendah yang memicu peringatan jika berlangsung terus-menerus.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.low-tps-duration-seconds | integer60 | 1..3600 detik | Durasi TPS harus bertahan di bawah ambang sebelum notifikasi Discord dikirim.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.cooldown-seconds | integer300 | 1..86400 detik | Jeda tunggu minimal antar pengiriman notifikasi Discord untuk kategori yang sama.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.repeated-security-threshold | integer10 | 2..1000000 kejadian | Jumlah penolakan paket keamanan dari satu koneksi untuk memicu notifikasi.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.repeated-security-window-seconds | integer60 | 1..3600 detik | Rentang waktu penghitungan kejadian penolakan keamanan berulang.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.queue-capacity | integer32 | 1..256 alert | Kapasitas antrean pesan Discord yang menunggu dikirim di background.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.request-timeout-seconds | integer5 | 1..30 detik | Batas waktu tunggu HTTP saat mengirim pesan ke Discord.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.notify-fatal-exceptions | booleantrue | true / false | Mengirim alert Discord saat terjadi error fatal pada tick atau watchdog.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.notify-low-tps | booleantrue | true / false | Mengirim alert Discord saat TPS turun berkepanjangan melewati batas.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.notify-module-disabled | booleantrue | true / false | Mengirim alert Discord saat safemode menyala atau plugin gagal aktif.Berlaku saat: feature-flags.discord-webhook; webhook valid |
management.discord.notify-repeated-security | booleantrue | true / false | Mengirim ringkasan alert Discord saat ada koneksi yang berulang kali ditolak guard.Berlaku saat: feature-flags.discord-webhook; webhook valid |