Server console commands - UserXXX/vCom GitHub Wiki

This page gives an overview over the commands the server application supports. Parameters set in [...] are optional. Parameters set in (...) must be present.

help

Displays help information.

Syntax: help [options]

Parameters

options

No options defaults to -l.

Value Meaning
-list (-l) Lists all commands, after -l a regular expression for filtering can be used.
command name Lists the help for a specific command.

showusers

Displays lists of users.

Syntax: showusers [option] [filter]

Parameters

option
Value Meaning
-online (-o) Display online users only.
-blacklist (-b) Displays blacklisted users only.
-whitelist (-w) Displays whitelisted users only.
-complete (-c) Displays the complete available information for each user.

Combinations of the above options may be used, such as "-online -complete" or "-oc", but oly one of -o, -b or -w.

filter

A regular expression for filtering the list.

get

Gets the value of a setting and prints it out.

Syntax: get (setting)

Parameters

setting

The setting. Valid values are:

Value Meaning
maxfiletranfersize Maximum file transfer size in KB.
maxusers Maximum number of users that can register on this server.
maxonlineusers Maximum number of users that are allowed to be online simultaneously.
maxinboxsize Maximum size of each users inbox in KB.
messagelifetime Lifetime of messages in days.
updatetype Type of update (autoupdate / prepare only / do not update).

set

Sets the value of a setting.

Syntax: set (setting) (new value)

Parameters

setting

The setting. Valid values are:

Value Meaning
maxfiletranfersize Maximum file transfer size in KB.
maxusers Maximum number of users that can register on this server.
maxonlineusers Maximum number of users that are allowed to be online simultaneously.
maxinboxsize Maximum size of each users inbox in KB.
messagelifetime Lifetime of messages in days.
updatetype Type of update (autoupdate / prepare only / do not update).
new value

Value to set, depends on setting.

reloadconfig

Reloads the configuration files (including the schedule).

Syntax: reloadconfig

whitelist

Modifies the whitelist.

Syntax: whitelist [enabled] [parameters]

Parameters

enabled

One of these values:

Value Meaning
-enable (-e) Enables the whitelist. Only one of whitelist and blacklist can be active at the same time.
-disable (-d) Disables the whitelist.
parameters

Can contain multiple of the following actions:

Command Meaning
<-add / -a> <-name / -n / -id / -i> Adds an entry to the whitelist.
<-remove / -r> <-name / -n / -id / -i> Removes an entry from the whitelist.

The parameters are used as follows:

Parameter Content of identifier
-name (-n) identifier is a name of a user.
-id (-i) identifier is an user identifier.

blacklist

Modifies the blacklist.

Syntax: blacklist [enabled] [parameters]

Parameters

enabled

One of these values:

Value Meaning
-enable (-e) Enables the blacklist. Only one of whitelist and blacklist can be active at the same time.
-disable (-d) Disables the whitelist.
parameters

Can contain multiple of the following actions:

Command Meaning
<-add / -a> <-name / -n / -id / -i> Adds an entry to the blacklist.
<-remove / -r> <-name / -n / -id / -i> Removes an entry from the blacklist.

The parameters are used as follows:

Parameter Content of identifier
-name (-n) identifier is a name of a user.
-id (-i) identifier is an user identifier.

restart

Restarts the server.

Syntax: restart

shutdown

Finishes all actions and shuts the server down.

Syntax: shutdown

maintenance

Runs a maintenance (may decrease server performance and restart the server).

Syntax: maintenance

update

Installs a previously downloaded update (if any) or searches for a new update and installs it.

Syntax: update

⚠️ **GitHub.com Fallback** ⚠️