Server Setup

From ETQWPro Wiki Pages

Jump to: navigation, search

Contents

Notice

Image:Server.png

Setting up server is for advanced users only.
First rule of admin - noone is going to help you, you must find the info on your own.
That means that you will have to think a lot. If you got problems with that - don't do it.

Intro

  • First of all, I hope you have set up previously some game server, the best if it was ETQW server or any Quake server. I'm not going to teach you how to set up server from scratch - there are many tutorials on how to set up basic ETQW server on the net. All you have to do is to read them carefully a few times until you manage it.
  • I assume you already have a working ETQW server in the vanilla - that is a server without any mods, it can be ranked or unranked. ETQW servers with ETQWPro enabled can not become officially ranked Servers. However ETQWPro version 0.6 introduced another global ranking system.
  • Most of configuration will be explained on Linux servers, Windows machines are almost the same to set up, the paths are just different.

Requirements

  • Running ETQW Server, with extra 20mb of hard disk space (well ;) )
  • Access to upload files to the server directory where it is installed. Enable showing of hidden files in interface (ftp client).
  • Access to modify sever startup script or at least startup parameters.

All above usually means that you can alter startup script via FTP/SSH/WebPanel. If you cannot get at least oe of those three, you are gone.

Fresh Installation

  • TURN OFF GAME SERVER now :)
  • Grab that data disk and... erm, download ETQWPro from official site. Unpack it, you will get the etqwpro directory - upload it to the directory where game is installed. Image from Windows will help you understand it ;)

Image:Etqwpro installed in fs basepath.gif

  • Notice that you will have some files in .etqw directory - due to the ETQW directory structure. In that directory ETQW writes files, notice that this directory starts with dot, usually such directories are known as hidden and are not displayed normally.

Configuration

  • Download server.cfg to your machine and edit it to suit your needs, below is list of things you should pay attention:
    • si_name - server name, its nice to add the note what ETQWPro version server is running, don;t say latest cause it means nothing.
    • net_serverPunkbusterEnabled - better keep it equal 1
    • net_LANServer - if you host a Local Area Network server then set it to 1, otherwise use 0.
    • si_privateClients - number of reserved slots - keep it low, 2 is enough.
    • si_needpass - set it to 1 it if is private server for matches, clan practice etc.
    • g_password - set here some UNIQUE server password on join.
    • g_privatePassword - password to get into the reserved slot if server is full.
    • net_serverRemoteConsolePassword - remote admin console, do not give it to anyone except admin owner that pays the bills.
    • si_disableVoting - do not turn it off if there are no admins ;)
    • net_allowCheats must be 0
    • net_useUPnP - set to 0 to avoid server startup problems.
    • antilag - as far as i rember, those are allready blocked
si_antiLag "1"                  //, default = "1"
si_antiLagForgiving "0"     // how forgiving the antilag is - the higher, the more forgiving, default = "0"
si_antiLagOnly "0"           // antilag only, default = "0"
  • si_rules this is the most important one, set it to sdGameRulesCompetition
  • mapcycle, is related to si_rules, see mapcycle.cfg
  • We advice you to use spawnserver <mapname> instead of spawnserver maps/<mapname> to make sure scripts are loaded properly.
  • Notice that .pk4 files are zip files, so you can rename them to .zip and open with any program. Inside of one zip there is example config named etqwpro.cfg with settings specific to the ETQWPro, that represent the most common used setup.

Just add to the server.cfg before Initiate mapcycle below line:

exec etqwpro.cfg

And below set up specific cvars you think your server would benefit. notice that some servers if needed to work as match servers should not have some changes (in example ET spread in current revision is forbidden).

  • Remeber to add guidstates.dat and usergroups.dat to control admins, bans and configs to execute.
  • Alter server start parameters to start server as etqwpro, add +set fs_game etqwpro on the very beginning, example:
./etqwded.x86 +set fs_game etqwpro +set net_serverDedicated 1 +exec server.cfg
  • Now start server and see if it works. It it dies, see server logs. Run server with -debug parameter and see qconsole.log for extra info

Upgrading

  • Read precisely readme until you understand what changes it provides.
  • Stop server now.
  • Rename etqwpro/ direcotry to etqwpro-040/ - so you got a backup
  • Install mod as in Fresh Installation.
  • Copy *.cfg, *.dat from etqwpro-040 to the etqwpro/ directory, apply changes to cvars that newest version requires. Most cvars from 0.4 to 0.5 were renamed - notice changes like Cyclops, vehicle names like Armadillo and not Badger etc. Notice cvar prefixes - 90% of then are startin with es_ prefix. We encourage you to use our example configs (below), and then adjust them.
    • Notice that:
      • .dat files do not change.
      • punkbuster checks for new extra cvar range - net_clientMaxRate should be between 16000 and 30000 clientside.
  • Make sure you update files on fast download - if you of course use that feature.
  • Start server and test if it works.

What next

Known issues

If your server fails to start then try to

  • add at the end of server.cfg the contents of the mapcycle.cfg - sometimes the server actually starts but does not load the map (its usually happening on game server providers where you cannot set up startup parameters)
  • make etqwdedbings.cfg and etqwdedconfig.cfg empty files and then set up read only flag for that files.
  • some game server providers are setting up servers in such a way that you need to set up si_pure 0 in server.cfg
  • (optional) set up autoexec.cfg to load server.cfg, but better avoid then to place in server.cfg any mapcycle change script or server gets constant crashes or infinite map loading loops.

Examples

  • server.cfg - for 14 slot server
  • full mapcycle.cfg - that uses all etqw maps
  • qwcup.cfg - introduces differences between official etqwpro.cfg and the community ruleset requirements for 6on6, we use it in tournament in Poland :)
  • usergroups.dat - example levels with some configs to execute, used for admins only.


Clanbase

  • Official server configs for cb6on6.cfg, cb4on4.cfg and cbnations.cfg are available here. The one below are obsolete.
  • cb4on4.cfg and cb6on6.cfg - Official CB 4on4 and 6on6 rulesets. They need to start with letters otherwise you cannot execute them from limbo menu.
  • eu4on4pub.cfg and eu6on6pub.cfg - example configs for infantry only (4on4 no mines) and 6on6 (vehicles) for public servers, European ruleset. They need to start with letters otherwise you cannot execute them from limbo menu.
Personal tools