How To Use RCON On Soulmask
This guide provides step-by-step instructions on how to set up and manage your Soulmask server using RCON. This is a fairly new feature and is also sometimes referred to as TELNET in the Soulmask community.
Basic RCON Commands
Section titled âBasic RCON CommandsâHere is a list of all the RCON commands with basic details.
Command | Description |
---|---|
help | Shows all the current RCON commands. |
quit/close/shutdown seconds | After the number of seconds specified by the parameter, save and exit the game world. |
saveworld | Only save world archive without exiting. |
backup new_database_name | Back up the world archive to a database file with the specified name. |
backuphour | Back up the world archive and name it with the current date and time (UTC), for example: YYYYmmddHH.db |
dpp | Export the basic information of all accounts (account, role, union, level, total online time, creation time, etc.) to Saved/ALL_PLAYER_INFO.txt. |
setpm flag | Set the server login permission management switch (0 to turn off all permissions, 15 to turn on all permissions). |
serverfps | Displays the average frame rate of the server over a short period of time. |
QueryInvitationCode | Displays the serverâs Invitation Code. |
List_OnlinePlayers | Lists the account, name, and body ID of online players. Alias: lp |
List_AllPlayers | Lists basic information for all players and database information. Alias: lap |
List_SameBelongingObjs | Lists characters sharing the same ownership as the player. Alias: ls |
List_Guilds | Lists registered guild information on the server. Alias: lg |
List_GuildObjs | Lists all character information under a specified guild. Alias: lgo |
List_AllNPCClass | Lists all character types and class names. Alias: lcc |
Show_Coefficient_Settings | Lists game coefficient items and their current values. Alias: lc |
List_ServerPermissionList | Lists all server permission list information. Alias: lsp |
Set_Coefficient | Sets game coefficients. Alias: sc |
Set_ServerPermissionEnable | Sets the status of a server permission item. Alias: ssp |
Set_ServerPermissionFlag | Sets the server permission flag, globally setting the server permission status. Alias: sspf |
Update_ServerPermissionList | Sets the contents of the server permission list (add/remove). Alias: usp |
Set_OutputChats | Sets whether server chat content is output to the log. Alias: soc |
GotoPostion | Teleports a character to specified coordinates. Alias: go |
GotoTarget | Teleports a character near another character. Alias: gonpc |
CreateSpecifiedMan | Creates a barbarian based on a template number, belonging to a specified player. Alias: cnpc |
CreateSWByClass | Creates a barbarian/animal character based on the class name. Alias: create |
FlyMode | Enables/disables flight mode (ghost mode) for a specified player. Alias: fly |
Update_RconClientAddress | Adds or removes IP addresses from the RCON whitelist. Alias: ura |
Adding IPs to Whitelist
Section titled âAdding IPs to WhitelistâFor security reasons, RCON uses an IP whitelist. Only whitelisted IP addresses can connect to the serverâs RCON service. We also donât allow access to this publicly unless requested via a support ticket
-
Modify
WS/Saved/Config/[Platform]Server/Engine.ini
:[Server.SafeIP]IP=xxx.xxx.xxx.xxxIP=yyy.yyy.yyy.yyy -
Use RCON command (not saved after server restart):
ura 1 xxx.xxx.xxx.xxx,yyy.yyy.yyy.yyy
Help Command
Section titled âHelp CommandâType help
in the terminal to display information about available commands.
DESC
: Command descriptionAlia
: Command aliasExample
: Usage example
You can use the command number as a shortcut to execute commands.
Information Retrieval Commands
Section titled âInformation Retrieval Commandsâ-
List_OnlinePlayers (Alias:
lp
)- Lists online playersâ account, name, and body ID
- Format:
| Steam Account | Player Name | Current Body ID |
-
List_AllPlayers (Alias:
lap
)- Lists all playersâ basic and database information
- Format:
| Steam Account | Player Name | Guild Name | Awareness Level | Total Online Time (seconds) | Account Creation Time (UTC) |
-
List_SameBelongingObjs (Alias:
ls
)- Lists characters with the same ownership
- Parameters: Steam account or Character/mount ID
- Format:
| Character Name | Character ID |
-
List_Guilds (Alias:
lg
)- Lists registered guild information
- Format:
| Guild Name | Guild ID | Guild Leader Name |
-
List_GuildObjs (Alias:
lgo
)- Lists all characters in a specified guild
- Parameters: Guild Name or Guild ID
- Format:
| Character Name | Character ID |
-
List_AllNPCClass (Alias:
lcc
)- Lists all character types and class names
- Optional parameter to filter results
- Format:
| Default Character Name | Character Class Name |
-
Show_Coefficient_Settings (Alias:
lc
)- Lists game coefficient items and their values
- Optional parameter to filter results
- Format:
| Coefficient Name | Current Coefficient Value |
-
List_ServerPermissionList (Alias:
lsp
)- Lists all server permission information
Setting Commands
Section titled âSetting Commandsâ-
Set_Coefficient (Alias:
sc
)- Sets game coefficients
- Parameters: Coefficient name, New value
-
Set_ServerPermissionEnable (Alias:
ssp
)- Sets the status of a server permission item
- Parameters: Permission number (0-4), Enable status (0 or 1)
-
Set_ServerPermissionFlag (Alias:
sspf
)- Sets the server permission flag globally
- Parameter: Integer (sum of flag values)
-
Update_ServerPermissionList (Alias:
usp
)- Modifies server permission list (add/remove)
- Parameters: Permission type, Add/remove flag, List of accounts/IPs
-
Set_OutputChats (Alias:
soc
)- Enables/disables server chat output to log
- Parameter: 0 (disable) or 1 (enable)
Other Commands
Section titled âOther Commandsâ-
GotoPostion (Alias:
go
)- Teleports a character to specified coordinates
- Parameters: Character identifier, X, Y, Z coordinates
-
GotoTarget (Alias:
gonpc
)- Teleports a character near another character
- Parameters: Character to teleport, Target character
-
CreateSpecifiedMan (Alias:
cnpc
)- Creates a barbarian based on a template
- Parameters: Playerâs Steam account, Template number, Gender (0/1)
-
CreateSWByClass (Alias:
create
)- Creates a barbarian/animal character
- Parameters: Playerâs Steam account, Class name, Normal/Offspring, Level, Quantity, Quality
-
FlyMode (Alias:
fly
)- Enables/disables flight mode for a player
- Parameters: Playerâs Steam account, Enable/Disable (1/0)
-
Update_RconClientAddress (Alias:
ura
)- Adds/removes IP addresses from RCON whitelist
- Parameters: Add/Remove (1/0), IP address