Limited offer! Discounts of up to 50% on your servers

✨ BLACK FRIDAY ✨

November 19 to December 2, 2024

Guerrier près d'une cabane en bois la nuit

How to add an Xbox/Game Pass admin on a Valheim server?

Want to grant admin to an Xbox/Game Pass player on your Valheim server? Follow this clear, no-fluff guide. In minutes, your Xbox friend will run admin commands safely.

Prerequisites

  • Access to your Oxygenserv panel (login and password)
  • Valheim server installed and able to start
  • Crossplay enabled (launch arg -crossplay)
  • An Xbox/Game Pass player ready to join once
  • Windows PC with Valheim via Xbox app (to enable the in-game console)

Detailed steps

  1. Enable crossplay on your Valheim server
    Log into the Oxygenserv panel, open the “Configuration” or “Startup” section, and add -crossplay to the server launch arguments. Save, then hit the green “Restart” button to apply. In the console, you should see “PlayFab” lines and often a “Join code” when it’s working. If you don’t see PlayFab mentions or a join code, the flag wasn’t applied: re-check the arguments and restart again. Ensure UDP ports 2456, 2457, and 2458 are open on the server side (handled automatically on quality hosting).
  2. Have the Xbox/Game Pass player join to capture their XboxID
    Start the server and share the console “Join code” with the Xbox user (or temporarily make the server public for a quick test). Once they connect, open the panel “Console” and look for a line like: received local Platform ID Xbox_2535416401464117. Use the console search if needed and scroll slowly. If nothing shows up, confirm the player used the correct join code and that both server and client versions match.
  3. Copy the exact XboxID from the console
    Grab the full value starting with Xbox_, for example Xbox_2535416401464117, with no extra spaces. Keep the Xbox_ prefix intact. Store it in your clipboard or a notepad for the next step. If you only see a long numeric SteamID (no Xbox_), that’s a Steam player—wait for the Game Pass user to join.
  4. Add the ID to adminlist.txt
    In the panel “Files” tab, browse to /.config/unity3d/IronGate/Valheim (you may see it as /home/container/.config/unity3d/IronGate/Valheim). Open adminlist.txt. Paste the XboxID on a new line (one admin per line), for example Xbox_2535416401464117, then click “Save”. If the file doesn’t exist, create it with the exact name adminlist.txt in that folder.
  5. Restart the server and verify admins are loaded
    Click “Stop” then “Start” (or “Restart”). Watch the console: you should see a line indicating the admin list was loaded (e.g., “Loaded admin list with X entries”). Ask the Xbox player to reconnect after the restart to refresh their rights. In-game, they should open the console (F5), type devcommands, then a simple command like save; if it runs without errors, admin is active.
  6. (Optional) Remove an Xbox admin
    Open adminlist.txt again, delete the line containing their Xbox_..., and save. Restart the server to apply. Have them reconnect to drop their rights. If they still have access, check you edited the correct file and there’s no trailing space on the line.
  7. Enable the in-game console on the Xbox/Game Pass version (Windows)
    Go to the install folder: by default C:\XboxGames\Valheim\Content\. Right-click valheim.exe > “Create shortcut”. Right-click the shortcut > “Properties” > “Shortcut” tab > in “Target”, append a space then -console after the path, e.g., "C:\XboxGames\Valheim\Content\valheim.exe" -console. Click “OK”, launch the game via this shortcut, press F5 to open the console, type devcommands, then your admin commands (e.g., kick PlayerName, save).

Tips & optimization

Keep adminlist.txt tidy: one admin per line, no spaces. Limit admins (2–3 max) to prevent mistakes and abuse. Keep server and clients updated; PlayFab crossplay is version-sensitive. Run regular save and scheduled restarts for stability. Never share your Join code publicly; rotate it if you suspect a leak.

FAQ

I don’t see the XboxID in the console — what now?

Confirm -crossplay is in launch args, restart, and wait for PlayFab lines on boot. Make sure the player joined using the correct Join code and that versions match. Have them fully close Valheim and relaunch via the shortcut with -console. Clear the console and try again to spot the line easier.

User is in adminlist.txt but gets “You are not admin”

Ensure the line includes the Xbox_ prefix with no extra characters. Save the file and restart the server. The player must reconnect after restart. Double-check you edited the correct path /.config/unity3d/IronGate/Valheim.

Where is adminlist.txt if the folder looks empty?

Start the server once: Valheim generates folders/files on first run. If it’s still missing, create it manually (exact name: adminlist.txt) in /.config/unity3d/IronGate/Valheim. Remember Linux is case-sensitive.

Which basic admin commands can I test?

After devcommands, try save (force a world save), players (list players), kick PlayerName (kick), ban PlayerName (ban). If a command fails, it’s usually missing admin rights or a typo.

Done! Note your admin IDs and keep a backup of adminlist.txt. Keep this guide handy for quick edits the next time you add or remove an admin.

Related articles

Table des matières

Facebook
Twitter
LinkedIn