Update game sudah keluar, dan Anda ingin membawa mod serta dunia Anda ke versi terbaru tanpa kehilangan dunia. Mengubah pengaturan server Vintage Story dan menambahkan mod adalah dua perubahan yang bisa mencegah dunia dimuat, jadi alur kerja ini menjalankannya dengan urutan tetap: salin simpanan, ubah satu hal, mulai server, dan baca log, lalu ubah hal berikutnya. Cascadia Merge menangani pekerjaan file dan menampilkan setiap hasil sebagai kartu. Anda membuat setiap keputusan, dan Anda menjaga server tetap berhenti saat file berubah. Rencanakan untuk menghabiskan waktu membaca diff dan log, bukan mengetik path, dan catat versi setiap mod sebelum mengubahnya, agar daftar tersebut bisa menjadi catatan hari update Anda.
Pilih folder data server sebagai folder kerja untuk obrolan baru. Agen mencantumkan folder dengan list_dir, jadi Anda bisa melihat Saves, Backups, dan Mods sebelum ada yang disentuh. Di PC Windows, lokasi defaultnya adalah folder VintagestoryData di bawah folder AppData\Roaming pengguna Anda, kecuali jika Anda memulai server dengan path data lain.
Saat server berhenti, agen menyalin folder Saves ke Backups menggunakan skrip backup Anda sendiri. Anda membaca kode keluar dalam kartu, meminta list_dir kedua untuk folder Backups, dan mengonfirmasi bahwa salinan baru benar-benar ada sebelum melanjutkan.
Edit serverconfig.json atau ganti satu mod, jangan keduanya sekaligus. Agen menampilkan diff untuk perubahan pengaturan, dan Anda menerima atau menolaknya dalam mode Ask first. Mod yang Anda ganti secara manual masuk ke folder Mods sebagai file .zip, dan hanya satu file seperti itu yang berubah per putaran.
Mulai server dengan skrip Anda sendiri, biarkan agen mencari log untuk mod yang gagal, dan bergabung dari game. Jika ada yang rusak, Anda tahu perubahan mana yang menyebabkannya, dan Anda bisa memindahkan file tersebut atau memulihkan baris tersebut dari salinan yang Anda buat di awal.
Mods/foundMods/examplemod/modinfo.jsonreadversion Mods/3 matchesmod-list.txtsaved{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Ini adalah kutipan dari serverconfig.json, bukan file lengkap, hanya berisi nilai placeholder. Port game adalah 42420 (TCP), dan kata sandi null berarti tidak ada kata sandi yang diatur, jadi tambahkan kata sandi sebelum Anda membuka dunia ke internet. Edit file asli hanya saat server berhenti, dan simpan salinan Anda sendiri di samping folder Saves.
Mulailah dengan melihat sebelum mengubah apa pun. Agen menggunakan list_dir dan glob untuk menemukan folder Mods di dalam folder data, read_file untuk membuka modinfo.json dari setiap mod yang berada di folder, dan write_file untuk menyimpan daftar nama dan versi dalam folder kerja Anda. Jika Anda butuh bantuan dengan mod di server yang di-host, periksa dulu apakah Anda bisa mengakses folder data-nya, karena agen hanya bisa bekerja pada file yang bisa Anda buka. Cetak daftarnya. Anda membandingkannya dengan mod yang dimiliki pemain Anda, karena server dan pemain butuh mod dan versi yang sama, dan Anda memutuskan apa yang perlu diupdate. Belum ada yang berubah, dan Anda punya catatan tentang apa yang terinstal sebelum update, yang membantu jika Anda harus membatalkan langkah nanti.
Dunia Anda adalah satu file .vcdbs di folder Saves, jadi salin folder itu sebelum setiap update game, perubahan mod, dan perubahan pengaturan. Hentikan server dulu. Agen menggunakan copy_file untuk menempatkan file dunia di folder Backups, dan Shell menjalankan skrip backup Anda sendiri serta melaporkan kode keluar yang sebenarnya dalam kartu. Salinan yang belum pernah dipulihkan hanyalah tebakan, jadi pulihkan sekali ke folder cadangan, buka, dan periksa apakah dunia ada di sana. Baru kemudian Anda lanjut ke bagian pekerjaan yang mengubah file, dengan cara kembali yang aman jika perubahan gagal. Anda tidak menghapus apa pun, dan simpanan tidak pernah dihapus tanpa salinan. Jika folder berisi beberapa dunia, salin seluruh folder Saves agar tidak ada yang terlewat.
Sekarang ubah satu hal. Untuk menyesuaikan pengaturan server Vintage Story, agen menggunakan edit_file pada serverconfig.json dan menampilkan diff dalam mode Ask first; untuk update mod, Anda menempatkan .zip baru di folder Mods sendiri, hanya dari basis data mod resmi. Jika dunia tidak bisa dimuat setelah menginstal mod, perubahan terakhir adalah tersangka, dan Anda bisa membatalkannya dengan memindahkan file tersebut keluar lagi. Berhenti di sini. Anda tidak menambahkan mod kedua sebelum yang pertama diuji, karena dua perubahan sekaligus menyembunyikan penyebabnya. Plan only bisa menulis langkah-langkah dulu tanpa menjalankannya, yang berguna ketika Anda ingin daftar periksa untuk hari update yang bisa dibaca oleh admin lain juga.
Mulai server dengan skrip start Anda sendiri. Shell menjalankannya dan menampilkan kode keluar yang sebenarnya, lalu grep mencari log server untuk kata failed dan error. Troubleshooting server dedicated dimulai dengan log itu, dan kartu mencantumkan setiap baris yang cocok agar Anda bisa membacanya secara berurutan. glob menemukan file log jika Anda tidak yakin mana yang terbaru. Selanjutnya, Anda bergabung dari game dan berjalan-jalan di dunia. Anda menerima perubahan sebagai selesai hanya setelah log bersih dan pemain kedua telah bergabung. Jika tidak bersih, Anda kembali satu langkah, baca error pertama bukan yang terakhir, dan pulihkan salinan simpanan jika dunia itu sendiri sudah rusak.
