Admin Guide
This guide is written so that Server Admins know and understand the new commands that are built into XreaL, and some other basic things, like how to start a dedicated server, etc.
Starting a Dedicated Server on Linux
It is the best to use the "screen" command to create a server on a Linux terminal.
$ screen -S xreal-game ./xreal-server.x86 +set dedicated 2 +exec ffa.cfg
Then you can detach from the screen and the server will continue to run in the background.
(Ctrl-a) d
You can close the terminal. If you want to resume the screen then type:
$ screen -r xreal-game
You can now change the server map or even stop the server.
You can also terminate the screen including the server with:
(Ctrl-a) \
Starting a Dedicated Server on Win32
Starting a dedicated server for Internet play is quite simple with XreaL. Simply run XreaL with these options:
xreal.exe +set dedicated 2 +exec ffa.cfg
"+set dedicated 2" means that the dedicated server will be online, as 1 means a dedicated LAN server.
"+exec ffa.cfg" will automatically execute the default Free for All server config. You can modify this to change the map rotation, name, motd, etc. of the server.
Using HTTP/FTP Download Redirection
You can enable redirected downloads on your server by using the 'sets' command to put the sv_dlURL cvar into your SERVERINFO string and ensure sv_allowDownloads is set to 1. An example of that command is:
sets sv_dlURL "http://xreal.sourceforge.net/"
sv_dlURL is the base of the URL that contains your custom .pk3 files. The client will append both fs_game and the filename to the end of this value. For example, if you have sv_dlURL set to "http://xreal.sourceforge.net/", fs_game is "base", and the client is missing "test.pk3", it will attempt to download from the URL "http://xreal.sourceforge.net/base/test.pk3".
sv_allowDownload's value is a bitmask made up of the following flags:
1 - ENABLE
2 - do not use HTTP/FTP downloads
4 - do not use UDP downloads
8 - do not ask the client to disconnect when using HTTP/FTP
Server operators who are concerned about potential "leeching" from their HTTP servers from other XreaL servers can make use of the HTTP_REFERER that XreaL sets which is "XreaL://{SERVER_IP}:{SERVER_PORT}". For example, Apache's mod_rewrite can restrict access based on HTTP_REFERER.