Server Project Zomboid dapat crash atau gagal dimulai karena beberapa alasan yang umum diketahui. Panduan ini mencakup penyebab paling umum yang terlihat di seluruh tiket dukungan Legion Hosting — mulai dari bug memori Build 42 yang memerlukan RAM tambahan saat startup, hingga overflow backup yang memenuhi /tmp, hingga file konfigurasi yang rusak. Kerjakan bagian di bawah ini secara berurutan.

Sebelum Anda Mulai — Temukan Log Crash Anda

Hampir setiap crash Project Zomboid meninggalkan bukti di salah satu dari dua tempat. Periksa keduanya sebelum mencoba perbaikan apa pun, sehingga Anda tahu bagian mana dari panduan ini yang berlaku untuk Anda.

Output Konsol GPanel

1. Masuk ke GPanel.
2. Pilih server Project Zomboid Anda dari daftar server.
3. Klik tab Console.
4. Gulir ke bagian bawah output. Cari baris yang ditandai ERROR, FATAL, OutOfMemoryError, atau Exception. 20–30 baris terakhir sebelum server berhenti biasanya yang paling relevan.
5. Jika konsol kosong, proses server berakhir sebelum dapat menulis apa pun — ini sendiri adalah petunjuk (lihat bagian memori B42 di bawah).

File debug.log Server

Project Zomboid menulis log terperinci ke debug.log di direktori data server. File ini sering berisi jejak tumpukan Java lengkap yang menunjuk langsung ke penyebab crash.

1. Di GPanel, buka tab File Manager.
2. Navigasi ke /.cache/Logs/. Anda akan melihat file dengan nama seperti debug.log, DebugLog-server.txt, atau file log bertanggal.
3. Buka file log terbaru. Gunakan Ctrl+End atau gulir ke bagian paling bawah dan baca ke atas dari sana.
4. Cari kata kunci OutOfMemoryError, IOException, NullPointerException, atau SandboxVars. Salin baris yang relevan — Anda akan memerlukannya jika membuka tiket dukungan.

Perbaikan 1 — Penggunaan Memori Tinggi Build 42 saat Startup (Bug Game yang Diketahui)

Jika server Anda langsung keluar saat startup tanpa kesalahan di konsol, atau konsol menunjukkan OutOfMemoryError atau kesalahan Java heap space, server kehabisan memori sebelum dunia selesai dimuat.

Gejala

• Server mulai, konsol bergulir selama beberapa detik, lalu berhenti tanpa kesalahan yang terlihat pemain.
• Konsol menunjukkan java.lang.OutOfMemoryError: Java heap space atau GC overhead limit exceeded.
• Server bekerja pada beberapa restart tetapi tidak pada yang lain (ketersediaan memori bervariasi).
• Server berjalan baik di B41 tetapi crash secara konsisten setelah upgrade ke B42.

Langkah

1. Di GPanel, klik server Anda dan buka tab Console. Catat alokasi RAM server Anda saat ini yang ditampilkan di bilah resource atau panel info server.
2. Jika paket Anda mencakup kurang dari 10 GB RAM, server mungkin crash selama startup karena B42 memerlukan sekitar 9 GB untuk inisialisasi. Anda perlu mengupgrade paket Anda atau menunggu the Indie Stone merilis perbaikan.
3. Jika paket Anda sudah memiliki 10 GB atau lebih dan server masih crash saat startup, buka tab Startup di GPanel.
4. Cari kolom berlabel Java Memory, Max RAM, atau Xmx. Pastikan diatur tidak lebih dari 80–85% dari total RAM yang tersedia. Misalnya, pada paket 12 GB, atur ini ke 10240 (10 GB dalam megabyte). Jangan atur sama dengan atau di atas total RAM Anda — sistem operasi dan proses lain juga memerlukan memori.
5. Klik Save pada tab Startup, lalu mulai ulang server Anda.
6. Perhatikan konsol selama startup. Jika server mencapai baris SERVER STARTED atau LuaManager: Loading lua files... selesai tanpa crash, alokasi memori sekarang sudah cukup.

Perbaikan 2 — BackupsOnStart Membanjiri /tmp (Crash Startup)

Project Zomboid dapat dikonfigurasi untuk membuat backup dunia penuh setiap kali server dimulai. Ketika backup ini ditulis ke /tmp — yang ukurannya terbatas pada sebagian besar host Linux — server crash di tengah startup dengan kesalahan penulisan disk saat /tmp penuh.

Gejala

• Server crash secara konsisten pada setiap restart, tetapi sebelumnya berfungsi.
• Konsol atau debug.log berisi kesalahan seperti IOException: No space left on device atau menyebutkan penulisan ke /tmp/.
• Crash cenderung memburuk dari waktu ke waktu seiring save dunia menjadi lebih besar.
• Server kadang mulai jika Anda mencoba segera setelah reboot bersih node host (sebelum /tmp penuh lagi).

Langkah — Nonaktifkan BackupsOnStart

1. Di GPanel, buka tab File Manager.
2. Navigasi ke /.cache/server/. Cari file konfigurasi server Anda — biasanya bernama servertest.ini atau apa pun nama server Anda diikuti dengan .ini (mis. MyServer.ini).
3. Buka file .ini untuk diedit.
4. Gunakan fungsi pencarian browser Anda (Ctrl+F) untuk mencari BackupsOnStart.
5. Ubah nilai dari true menjadi false:

   BackupsOnStart=false

6. Saat berada di file, periksa juga pengaturan BackupsOnVersionChange dan atur ke false jika ruang disk menjadi perhatian:

   BackupsOnVersionChange=false

7. Simpan file dan mulai ulang server Anda. Pantau konsol untuk mengonfirmasi server mencapai baris SERVER STARTED.

Perbaikan 3 — SandboxVars.lua atau Konfigurasi Server yang Rusak

Project Zomboid menyimpan pengaturan dunia dalam file Lua yang disebut SandboxVars.lua. Jika file ini diedit secara manual dan disimpan dengan kesalahan sintaks, atau jika transfer file terganggu, server akan langsung crash saat startup ketika mencoba mengurai file.

Gejala

• Konsol menunjukkan ERROR: SandboxVars, LuaManager error, atau kesalahan parse Lua dengan nomor baris.
• Crash mulai terjadi tepat setelah Anda mengedit pengaturan di file .ini atau SandboxVars.lua secara langsung.
• Server mungkin menunjukkan Bad argument #1 to atau kesalahan runtime Lua serupa.

Langkah — Periksa dan Perbaiki SandboxVars.lua

1. Di GPanel, buka File Manager dan navigasi ke /.cache/saves/multiplayer/<YourServerName>/.
2. Buka SandboxVars.lua untuk diedit.
3. Periksa bahwa file dimulai dengan VERSION = 1, (atau serupa) di dalam blok SandboxVars = {, dan diakhiri dengan kurung kurawal penutup }. Koma yang hilang, kurung yang tidak ditutup, atau karakter yang nyasar akan menyebabkan kegagalan parse.
4. Jika Anda tidak dapat mengidentifikasi kesalahan, perbaikan paling aman adalah menghapus SandboxVars.lua sepenuhnya. Server akan membuatnya kembali dengan nilai default pada startup berikutnya. Catatan: ini mereset pengaturan sandbox Anda (loot, jumlah zombie, dll.) ke default — data peta dan data pemain Anda tidak terpengaruh.
5. Periksa juga file .ini di /.cache/server/ untuk masalah serupa jika Anda baru-baru ini mengeditnya secara manual. Pastikan setiap baris mengikuti format Key=Value tanpa baris kosong di dalam suatu nilai.
6. Simpan perubahan dan mulai ulang server.

Perbaikan 4 — Kata Sandi Admin Kosong Menyebabkan Crash

Project Zomboid memerlukan kata sandi admin yang tidak kosong untuk memulai server multiplayer. Jika kolom kata sandi kosong, proses server langsung keluar setelah mencoba menginisialisasi akun admin.

Gejala

• Server baru atau server yang baru-baru ini direset gagal pada setiap upaya start.
• Output konsol sangat singkat — server mencetak beberapa baris inisialisasi lalu berhenti.
• debug.log mungkin berisi referensi ke akun admin atau validasi kata sandi.

Langkah

1. Di GPanel, klik server Anda dan buka tab Startup.
2. Cari kolom berlabel Admin Password atau RCON Password. Pastikan kolom berisi nilai — tidak boleh kosong.
3. Jika kolom kosong, masukkan kata sandi. Gunakan setidaknya 8 karakter. Hindari karakter khusus seperti !, #, $, atau @ dalam kata sandi admin, karena beberapa versi PZ gagal menguraikannya dengan benar dalam argumen startup.
4. Klik Save dan mulai ulang server.
5. Sebagai pemeriksaan sekunder, buka file .ini di /.cache/server/ dan konfirmasi baris AdminPassword= memiliki nilai setelah tanda sama dengan.

Perbaikan 5 — Reset Dunia (Pilihan Terakhir untuk Crash yang Persisten)

Jika save dunia menjadi rusak — misalnya setelah crash server keras, update yang gagal, atau kesalahan sistem file — data save itu sendiri mungkin tidak dapat dipulihkan. Dalam kasus ini, menghapus dunia dan memulai dari awal adalah satu-satunya pilihan.

Langkah

1. Hentikan server Anda di GPanel sebelum membuat perubahan apa pun pada file save. Mengedit file pada server yang berjalan dapat menyebabkan kerusakan lebih lanjut.
2. Di GPanel, buka tab File Manager.
3. Navigasi ke /.cache/saves/multiplayer/.
4. Anda akan melihat satu atau lebih folder dengan nama server Anda (mis. servertest). Sebelum menghapus, opsional unduh folder sebagai backup dengan memilihnya dan menggunakan opsi unduh — bahkan save yang rusak mungkin sebagian dapat dipulihkan nanti.
5. Hapus folder yang cocok dengan nama server Anda di dalam Multiplayer/. Jangan hapus folder Multiplayer itu sendiri.
6. Navigasi juga ke /.cache/db/ dan hapus file <YourServerName>.db. Database ini menyimpan statistik pemain dan mungkin merujuk ke dunia lama — membuatnya kembali menghindari ketidakcocokan.
7. Mulai server Anda. Ini akan menghasilkan dunia baru menggunakan pengaturan di file .ini Anda.

Referensi Diagnostik Cepat

Masih Crash Setelah Semua Langkah?