This guide covers admin setup, in-game admin commands, RCON configuration, and server management commands for your Soulmask dedicated server on Legion Hosting. For server setup and configuration, see Soulmask Server Setup Guide.
Setting Admin Privileges
Soulmask uses a password-based admin system. To become an admin, you need to set an admin password in the server startup configuration and then authenticate in-game.
Step 1: Set the Admin Password
- In GPanel, select your Soulmask server.
- Click the Startup tab.
- Set the
ADMIN_PASSWORDvariable to a strong, unique password. This corresponds to the-adminpswcommand-line parameter. - Restart the server for the change to take effect.
Step 2: Authenticate In-Game
- Join your Soulmask server as a player.
- Open the in-game console by pressing the ` (grave/tilde) key or Numpad - (numpad minus).
- Type the following command and press Enter:
gm key YOUR_ADMIN_PASSWORD - If the password is correct, you will see a confirmation message and gain GM (Game Master) admin privileges.
- You can also click the "Become the admin" button that appears in the GM panel interface.
gm key each time you log in.
In-Game Admin Commands
Once authenticated as an admin, open the console (` or Numpad -) and enter commands. All admin commands begin with the gm prefix.
Player Management
| Command | Description |
|---|---|
gm AddExp [value] |
Add general experience points to your character. |
gm Addmjexp [value] |
Add mask experience to your character (levels up the mask). |
gm Addshoulieexp [value] |
Add hunting experience to your character. |
gm XiDian |
Reset all skill points for your character, allowing respec. |
gm FuHuo |
Revive your character (use when dead). |
gm ZiSha 1 |
Kill your own character (suicide command). |
gm shanhao |
Delete your account/character from the server. Use with extreme caution -- this is irreversible. |
gm ShowInfo 1 |
Display detailed information about your own character (stats, IDs, position). |
gm ShowInfo 0 |
Display detailed information about the currently targeted character or NPC. |
gm ChongZhiRenWu |
Reset all tutorials and guide quests for your character. |
Navigation and Visibility
| Command | Description |
|---|---|
gm Go [x] [y] [z] |
Teleport to specific world coordinates. Use GPS to find your current coordinates first. |
GPS |
Display your current world coordinates (X, Y, Z). Useful for teleportation targets. |
gm SetAttr YinShen 1 |
Enable invisibility. Monsters and NPCs cannot detect you. |
gm SetAttr YinShen 0 |
Disable invisibility. Return to normal visibility. |
gm ShowMap |
Reveal the entire map, unlocking all fog of war for your character. |
NPC and World Control
| Command | Description |
|---|---|
gm ZhaoMu |
Instantly recruit the targeted NPC to your tribe. |
gm ClearAllNpc |
Remove all non-player NPCs from the server. Use with caution -- affects all NPCs server-wide. |
gm ClearSelect |
Remove the currently selected/targeted entity (NPC, creature, or object). |
gm ShuaXinZhiBei |
Refresh and regrow all nearby vegetation and harvestable plants. |
gm KeJiShu |
Unlock all technology tree nodes for your character. |
Invasion and Heat Management
| Command | Description |
|---|---|
gm ShowReDu |
Display the current invasion heat chart, showing threat levels in different areas. |
gm ClearAllReDu |
Clear all invasion heat across the map, resetting threat levels to zero. |
gm AddReDu [value] |
Manually increase invasion heat by the specified amount. Higher heat attracts more invasions. |
Server and Debug
| Command | Description |
|---|---|
gm exit |
Gracefully shut down the server with a save. This is the safest way to stop the server from in-game. |
Debuginfo 1 |
Enable server performance monitoring overlay, showing tick rate, entity counts, and resource usage. |
Debuginfo 0 |
Disable the server performance monitoring overlay. |
Server Management Commands
These commands are used for server-wide management and can be executed both in-game (via console) and remotely (via RCON/Telnet).
Server Control
| Command | Description |
|---|---|
SaveWorld |
Force an immediate world save to memory (and optionally to disk). Use before performing risky operations. |
SaveAndExit [seconds] |
Save the world and shut down the server after the specified number of seconds. Players receive a warning countdown. |
StopCloseServer |
Cancel a pending shutdown that was initiated with SaveAndExit. |
shutdown [seconds] |
Initiate a graceful server shutdown with the specified countdown in seconds. |
broadcast [message] |
Send a global message to all connected players. Useful for announcements and warnings. |
Player Administration (Remote)
| Command | Description |
|---|---|
List_AllPlayers |
List all player accounts registered on the server (online and offline). |
List_OnlinePlayers |
List all currently connected players with their Steam IDs and character names. |
List_Guilds |
List all tribes (guilds) on the server with member counts. |
kick [PlayerName] |
Kick a player from the server by character name. |
ban [PlayerName] |
Ban a player from the server. They will not be able to reconnect. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Add items directly to a specific player's inventory by Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teleport a specific player to world coordinates. |
FlyMode [SteamID] [0/1] |
Enable (1) or disable (0) ghost/fly mode for a player. |
Server Information
| Command | Description |
|---|---|
ServerFPS |
Display the current server tick rate (FPS). Healthy servers should maintain 30+ FPS. |
Show_Coefficient_Settings |
List all current gameplay coefficient settings from GameXishu.json. |
Set_Coefficient [key] [value] |
Modify a gameplay coefficient at runtime without editing files. Changes take effect immediately. |
List_AllTalent [level] |
View all natural gifts (talents) available at the specified level. |
Debug and Advanced
| Command | Description |
|---|---|
Dump_AllActorPositions |
Export all actor positions to a data file for debugging world state. |
DrawActorImage |
Generate a visualization of actor positions on the map. |
ExecScriptCommands [filename] |
Run a batch file of commands. Useful for executing multiple commands at once. |
RCON Access
RCON (Remote Console) allows you to execute server commands remotely without being connected to the game. Soulmask supports both RCON and Telnet for remote administration.
Enabling RCON
RCON is disabled by default and must be enabled through startup parameters:
- In GPanel, go to the Startup tab.
- Add the following parameters (through additional startup parameters or by contacting support to have them added):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Restart the server.
Connecting via RCON
Once RCON is enabled, you can connect using any standard RCON client:
- Download an RCON client such as rcon-cli or a GUI tool like mcrcon.
- Connect to your server using:
- Host: Your server's IP address
- Port: The RCON port (default
19000) - Password: The RCON password you set with
-rconpsw
- Once connected, type
helpto see a list of available commands.
Telnet Access
Soulmask also supports Telnet-based administration on the Echo Port (default 18888). Telnet is restricted to local connections only by default and does not require additional port forwarding. This is primarily used for scripted administration on the server machine itself.
Example RCON Session
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServer
Proper Server Shutdown
There are several safe methods to shut down a Soulmask server. Always use one of these to prevent data loss:
- GPanel Stop button: The simplest method. Click Stop in the GPanel Console tab.
- In-game command: Authenticate as admin and run
gm exitto save and shut down. - RCON/Telnet: Run
shutdown [seconds]orSaveAndExit [seconds]for a countdown shutdown that gives players time to prepare.
Tips for Server Administrators
- Set up automatic backups. Use
-initbackupand-backupinterval=30to create regular backup snapshots. - Monitor server FPS. Use the
ServerFPScommand regularly. If the tick rate drops below 15-20 FPS, the server is struggling and may need optimization or a restart. - Use
Set_Coefficientfor live tuning. You can adjust gameplay settings at runtime without restarting the server. RunShow_Coefficient_Settingsfirst to see current values. - Schedule regular restarts. Restart the server daily to clear memory leaks and apply any pending updates.
- Broadcast before maintenance. Always use the
broadcastcommand to warn players before server restarts or maintenance windows. - Use
SaveWorldbefore risky operations. Force a save before making significant changes like clearing NPCs or modifying coefficients.
Related Articles
- Soulmask Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Need Help?
If you need further assistance with Soulmask admin commands or server management, please open a support ticket and our team will be happy to assist you.