Panduan Pengaturan Server Vintage Story

Panduan ini menjelaskan cara mengatur dan mengonfigurasi server dedicated Vintage Story Anda yang dihosting dengan Legion Hosting, termasuk startup pertama kali, variabel GPanel, manajemen versi, konfigurasi server, pengaturan dunia, menghubungkan pemain, dan manajemen penyimpanan. Untuk instalasi mod, lihat Instalasi Mod Vintage Story. Untuk pengaturan dan perintah admin, lihat Perintah Admin Vintage Story.

Sebelum Anda mulai: Pastikan server Anda dibuat di GPanel. Jika Anda perlu bantuan menemukan alamat IP dan port server Anda, lihat Cara Menemukan IP dan Port Server Anda.

Startup Pertama

Saat Anda menjalankan server Vintage Story untuk pertama kalinya dari GPanel, server akan secara otomatis mengunduh file game dari API resmi Vintage Story dan menghasilkan dunia default. Startup awal ini mungkin memakan waktu beberapa menit sementara file diunduh dan diekstrak.

Masuk ke GPanel dan pilih server Vintage Story Anda.
Sebelum memulai, tinjau tab Startup untuk mengonfirmasi cabang versi yang Anda inginkan (stable, unstable, atau pre-release).
Klik Start pada tab Console. Perhatikan output konsol untuk pesan kemajuan saat server mengunduh dan menginstal file game.
Setelah Anda melihat pesan yang menunjukkan server sedang mendengarkan koneksi, server siap. File serverconfig.json default akan dihasilkan secara otomatis.

Startup pertama memakan waktu lebih lama dari biasanya. Server harus mengunduh paket server Vintage Story lengkap sebelum dapat dijalankan. Startup berikutnya akan jauh lebih cepat kecuali Anda mengubah versi atau cabang.

Variabel Startup GPanel

Pengaturan server inti dikontrol melalui tab Startup di GPanel. Tinjau dan sesuaikan ini sebelum menjalankan server Anda.

Variabel	Default	Deskripsi
`SERVER_PORT`	(ditetapkan)	Port game yang digunakan pemain untuk terhubung. Ini ditetapkan secara otomatis oleh GPanel -- periksa tab Network untuk port yang ditetapkan untuk Anda.
`MAX_CLIENTS`	`16`	Jumlah maksimum pemain secara bersamaan. Dapat diatur hingga 256. Harus sesuai dengan sumber daya paket hosting Anda.
`FILES_BRANCH`	`stable`	Cabang rilis mana yang akan digunakan. Opsi: `stable`, `unstable`, atau `pre`. Lihat bagian Manajemen Versi di bawah untuk detailnya.
`RELEASE_VERSION`	`latest`	Versi spesifik yang akan diinstal. Atur ke `latest` untuk selalu menggunakan rilis terbaru pada cabang pilihan Anda, atau masukkan nomor versi spesifik (misalnya `1.19.8`) untuk mengunci ke versi tersebut.
`OPTIONS`	(kosong)	Argumen baris perintah tambahan yang diteruskan ke proses server saat startup. Biarkan kosong kecuali Anda memerlukan flag startup tertentu.
`SQLITE_TMPDIR`	(otomatis)	Direktori sementara yang digunakan oleh SQLite untuk operasi database. Biasanya tidak perlu diubah.

Setelah memperbarui variabel startup, restart server dari GPanel agar perubahan berlaku.

Manajemen Versi

Vintage Story menawarkan tiga cabang rilis. Pilihan cabang Anda diatur melalui variabel startup FILES_BRANCH di GPanel.

Cabang	Nilai	Deskripsi
Stable	`stable`	Cabang yang direkomendasikan untuk sebagian besar server. Rilis ini telah diuji secara menyeluruh dan paling andal untuk dunia jangka panjang.
Unstable	`unstable`	Rilis beta dengan fitur dan perubahan baru yang masih dalam pengujian. Mungkin mengandung bug. Gunakan ini jika Anda ingin akses awal ke konten baru dan menerima beberapa ketidakstabilan.
Pre-release	`pre`	Build pengembangan awal. Ini paling sedikit diuji dan mungkin memiliki masalah yang signifikan. Hanya direkomendasikan untuk tujuan pengujian -- bukan untuk server produksi.

Mengunci Versi Spesifik

Secara default, RELEASE_VERSION diatur ke latest, yang berarti server akan mengunduh dan menginstal versi terbaru yang tersedia pada cabang pilihan Anda setiap kali server dijalankan (jika versi yang lebih baru tersedia). Untuk mencegah pembaruan otomatis dan mengunci server Anda ke versi tertentu:

Buka tab Startup di GPanel.
Ubah RELEASE_VERSION dari latest ke nomor versi persis yang Anda inginkan (misalnya 1.19.8).
Restart server. Server akan hanya menggunakan versi yang dikunci terlepas dari rilis yang lebih baru.

Kompatibilitas mod: Jika Anda menjalankan mod, mengunci versi tertentu disarankan. Pembaruan game dapat merusak kompatibilitas mod, dan memperbarui di tengah permainan dapat menyebabkan masalah. Periksa bahwa mod Anda mendukung versi target sebelum memperbarui. Lihat Instalasi Mod Vintage Story untuk detailnya.

Beralih cabang mungkin memerlukan reset dunia. Berpindah antara cabang stable dan unstable dapat memperkenalkan perubahan format dunia. Selalu cadangkan dunia Anda sebelum mengubah cabang. Jika versi baru tidak kompatibel dengan dunia yang ada, Anda mungkin perlu memulai yang baru.

serverconfig.json

File konfigurasi server utama adalah serverconfig.json, yang terletak di direktori root server. File ini dihasilkan secara otomatis pada startup pertama. Hentikan server sebelum mengeditnya, lalu restart agar perubahan berlaku.

Hentikan server dari tab Console di GPanel.
Buka tab Files dan klik serverconfig.json untuk mengeditnya.
Modifikasi pengaturan yang Anda perlukan (lihat tabel di bawah).
Simpan file dan jalankan server.

Pengaturan Utama

Pengaturan	Contoh Nilai	Deskripsi
`ServerName`	`"My Legion VS Server"`	Nama yang ditampilkan di browser server in-game. Buat deskriptif agar pemain dapat menemukan server Anda.
`WelcomeMessage`	`"Welcome to the server!"`	Pesan yang ditampilkan kepada pemain saat mereka bergabung. Mendukung pemformatan dasar.
`MaxClients`	`16`	Jumlah maksimum pemain secara bersamaan. Harus sesuai dengan variabel startup `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Kata sandi yang diperlukan untuk bergabung dengan server. Biarkan sebagai string kosong (`""`) untuk server publik.
`AllowPvP`	`true`	Atur ke `true` untuk mengaktifkan pertarungan pemain lawan pemain, atau `false` untuk server khusus PvE.
`SpawnRadius`	`50`	Radius (dalam blok) di sekitar titik spawn dunia tempat pemain baru dapat muncul. Nilai yang lebih besar menyebarkan pemain lebih jauh saat bergabung.
`MapSizeX`	`1024000`	Lebar dunia dalam blok. Nilai default menciptakan dunia yang sangat besar. Mengurangi ini membatasi seberapa jauh pemain dapat bepergian timur-barat.
`MapSizeZ`	`1024000`	Kedalaman dunia dalam blok. Nilai default menciptakan dunia yang sangat besar. Mengurangi ini membatasi seberapa jauh pemain dapat bepergian utara-selatan.
`WorldSeed`	`"myseed123"`	Seed yang digunakan untuk pembuatan dunia. Seed yang sama menghasilkan dunia yang sama. Biarkan sebagai string kosong untuk seed acak.

Contoh minimal pengaturan utama di serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

File harus berupa JSON yang valid. Pastikan semua string diapit dengan tanda kutip ganda, boolean ditulis huruf kecil (true/false), dan tidak ada koma berlebih setelah item terakhir dalam objek atau array. Jika server gagal dijalankan setelah pengeditan, periksa kesalahan sintaks JSON.

Konfigurasi Dunia

Vintage Story menghasilkan dunianya berdasarkan pengaturan di serverconfig.json. Pembuatan dunia hanya terjadi pada startup pertama dengan dunia tertentu -- mengubah pengaturan pembuatan setelah dunia dibuat tidak akan secara retroaktif mengubah medan yang ada.

Pengaturan Pembuatan Dunia

WorldSeed: Menentukan tata letak medan, penempatan bioma, dan distribusi sumber daya. Atur seed spesifik untuk berbagi tata letak dunia yang sama dengan orang lain, atau biarkan kosong untuk dunia yang dihasilkan secara acak.
MapSizeX / MapSizeZ: Mengontrol area bermain maksimum. Nilai yang lebih kecil menciptakan dunia yang lebih terbatas dan dapat mengurangi penggunaan sumber daya. Pemain yang mencapai tepi peta tidak akan dapat bepergian lebih jauh ke arah tersebut.
WorldConfig: Objek WorldConfig dalam serverconfig.json memungkinkan Anda menyetel parameter pembuatan dunia seperti skala bentuk lahan, pola iklim, dan fitur geologis. Ini adalah pengaturan lanjutan -- default bekerja dengan baik untuk sebagian besar server.

Pengaturan pembuatan dunia dikunci setelah pembuatan. Pengaturan seperti WorldSeed, MapSizeX, dan MapSizeZ hanya berlaku saat dunia pertama kali dibuat. Untuk menerapkan pengaturan pembuatan baru, Anda harus membuat dunia baru (lihat Manajemen Penyimpanan di bawah).

Memilih Seed

Seed dapat berupa string teks atau angka apa pun. Pemain di komunitas Vintage Story berbagi seed untuk tata letak dunia yang menarik. Jika Anda menginginkan jenis medan atau lokasi spawn tertentu, cari di forum Vintage Story atau situs komunitas untuk seed yang direkomendasikan.

Cara Terhubung

Pemain terhubung ke server Vintage Story Anda melalui menu multiplayer in-game.

Direct Connect

Jalankan Vintage Story dan klik Multiplayer dari menu utama.
Klik Direct Connect.
Masukkan alamat IP dan port game server Anda dalam format:
```
your.server.ip:port
```
Periksa tab Network di GPanel untuk IP dan port yang ditetapkan untuk Anda.
Klik Connect. Jika server memiliki kata sandi, masukkan saat diminta.

Server Browser

Jalankan Vintage Story dan klik Multiplayer dari menu utama.
Server browser akan memuat daftar server publik. Gunakan bilah pencarian untuk menemukan server Anda berdasarkan nama (nilai ServerName dari serverconfig.json).
Klik server Anda di daftar dan klik Join.

Server tidak muncul di browser? Server browser dapat memakan waktu beberapa menit untuk mengindeks server yang baru dijalankan. Gunakan Direct Connect untuk akses langsung. Konfirmasikan juga bahwa Anda belum mengatur kata sandi -- server yang dilindungi kata sandi mungkin tidak muncul di browser publik tergantung pada pengaturan server.

Manajemen Penyimpanan

Data dunia Vintage Story disimpan di server Anda dan disimpan secara otomatis selama gameplay.

Lokasi Data Dunia

File penyimpanan dunia disimpan di direktori data/ pada server Anda. Path yang tepat bergantung pada nama dunia Anda. Anda dapat mengakses file-file ini melalui tab Files di GPanel atau via SFTP.

Mencadangkan Dunia Anda

Hentikan server untuk memastikan cadangan yang bersih (tidak ada file yang ditulis di tengah penyimpanan).
Terhubung ke server Anda via SFTP. Lihat Cara Mengunggah File melalui SFTP untuk instruksi koneksi.
Unduh seluruh direktori data/ ke mesin lokal Anda.
Simpan cadangan di lokasi yang aman. Pertimbangkan untuk menyimpan beberapa cadangan bertanggal jika Anda perlu kembali ke titik tertentu.

Cadangan rutin sangat disarankan. Kerusakan dunia, griefing yang tidak disengaja, atau pembaruan mod yang gagal semuanya dapat mengakibatkan kehilangan data. Cadangkan dunia Anda sebelum membuat perubahan signifikan apa pun seperti memperbarui versi game, menambahkan atau menghapus mod, atau mengubah pengaturan dunia.

Mereset Dunia

Untuk memulai dunia yang benar-benar baru:

Hentikan server dari tab Console di GPanel.
Cadangkan data dunia yang ada jika Anda ingin menyimpannya (lihat di atas).
Navigasikan ke direktori data/ di file manager GPanel dan hapus file penyimpanan dunia.
Secara opsional perbarui WorldSeed di serverconfig.json untuk menghasilkan tata letak dunia yang berbeda.
Jalankan server. Dunia baru akan dihasilkan dari awal menggunakan pengaturan konfigurasi Anda saat ini.

Menghapus file dunia bersifat permanen. Setelah dihapus, dunia tidak dapat dipulihkan kecuali Anda memiliki cadangan. Selalu unduh cadangan sebelum melakukan reset dunia.

Butuh Bantuan?

Jika Anda mengalami masalah yang tidak tercakup dalam panduan ini, buka tiket dukungan dan sertakan alamat IP server Anda, deskripsi masalahnya, dan output konsol yang relevan dari GPanel.

Panduan Pengaturan Server Vintage Story - Knowledgebase

Support

Categories

Panduan Pengaturan Server Vintage Story