Getting started with your SoulMask server

Soulmask is a tribal survival action game with a strong NPC follower system and large open world.

First Boot

1. Open your Soulmask server in the panel.
2. Click Start.
3. First boot pulls the dedicated server (about 30 GB), which takes 20 to 30 minutes.
4. Watch for LogInit: Server is ready in the console.

To connect: in Soulmask, Multiplayer > Direct Connect, enter the IP and port from the Address at the top left of your panel.

Configuration: GameXishu.json

Soulmask ships a native Linux server build, which is exactly what our panel runs, so there is no compatibility layer involved and no Windows folder to hunt for. Server identity (name, passwords, slots, and PvE or PvP mode) is controlled from the Startup tab variables like everything else on our panel.

Gameplay tuning lives in WS/Saved/GameplaySettings/GameXishu.json, generated on first boot. It is one large JSON file where nearly every gameplay variable has a self-describing name: experience and gathering rates, crafting speeds, day and night length, tribe and follower limits, decay, and more.

Editing rules:

1. Stop the server first. Soulmask writes the file on shutdown and overwrites live edits.
2. Back up the file before big changes.
3. Keep the JSON valid: one missing comma resets everything to defaults on the next boot.
4. Change a few values at a time and restart to test.

Admin Setup

The AdminPassword grants in-game admin access. In-game:

1. Open chat with Enter.
2. Type /login YOUR_ADMIN_PASSWORD.
3. You now have admin commands available.

Once authenticated, the GM toolset unlocks: item spawning, teleporting, kicking and banning, and weather and time control, all from the in-game admin interface.

Mods

As of the current dedicated server build, Soulmask has limited official mod support. Some community tools exist for save editing.

Watch the Soulmask Discord and the Steam Community Hub for updates as the modding ecosystem develops.

World Management

The save is at WS/Saved/<MapName>/. To wipe:

1. Stop the server.
2. Delete the save folder.
3. Restart. A new world generates.

To upload a save from single-player, copy your local save folder to the same path.

Backups

The save grows steadily as players build and NPCs accumulate. Use the panel's Backups tab daily. Always back up before major patches.

Common Issues

• Server hangs on boot: First boot can take 25+ minutes for the dedicated server to initialize. Wait before assuming a hang.
• Players cannot connect: Confirm MaxPlayers and the assigned port match.
• NPC followers behaving erratically: Restart the server. Long uptimes degrade the follower pathfinding.
• Save corruption: Restore from backup. NPC follower state can occasionally corrupt; backups are essential.

---

Made with 💜 by GameServerKings