Panduan / Mod
Cara Menambahkan Mod Steam Workshop ke Server Project Zomboid
Mod yang membuat Knox County tetap menarik, jauh setelah kamu menjarah setiap gudang di Muldraugh. Steam Workshop menampung ribuan mod Project Zomboid, mulai dari peta baru, kendaraan, senjata, profesi, hingga perbaikan kualitas hidup, dan server dedicated bisa menjalankan semuanya, baik di Build 42 maupun Build 41. Panduan ini membahas cara menambahkan mod Workshop lewat Mod Manager di dashboard Flux, kenapa urutan pemuatan penting, bagaimana mod peta berbeda, seperti apa pengeditan servertest.ini secara manual, dan cara memperbaiki mod yang bandel tidak mau dimuat.
Dua ID yang dimiliki setiap mod Project Zomboid
Hampir setiap masalah yang dialami orang dengan mod server Project Zomboid berasal dari satu kebingungan, jadi perlu dibereskan dulu sebelum hal lain. Setiap mod Workshop punya dua pengenal yang berbeda:
- Workshop ID, yaitu angka panjang di ujung URL Steam Workshop (bagian
?id=). Angka ini mengidentifikasi item Workshop yang harus diunduh server. - Mod ID, yaitu nama teks pendek yang dipilih pembuat mod (misalnya
ExampleModName). Nama ini mengidentifikasi mod yang harus dimuat game.
Konfigurasi server kamu membutuhkan keduanya, dalam dua baris terpisah di servertest.ini. Baris WorkshopItems= berisi Workshop ID berupa angka, agar server tahu apa yang harus diunduh dari Steam. Baris Mods= berisi Mod ID berupa teks, agar game tahu apa yang benar-benar diaktifkan. Satu item Workshop bahkan bisa berisi beberapa Mod ID, itu sebabnya sebuah mod bisa terunduh dengan sempurna tapi tetap tidak melakukan apa-apa di game.
Cara mudah: Mod Manager di dashboard
Setiap server Project Zomboid yang di-deploy di Flux hadir dengan Mod Manager Steam Workshop di dashboard web, dan fitur ini khusus untuk menghilangkan jebakan dua ID itu. Kamu tempel Link Steam Workshop atau cukup ID berupa angka, lalu Mod Manager mencari Mod ID dan Workshop ID secara otomatis, kemudian menulis keduanya daftar WorkshopItems dan Mods di servertest.ini untukmu. Tanpa SSH, tanpa mencari-cari file, tanpa menyalin string dari deskripsi mod.
- Buka mod di Steam Workshop lalu salin URL halaman dari browser (atau cukup ID angka di ujungnya).
- Buka Mod Manager di dashboard Flux kamu.
- Tempel link atau ID lalu tambahkan. Mod ID dan Workshop ID akan dicari, dan kedua daftar konfigurasi akan diperbarui untukmu.
- Periksa urutan pemuatan, seret dependensi dan framework ke atas mod yang bergantung padanya.
- Tambahkan nama peta ke baris
Map=jika kamu menambahkan mod peta (lebih lanjut di bawah). - Restart server. Item Workshop diunduh pada beberapa restart berikutnya, dan setelah berada di disk, mod akan dimuat.
Ulangi untuk sebanyak mod yang kamu mau. Bagian dashboard lainnya, seperti file manager, editor konfigurasi, konsol Source RCON, dan backup, ada di sampingnya, jadi kamu bisa memeriksa log atau mengembalikan save tanpa meninggalkan browser.
Kenapa urutan pemuatan penting
Project Zomboid memuat mod sesuai urutan kemunculannya di daftar Mods=, dari kiri ke kanan, dan mod yang berada di belakang menimpa yang sebelumnya ketika dua mod menyentuh script, item, atau tekstur yang sama. Jadi urutan ini adalah pengaturan yang nyata, bukan sekadar kosmetik. Tiga aturan ini mencakup sebagian besar kasus:
- Dependensi dan framework didahulukan. Jika sebuah mod menulis "requires X" di deskripsi Workshop-nya, X harus muncul lebih awal di daftar. Dependensi yang dimuat setelah yang bergantung padanya adalah penyebab paling umum mod terlihat terpasang tapi tidak melakukan apa-apa.
- Patch dan perbaikan kompatibilitas ditempatkan paling akhir. Patch yang menyelaraskan dua mod harus dimuat setelah keduanya, kalau tidak, tidak ada yang bisa di-patch.
- Jaga urutannya tetap stabil. Setelah dunia dibuat dengan urutan tertentu, mengacak peta atau mod overhaul di tengah save bisa merusak chunk. Tetapkan daftar mod sebelum memulai run panjang.
Jika dua mod benar-benar bentrok (keduanya menggantikan item vanilla yang sama), mod yang berada lebih bawah di daftar yang menang. Jika sebuah mod tidak berperilaku seperti yang dijelaskan halaman Workshop-nya, memindahkan urutannya adalah langkah pertama yang bisa dicoba.
Mod perlu di-restart (sering kali dua kali)
Menambahkan mod tidak langsung berlaku. Server harus mengambil item Workshop dari Steam, dan pengambilan itu terjadi saat startup, yang berarti mod diunduh pada beberapa restart berikutnya, tidak langsung. Wajar saja jika mod yang baru ditambahkan belum ada setelah restart pertama dan sudah ada setelah restart kedua: boot pertama memasukkan file ke antrean dan mengunduhnya, boot kedua baru benar-benar memuatnya. Beri server waktu, restart lagi, dan cek log sebelum mengira ada yang rusak. Beri tahu pemainmu juga, supaya tidak panik kalau peta barunya belum ada.
Mod peta adalah kasus khusus
Mod peta membutuhkan satu langkah tambahan yang tidak dibutuhkan jenis mod lain. Menambahkan Workshop ID dan Mod ID membuat server mengunduh dan mengaktifkan mod, tapi Project Zomboid tetap tidak akan memakai terrain baru kecuali peta ditambahkan ke baris Map= di servertest.ini. Baris itu berisi daftar nama folder peta yang dipisahkan titik koma, dan peta vanilla harus tetap berada di ujungnya:
Map=MyCustomMap;Muldraugh, KY
Nama yang kamu tambahkan adalah nama folder peta, yang biasanya dinyatakan penulis mod di halaman Workshop. Nama ini belum tentu Mod ID dan belum tentu nama yang tampil di game. Peta custom ditaruh sebelum Muldraugh, KY, yang mewakili peta game dasar dan berfungsi sebagai cadangan untuk semua area yang tidak dicakup peta custom. Menumpuk beberapa mod peta bisa, tapi peta yang tumpang tindih akan berebut sel yang sama, jadi cek koordinat di halaman Workshop tiap peta sebelum menggabungkannya. Seperti perubahan peta lainnya, menambah atau menghapus mod peta di dunia yang sudah ada bisa meninggalkan sambungan aneh di area yang sudah dijelajahi pemain, jadi lebih baik dilakukan di save baru.
Cara manual: mengedit servertest.ini
Ada baiknya mengetahui apa yang dilakukan Mod Manager di balik layar, baik untuk server self-hosted maupun untuk pemecahan masalah. Buka servertest.ini di editor konfigurasi dashboard (atau lewat file manager) dan kamu akan menemukan tiga baris terkait:
WorkshopItems=2169435993;2392709985, Workshop ID berupa angka yang dipisahkan titik koma. Ini adalah daftar unduhan.Mods=ModIdOne;ModIdTwo, Mod ID berupa teks yang dipisahkan titik koma, sesuai urutan pemuatan. Ini adalah daftar aktivasi.Map=MyCustomMap;Muldraugh, KY, nama folder peta yang dipisahkan titik koma, hanya diperlukan untuk mod peta.
Setiap mod yang kamu inginkan harus muncul di keduanya pada baris pertama dan kedua. Simpan file, restart server, dan hasilnya sama persis dengan memakai Mod Manager, kamu hanya melakukan pencarian ID secara manual. Pengeditan manual adalah tempat kesalahan klasik terjadi: menempelkan Workshop ID ke Mods=, lupa salah satu dari dua daftar, atau meninggalkan titik koma nyasar di akhir baris.
Pemecahan masalah: mod yang tidak mau dimuat
Mod ada di daftar tapi tidak ada yang berubah
Periksa baris Mods= berisi Mod ID, bukan Workshop ID berupa angka. Mod ID yang tidak cocok adalah penyebab nomor satu. Log server menyebutkan setiap mod saat dimuat, jadi bandingkan apa yang dimuat menurut log dengan yang kamu harapkan. Pastikan juga mod sudah selesai diunduh; jika baru melewati satu restart, restart lagi.
Pemain ditendang atau melihat ketidakcocokan mod saat join
Server mengirim daftar modnya ke klien yang terhubung, tetapi klien tetap membutuhkan file mod-nya sendiri. Setiap pemain harus subscribe ke mod yang sama di Steam Workshop dan membiarkan Steam selesai mengunduh sebelum terhubung. Jika satu pemain kehilangan mod, atau masih punya salinan lama, dia akan ditolak sementara pemain lain tetap bisa bermain. Lihat cara main multiplayer bersama teman untuk alur join lengkap, atau cara memperbaiki "file tidak cocok dengan yang ada di server" jika penolakan menyebut file tertentu.
Semuanya rusak setelah sebuah mod diperbarui
Mod Workshop diperbarui sesuai jadwal penulisnya, dan pembaruan di tengah sesi menghasilkan ketidakcocokan versi: klien sudah punya file baru, sementara server yang sedang berjalan masih memakai file lama. Solusinya adalah restart server agar mengambil versi terbaru, dan minta pemain memverifikasi unduhan Steam mereka sudah selesai. Restart server setelah gelombang pembaruan Workshop, dan sebelum sesi, menghemat banyak kebingungan. Buat backup dulu; dashboard sudah punya fitur backup dan restore.
Ada dependensi yang hilang
Banyak mod bergantung pada mod framework. Jika halaman Workshop mencantumkan item yang dibutuhkan, tambahkan semuanya dan letakkan mereka lebih awal dalam urutan pemuatan. Log server biasanya akan mengeluhkan script atau tabel yang hilang jika dependensi tidak ada.
Berikan tempat untuk mod kamu berjalan
Mod butuh banyak memori. Dunia vanilla Build 42 sudah cukup di dalam RAM 6 GB, 3 core CPU, dan SSD 20 GB paket entry Build 42 (Build 41 membutuhkan lebih sedikit, jadi paket entry-nya adalah 4 GB, 2 core, dan 15 GB), tapi daftar mod yang panjang, terutama dengan peta custom yang besar, membutuhkan ruang lebih di kedua build. Paket tersedia hingga 32 slot (32 pemain adalah batasnya), Build 41 mulai dari $4.99/mo, dan harga Build 42 terbaru ada di bagian harga. Setiap paket sudah termasuk resource khusus, proteksi DDoS, Mod Manager, dan pilihan 50+ region. Lihat kebutuhan server untuk melihat pemetaan spek ke jumlah pemain, atau panduan pengaturan jika server kamu belum aktif. Ingin gambaran lengkap tentang alasan jaringan dibangun seperti ini? Baca kenapa kami hosting di cloud terdesentralisasi.
FAQ
Bagaimana cara menambahkan mod Steam Workshop ke server Project Zomboid?
Buka Mod Manager di dashboard Flux kamu dan tempel link Steam Workshop atau Workshop ID berupa angka. Mod ID dan Workshop ID akan dicari secara otomatis dan ditulis ke daftar WorkshopItems dan Mods di servertest.ini. Restart server dan mod akan diunduh pada beberapa restart berikutnya.
Kenapa mod Project Zomboid saya tidak dimuat?
Paling sering karena Mod ID yang tidak cocok (daftar Mods= membutuhkan Mod ID, bukan Workshop ID), mod yang belum selesai diunduh, dependensi yang hilang, atau urutan pemuatan yang salah. Mod peta juga perlu nama petanya di baris Map=.
Apakah pemain juga perlu subscribe ke mod?
Ya. Server mengirim daftar mod ke klien yang terhubung, tetapi setiap pemain tetap perlu file-nya di perangkat masing-masing. Subscribe di Steam Workshop, biarkan Steam mengunduh, lalu join.
Apakah urutan pemuatan penting?
Ya. Mod dimuat sesuai urutan daftar dan mod yang berada di belakang menimpa yang sebelumnya, jadi dependensi dan framework harus di depan dan patch kompatibilitas di belakang.
Deploy server Project Zomboid dengan mod di Flux →
Baca selanjutnya
- Memperbaiki error file mismatchApa penyebab ketidakcocokan dan cara menghapusnya tanpa menghapus save.
- Cara menyiapkan server Project ZomboidSteamCMD, file ini, port dan mod, dengan urutan yang berhasil.
- Sewa server Project ZomboidApa yang kamu dapatkan dengan menyewa dibanding menjalankannya sendiri, dan berapa biaya setiap tingkatnya.