https://github.com/opcode81/grobersumo-quakelive-server-cfg
Server configuration and launch scripts for the Grobersumo Quake Live servers
https://github.com/opcode81/grobersumo-quakelive-server-cfg
Last synced: about 1 year ago
JSON representation
Server configuration and launch scripts for the Grobersumo Quake Live servers
- Host: GitHub
- URL: https://github.com/opcode81/grobersumo-quakelive-server-cfg
- Owner: opcode81
- Created: 2021-02-22T20:22:31.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-05T19:56:14.000Z (over 3 years ago)
- Last Synced: 2025-01-26T01:44:55.344Z (over 1 year ago)
- Language: Python
- Size: 34.2 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Grobersumo Quake Live Server Configuration
This project contains server configuration files for the Grobersume Quake Live servers:
* `iffa`: instagib free for all
* `wffa`: free for all with CA weapons at spawn
## Quake Live Dedicated Server Installation under Ubuntu Linux
**Requirements**
* [Install **steamcmd**](https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD) for the user `steam`, such that `steamcmd` is available under `/usr/games/steamcmd` (or edit `install_qlds.sh` to reflect the correct path).
* The contents of this repository are under `/home/steam/.quakelive`
* Requirements which can be installed via apt-get:
`sudo apt-get -y install python3 python3-dev redis-server git build-essential`
**Server Installation**
Given these requirements, the actual dedicated server (along with minqlx extensions) can be installed by executing the following command as a sudo-capable user:
sh install_qlds.sh
**Stats Secret**
For player stats to be transferred, create the file `/home/steam/.quakelive/zmq_stats_password.txt` and write the password to it (without a trailing newline).
## Linux Services
We use [systemctl](https://www.freedesktop.org/software/systemd/man/systemctl.html) to control server (re)start and shutdown.
The systemd units use the shell scripts `launch_.sh` to start the servers.
We create a systemd unit for each server:
* `/etc/systemd/system/ql-instagib.service` for the `iffa` server
* `/etc/systemd/system/ql-allweapons.service` for the `wffa` server
These are the contents of the former,
[Unit]
Description=Quake Live Instagib
After=syslog.target
[Service]
ExecStart="/home/steam/.quakelive/launch.sh" iffa
User=steam
Group=steam
Restart=on-failure
RestartSec=5s
KillMode=mixed
[Install]
WantedBy=multi-user.target
where we have passed the subdirectory where the server configuration is located, `iffa`, as an argument.
After a unit file has been created, we can enable and start the service as follows:
sudo systemctl enable ql-instagib
sudo systemctl start ql-instagib
**Convenience Scripts**
* `restart_iffa.sh`, `restart_wffa.sh` to restart the servers
* `stop_all.sh` to stop all servers
**Service Logs**
Use `journalctl` to view service logs, e.g. for service `ql-instagib` as follows in order to view the latest log messages first (`-r`):
sudo journalctl -u ql-instagib -r
**Periodic Restart**
We restart servers daily to fix the problem where bots are not cleared from the player slits. Specifically, we configure a cron job for the root user that runs the restart script every day at 5 o'clock:
# m h dom mon dow command
0 5 * * * /home/steam/.quakelive/restart_iffa.sh
## Quake Live Server Configuration
Our configuration system factors out configuration that is common to all servers in the file `server.base.cfg`.
Settings specific to a server are to be set in `/baseq3/server.additional.cfg` and may override settings already defined in the base configuration.
The actual server configuration file `/baseq3/server.cfg` is automatically created by running:
python make_server_cfg.py
This command usually does not need to be executed explicitly, as it is done automatically whenever the services are (re)started. Do not edit the auto-generated file.
## Workshop Items
Workshop items can be added by their ids (GET parameter `id`in Steam URL) by adding one line per id to `workshop.base.txt`.
Any identifiers added there will automatically be written to each `server.cfg` as well as the respective `workshop.txt` file when running `make_server_cfg.py` (automatically done at server startup).
To try out new maps, simply add the desired workshop items and temporarily disable `qlx_enforceMappool` in `server.base.cfg` to be able to start maps not within the map pool.
## Map Pool
The common map pool for all servers is defined in `mappool.base.cfg`. It defines all the maps on rotation and furthermore restricts the maps one can call a vote for (or start manually via the console). To disable pool enforcement, set `qlx_enforceMappool`to 0.
The script `make_mappool_cfg.py` generates the `mappool.txt` file for a server (called automatically on server startup).