Feature flags | NusaSpigot Docs

Cara memilih flag

false mematikan modul yang disebut, tanpa otomatis mematikan modul lain. Jangan mematikan seluruh guard untuk menyelidiki satu item sah. Uji satu perubahan di staging, restart, lalu bandingkan hasil.

Master entity-behavior-switches hanya mengendalikan modul perilaku dan override preset. AI precompute, tracking, dan hopper tetap punya flag sendiri. tuning-wizard dan live-dashboard juga independen. Safemode adalah bypass runtime darurat yang lebih luas daripada satu flag.

Referensi sakelar

Semua opsi pada tabel ini berada di nusa-global.yml dan membutuhkan restart penuh. Key yang tidak ditulis memakai default. Rentang mencakup kedua ujung kecuali ditandai >.

Key lengkap	Tipe / default	Rentang / satuan	Fungsi, dampak, dan kapan diubah
`feature-flags.async-chunk-io`	boolean`true`	true / false	Memakai pool I/O region terpisah. Matikan untuk membandingkan jalur scheduler Paper; pemanggilan chunk sinkron tetap menunggu main commit.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.region-file-compression`	boolean`true`	true / false	Menulis codec zstd Nusa. Matikan sebelum migrasi jika perlu writer Paper; data zstd lama tidak dikonversi.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.async-playerdata-save`	boolean`true`	true / false	Memindahkan penulisan NBT player ke I/O terpisah setelah snapshot di main. Matikan untuk diagnosis penyimpanan.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.ai-precompute-queue`	boolean`true`	true / false	Menghitung kandidat target mob dari snapshot. AI, pathfinding, event, dan gerak tetap di main; matikan jika profiling menunjukkan overhead.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.entity-tracking-culling`	boolean`true`	true / false	Menghitung kandidat visibilitas termasuk garis pandang. Dapat menyembunyikan entity di balik dinding; matikan untuk tracking jarak native.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.hopper-tick-spreading`	boolean`true`	true / false	Menyebar retry hopper idle yang memenuhi syarat. Listener inventory mengembalikan polling native.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.entity-behavior-switches`	boolean`true`	true / false	Master switch perilaku entity dan preset. false memulihkan perilaku native modul ini, termasuk override HUB.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.nbt-packet-validation`	boolean`true`	true / false	Memvalidasi struktur input NBT/component. Pertahankan untuk perlindungan; limit terlalu rendah dapat menolak item sah.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.crash-pattern-guard`	boolean`true`	true / false	Menerapkan batas ukuran dan aturan literal startup. Tidak otomatis mengenali setiap exploit.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.packet-flood-detection`	boolean`true`	true / false	Membatasi jumlah frame PLAY per koneksi. Burst client/plugin yang sah perlu diuji.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.tick-starvation-guard`	boolean`true`	true / false	Memberi anggaran kooperatif handler player pada main. Penundaan FIFO dapat menambah latensi.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.redstone-abuse-limiter`	boolean`true`	true / false	Membatasi callback redstone per chunk. Sirkuit padat dapat tertunda dan overflow dapat membuang update.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.miscellaneous-security`	boolean`true`	true / false	Mengaktifkan kebijakan NBT peletakan dan limiter request downloader yang dikenali. Tidak mendeteksi semua mod downloader.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.netty-native-transport`	boolean`true`	true / false	Mencoba native transport yang tersedia; tetap tunduk pada kebijakan Paper dan dukungan OS. false memilih NIO untuk TCP.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.chunk-compression-batching`	boolean`true`	true / false	Mengelompokkan penjadwalan/flush byte chunk. Tiap paket tetap memiliki frame kompresi sendiri; dapat menambah jeda pengiriman.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.netty-tuning`	boolean`true`	true / false	Memakai pengaturan flush dan socket Nusa. false mempertahankan perilaku tuning Paper.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.pre-generation`	boolean`true`	true / false	Mengizinkan command serta admission pregen. false tidak mengubah modul jaringan lain.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.shared-packet-encoding`	boolean`true`	true / false	Menggunakan ulang encode paket numerik native yang memenuhi syarat. Chat, metadata, dan codec plugin memakai jalur biasa.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.tiered-entity-updates`	boolean`true`	true / false	Mengurangi frekuensi posisi player jauh dan menggabungkan pembaruan locator gerak. Dapat mengurangi kelancaran visual, termasuk saat jaringan macet.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.batch-tab-list`	boolean`true`	true / false	Menggabungkan update numerik tab yang cocok. Batas waktu dapat menunda tampilan; urutan dan barrier tetap dijaga.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.pooled-broadcast-buffers`	boolean`true`	true / false	Memakai pooled buffer untuk jalur broadcast numerik yang memenuhi syarat. Paper juga dapat melakukan pooling; ukur manfaatnya.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.tuning-wizard`	boolean`true`	true / false	Mengizinkan preview setup console. Mematikannya tidak mematikan command status.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.live-dashboard`	boolean`true`	true / false	Mengaktifkan status dan koleksi metrik terkait. Endpoint JSON juga tunduk pada flag ini.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.discord-webhook`	boolean`false`	true / false	Opt-in notifikasi eksternal. Membutuhkan URL webhook privat; pengiriman bersifat best effort.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen
`feature-flags.external-ai-advisor`	boolean`false`	true / false	Flag komponen analisis opsional. UI lokal lama sudah dihapus; flag ini tidak membuktikan ketersediaan alur cloud saat ini.Berlaku saat: startup; safemode melewati optimasi dan guard, tetapi mempertahankan fitur manajemen

Setelah mematikan modul

Periksa efek yang dituju dengan tindakan permainan nyata, bukan hanya status boolean. Resource yang dibuat saat startup memerlukan restart untuk diganti secara normal. Mematikan kompresi region tidak membatalkan format data yang sudah ditulis; lihat zstd.