Basic Server Settings

For more information on getting started running a server, visit how to run a server.

Master Server Communication Settings

addmaster

Usage: addmaster (ip/domain:port)

Adds a master server which the server will advertise to if usemasters is enabled. Server can be added by domain name or ip address followed by port.

delmaster

Usage: delmaster (ip/domain:port)

Deletes a master server which the server will advertise to if usemasters is enabled. Server is deleted by typing delmaster and then any information before the brackets.

masters

Usage: masters

Lists master servers which the server will advertise to if usemasters is enabled.

usemasters

Usage: sv_usemasters (0-1)

If this cvar is enabled, your server will use all of the defined master servers. See masters for more info on managing contacted master servers. If disabled, your server will be a "private" server and will not show up on launchers.

Advertising Settings

email

Usage: sv_email "email@domain.com"

The email cvar is an optional cvar used to display the contact information of a server administrator. It may be left blank.

hostname

Usage: sv_hostname "Example Server Name"

Your hostname is what your server will appear named as in launchers. It is essentially your server's identity to the outside world.

website

Usage: sv_website "http://odamex.net/"

The website can be used to display your server's official website or perhaps the location of the wads that you run on your server. This field may be left blank.

=motd

Usage: sv_motd "Welcome to Odamex!"

The motd (which stands for message of the day) is displayed to players on connect. In the example above, players would be greeted with the message "Welcome to Odamex!". This field may be left blank.

Privacy Settings

Bans & Exceptions

Read ban and exception lists for more information.

password

Usage: join_password "example"

If you wish to make your server open to only those you know, you can create a password that is required to join your server. To set a password on your server, simply type join_password followed by your actual password. To have no password on your server, leave the password blank.

Client Connections

For information on protecting your server from malicious users, visit Abuse Prevention.

maxclients

This is a latched variable, and only takes effect after a map change.

Usage: sv_maxclients (1-255)

The maxclients cvar determines how many total clients may connect to a server (and spectate). Though there is theoretical support for up to 255 players in Odamex the true limit depends on the machine running the server and will vary.

maxplayers

This is a latched variable, and only takes effect after a map change.

Usage: sv_maxplayers (1-255)

The maxplayers cvar determines how many total clients may actually join in the game and play. The number of players allowed in a server must be equal or less than maxclients.

waddownload

Usage: sv_waddownload (0-1)

The wad downloading feature takes it cue from more modern gaming engines. Much like games such as Quake and Half-Life, Odamex allows players that connect to download the map files required to play (if they do not already have them).

If enabled, any client connecting that does not have the needed wad will download it directly from the server.