Panduan Admin Server Valheim — Argumen Launch, File Izin, dan Perintah In-Game

Prasyarat: baca panduan setup terlebih dahulu

Halaman ini membahas apa yang terjadi setelah dedicated server Valheim Anda berjalan. Jika Anda belum menyiapkan server, mulailah dengan dedicated-server-guide — panduan tersebut mencakup instalasi headless, port forwarding, dan script launch start_headless_server.sh / .bat.

Argumen launch — referensi lengkap 1.0

Valheim tidak memiliki file konfigurasi. Setiap pengaturan server dikirimkan sebagai flag command-line saat startup. Script launch dilengkapi dengan default yang wajar — salinlah copy sebelum aslinya agar update Steam tidak menimpa perubahan Anda.

Flag esensial (setiap server membutuhkan ini)

Flag	Default	Fungsinya
-name "text"	wajib	Nama server yang ditampilkan di browser server Steam / crossplay
-world "text"	wajib	Nama file dunia. Dunia baru akan dibuat otomatis jika file tidak ada.
-password "text"	wajib	Minimal 5 karakter dan tidak boleh muncul di dalam nama dunia atau seed. Valheim akan menolak booting dengan password yang tidak valid — periksa ini terlebih dahulu jika server Anda mati saat launch.
-port N	2456	Port game. Valheim bind ke port ini dan port berikutnya (2457 untuk Steam query / A2S). Panel host Anda biasanya menangani ini — jangan tambahkan sendiri kecuali Anda yakin butuh.
-nographics	—	Wajib untuk headless server. Menonaktifkan pipeline rendering game. Jangan hapus ini dari dedicated server — akan menyebabkan crash.
-batchmode	—	Menjalankan engine Unity dalam mode batch (headless). Juga wajib untuk dedicated server.

Flag crossplay dan visibilitas

Flag	Default	Fungsinya
-crossplay	off	Mengaktifkan jaringan PlayFab crossplay. Tanpa flag ini, hanya pemain Steam yang bisa melihat dan join server Anda. Pemain console (Xbox / PS5 / Switch 2) tidak bisa konek ke server backend Steam sama sekali — ini adalah batasan arsitektur, bukan bug.
-public 1 atau 0	1	1 membuat server terdaftar di browser komunitas; 0 berarti pemain hanya bisa join via IP atau join code.

Apa yang sebenarnya diubah oleh -crossplay

Iron Gate mendokumentasikan ini di panduan dedicated server resmi:

Jika Anda menggunakan backend Crossplay (-crossplay), server mengirimkan data melalui relay server dan oleh karena itu tidak memerlukan port forwarding untuk bisa diakses dari luar jaringan lokal. Anda bisa konek menggunakan IP publik + port, join code, atau melalui daftar server. Tidak mungkin konek menggunakan IP lokal atau loopback address.

Jadi: crossplay = relay PlayFab = tidak perlu port forwarding. Backend Steam = koneksi langsung = perlu port forwarding. Pilih satu dan teguhkan sebelum mengundang pemain. Anda bisa berganti, tapi mengubah -crossplay memerlukan restart.

⚠️ Penting untuk server modded: Jika Anda ingin pakai mod, hapus -crossplay dari script launch Anda. Mod BepInEx menggunakan hook jaringan Steam dan tidak bisa load di backend PlayFab. Ini tidak bisa diperbaiki — begitulah desain kedua layer jaringan tersebut. Lihat mod ecosystem guide untuk detail lengkap.

Template launch Linux standar

#!/bin/sh
export templdpath=$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=./linux64:$LD_LIBRARY_PATH
export SteamAppId=892970
./valheim_server.x86_64 \
  -nographics -batchmode \
  -name "MyServer" \
  -port 2456 \
  -world "MyWorldFilename" \
  -password "ChangeMeNow" \
  -crossplay -public 1
export LD_LIBRARY_PATH=$templdpath

Salin ini, simpan sebagai start_server.sh, chmod +x, lalu jalankan.

Tiga file izin — adminlist, bannedlist, permittedlist

Valheim tidak memiliki tombol “tambah admin” in-game. Semua izin server dikontrol oleh tiga file plain-text yang disimpan di direktori data game:

• Windows: %UserProfile%\AppData\LocalLow\IronGate\Valheim\
• Linux / macOS: ~/.config/unity3d/IronGate/Valheim/

File-file ini berada di luar folder instalasi dedicated server Anda — mereka berada di direktori data pemain karena headless server berbagi konteks akun Iron Gate yang sama. Penyedia hosted server biasanya mengekspos folder ini melalui panel file manager mereka.

adminlist.txt — berikan hak admin

// Platform User ID — satu per baris
76561198012345678
76561198087654321

Platform User ID mengikuti format [Platform]_[User ID] dan case sensitive. Anda mendapatkannya dari log console server (saat pemain konek) atau dari panel pemain F2 in-game (hanya terlihat oleh admin setelah mengetik admin). Formatnya:

• Pemain Steam: Steam_1234567890
• Pemain Xbox: XBox_1234567890 (dikonfirmasi 2024; format Xbox 1.0 yang sedang diverifikasi)
• Pemain PS5: PlayStation ID dalam format yang diekspos panel host Anda
• Pemain Switch 2: sama — cari di log server

Satu entri adminlist = satu admin untuk semua karakter. Anda tidak perlu menambahkan setiap karakter yang dibuat pemain.

bannedlist.txt — ban permanen

// Field alasan ban opsional; format baris: [Platform]_[User ID]
Steam_1234567890
XBox_9876543210

Pemain yang di-ban tidak bisa join meskipun mereka tahu password atau join code. Keputusan ban sebaiknya dibuat dari console server (lihat di bawah) karena perintah ban mencatat alasan ban dan nama pemain, sehingga lebih mudah dibatalkan nanti.

permittedlist.txt — mode whitelist

Setiap entri di permittedlist.txt akan ban semua orang yang tidak ada di daftar. Ini adalah mode whitelist Valheim — berguna untuk server pribadi, server guild, atau turnamen. Biarkan file benar-benar kosong (jangan dihapus, cukup kosong) jika Anda ingin semua orang yang punya password bisa join.

// Biarkan kosong untuk mengizinkan siapa pun yang punya password
Steam_1234567890
XBox_9876543210

Iron Gate memperingatkan: “Menambahkan seseorang ke permitted list akan ban semua orang lain dari server.” Ini disengaja dan didokumentasikan — jangan tidak sengaja memasukkan Steam ID Anda sendiri di sini saat sedang test.

Perintah admin in-game — daftar lengkap untuk dedicated server

Hanya pemain yang terdaftar di adminlist.txt yang bisa menjalankan ini. Tekan F5 untuk membuka console. Formatnya nama perintah tanpa tanda baca tambahan.

Perintah admin server-wide

Perintah	Efek
kick PLAYERNAME	Mengeluarkan pemain dari server. Tidak mem-ban — mereka bisa konek kembali segera.
ban PLAYERNAME	Kick dan ban. Ban ditulis ke bannedlist.txt.
unban PLAYERNAME	Menghapus ban. Setara dengan mengedit bannedlist.txt secara manual.
banned	Mencantumkan semua pemain yang sedang di-ban.
admin	Menampilkan admin mana yang sedang terkoneksi saat ini.
recall PLAYERNAME	Teleport pemain (atau recall all) ke lokasi Anda saat ini. Berguna untuk menyelamatkan pemain yang terjebak di terrain.
save	Memaksa server untuk menyimpan segera alih-alih menunggu interval auto-save (~20 menit).

Perintah client yang tersedia untuk admin

Ini berlaku untuk karakter Anda sendiri, bukan pemain lain:

Perintah	Efek
god	Toggle keabadian.
ghost	Musuh mob mengabaikan Anda. Bagus untuk memeriksa terrain atau menguji titik spawn.
nocost	Tidak ada biaya resource saat membangun. Aktifkan untuk menyusun base, matikan sebelum teman-teman join.
freefly	Kamera terlepas dari karakter — gunakan untuk screenshot atau video sinematik.
exploremap	Reveal peta pribadi Anda sepenuhnya. Hanya memengaruhi save karakter Anda.
pos	Mencetak koordinat saat ini — berguna untuk mengarahkan teman yang terjebak.

devcommands vs vanilla admin commands: Perintah seperti god, spawn, freefly, findbiome, dan cinematic di 1.0 memerlukan devcommands di client Anda sebelum sesi dimulai. Flag ini akan menandai karakter dan dunia Anda secara permanen agar tidak bisa mendapatkan achievement — patch terbaru Iron Gate menghapus flag devcommands dari kelayakan achievement, jadi jika dunia Anda sudah ter-mark, Anda perlu menjalankan yes i used devcommands but i want my achievements anyway (hapus spasi) untuk opt-in kembali. kick, ban, save, admin sisi server berjalan tanpa devcommands di client admin mana pun.

Shut down dengan benar

Tekan CTRL+C di jendela console server. Mengeklik tombol X close mungkin membiarkan proses server berjalan di background — Iron Gate mengonfirmasi ini adalah masalah yang diketahui. Selalu gunakan CTRL+C untuk shut down yang bersih.

---

Tautan

• dedicated-server-guide — panduan setup yang Anda baca pertama
• crossplay — join code, mismatch versi, bagaimana crossplay bekerja end-to-end
• connection-troubleshooting — checklist “versi tidak kompatibel” dan connection-refused
• mod-ecosystem-1-0 — BepInEx vs PlayFab, status Valheim Plus, pengganti standalone
• devcommands-deep-dive — daftar lengkap devcommands 1.0 dan opt-in achievement