QC:DE 3.0 installation guide [EN/RU]

**QUAKE CHAMPIONS: DOOM EDITION v3.0 INSTALLATION GUIDE** **ENGLISH VERSION** (русская версия ниже) ============================ **STEP 1 - Getting the necessary files** ============================ ***1.1. Windows*** If you're on **WIndows**, just install the game via the all-in-one installer from moddb: https://www.moddb.com/mods/quake-champions-doom-edition/downloads/qcde-v30-windows-installer **PLEASE NOTE** that, at the time of writing this guide, AIO installer ***has an older version of Q-Zandronum engine***, which means you won't be able to connect to servers with the newer one. If you need to connect to a server with a newer version of the engine, grab and extract the newer engine from here: https://qzandronum.com You will find details on how to set it up in the step 2 of this guide. ----------------------------------------------------------------- ***1.2. Linux/MacOS*** If you're on **Linux**, like me, on Mac or just want to set this up manually for other reasons, then you'll have to grab several things: - QC:DE mod files: https://www.moddb.com/mods/quake-champions-doom-edition/downloads/qcde-v30 - Q-Zandronum engine (Doomseeker and FreeDOOM WADs included): https://qzandronum.com ----------------------------------------------------------------- ***2. - Additional WADs/mods*** If you require **additional files**: - Combalance patch: https://www.moddb.com/mods/quake-champions-doom-edition/addons/qcde-combalance - QC:DE version of AEON map pack: https://www.moddb.com/mods/quake-champions-doom-edition/downloads/aeon-qcde-deathmatch-mapset - QC:DE retired maps: https://www.moddb.com/mods/quake-champions-doom-edition/addons/qcde-retiredmaps (if you need any other mods, or a different version of QC:DE itself, it can be found on the QC:DE moddb page under "files" and "addons" tabs) ============================ **STEP 2 - How to connect to the server** ============================ ***1. Via Doomseeker (GUI, all platforms)*** Doesn't matter which method of getting the game you've followed, you should have Doomseeker, which comes with Q-Zandronum. Doomseeker would be the easiest way of finding and connecting to Doom servers, and most of the time it will even automatically download any missing mods upon connecting to a server. However, Doomseeker may not find where to download some mod you may require from, or you might already have a collection of WAD/PK3 files you'd like to point Doomseeker to, in which case you'll need to configure a proper path in settings. ***1.1. Configuring Doomseeker to find your WAD/PK3 files*** Go to **settings** and click on "**File paths**". This will display the list of paths where Doomseeker will be looking for any WAD files upon connecting to servers. Decide on where you'll be storing all your files and add that path to the list by clicking the "**Browse**" button. If you'll happen to have **subdirectories with WADs in them**, AND you want to include them in Doomseeker, be sure to set the "Recurse" checkmark for your new path, but be warned that it's not recommended by Doomseeker itself to have many subdirectories (there's a warning message in the file path settings, if you need details). Otherwise. you can add all the subpaths as separate paths without recursion. ***1.2. Changing Q-Zandronum engine version*** If you need to connect to a server with a **different version of Q-Zandronum** than the bundled one, you will have to **change the path to the correct client executable** in Doomseeker settings: go to settings, **Games -> Q-Zandronum** and change the path to client executable to the one you've downloaded and extracted (if you're on Windows, the executable file you're looking for is "***q-zandronum.exe***") ***WARNING!*** It's better to not replace the bundled engine version directly (by extracting the files over the bundled engine directory), as I'm not sure about backwards compatibility, you might need to switch back to the older one to connect to older servers, so better to leave it untouched and have multiple separate versions, which you can swap at will. ***1.3. Connect to the damn server*** Find the server in the list of servers in Doomseeker's main window and try to connect to it. There's a good chance that Doomseeker will actually download all the required mods for you, if they are known/popular enough and were actually published somewhere in the past. If you don't see the server you're looking for, then it is either offline, was not set up correctly by the host (ports aren't forwarded properly or public discovery of the server was disabled) OR you might have some filtering applied (it will say "Server filter is applied" above the server list). ***1.4. Connecting to the IP address directly*** Unfortunately, I couldn't find a way to connect directly to an IP address in Doomseeker. Instead, you will have to run the game directly without Doomseeker, open the console and type in "connect" followed by an IP address. In order to open the console in main menu, you have to press Escape key until the menu interface gets hidden and you only see the background, then press tilde (~). ----------------------------------------------------------------- ***2. CLI/Terminal/Shell-script*** Doomseeker isn't required to connect to servers, given that you know the IP address (or maybe you just want to play singleplayer). If you're interested in this method, I'm gonna account for you being capable of figuring stuff out yourself, so I'm just gonna leave an example Linux shell script: ```#!/bin/sh PATH_TO_MY_WADS="/some/path/to/my/wads" /path/to/q-zandronum/binary \ -iwad "$PATH_TO_MY_WADS"/freedm.wad \ -file "$PATH_TO_MY_WADS"/QCDEv3.0.pk3 \ -file "$PATH_TO_MY_WADS"/QCDE_Combalance_Official.pk3 \ -file "$PATH_TO_MY_WADS"/QCDEmaps3.0.pk3 \ -file "$PATH_TO_MY_WADS"/QCDE_RetiredMaps_v4.pk3 \ -file "$PATH_TO_MY_WADS"/aeonqcde3.0_beta4.pk3 \ -file "$PATH_TO_MY_WADS"/QCDE_PvPvisibility.pk3 \ -file "$PATH_TO_MY_WADS"/QCDEmus3.0.pk3 \ "$@"``` Upon launching QC:DE, if you pressed anything and main menu interface has appeared, you'll have to hit Escape to "close" the main menu UI, after which you'll be able to open the console by pressing tilde (~). Type "connect" followed by an IP address to connect to a server. Do note that you'll have to perfectly match all the WAD/PK3 files required by the server you're trying to connect to. Server can also have "non-required" files, you're free to not use them if you don't want to, but you won't be able to connect if you've loaded the game with files, which are NOT loaded by the server in any way. ++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++ **РУССКАЯ ВЕРСИЯ** ============================ **ЧАСТЬ 1 - Подготовка файлов** ============================ ***1.1. Windows*** Те, кто на винде, могут скачать и установить игру через готовый инсталлятор с moddb: https://www.moddb.com/mods/quake-champions-doom-edition/downloads/qcde-v30-windows-installer **ОБРАТИТЕ ВНИМАНИЕ**, что на момент написания данного гайда, инсталлятор версии 3.0 ***включает в себя старую версию движка Q-Zandronum***, с которым НЕ ПОЛУЧИТСЯ подключиться к серверам, использующим более новые версии. Если стоит задача подключиться к таким серверам, придётся скачать и распаковать новую версию движка отсюда: https://qzandronum.com Что делать с новой версией будет описано во второй части гайда. ----------------------------------------------------------------- ***1.2. Linux/MacOS*** Для тех, кто на линуксе, маке или по иным причинам хочет собрать всё руками, понадобится две вещи: - Сами файлы QC:DE мода: https://www.moddb.com/mods/quake-champions-doom-edition/downloads/qcde-v30 - Движок Q-Zandronum (Doomseeker and FreeDOOM WADs included): https://qzandronum.com ----------------------------------------------------------------- ***2. - Дополнительные WADы/моды*** Если требуются **дополнительные файлы**: - Combalance патч: https://www.moddb.com/mods/quake-champions-doom-edition/addons/qcde-combalance - QC:DE версия набора карт AEON: https://www.moddb.com/mods/quake-champions-doom-edition/downloads/aeon-qcde-deathmatch-mapset - QC:DE retired maps: https://www.moddb.com/mods/quake-champions-doom-edition/addons/qcde-retiredmaps (если нужны другие моды, или другая версия QC:DE, всё можно найти на странице QC:DE на moddb, во вкладках "files" и "addons") ============================ **ЧАСТЬ 2 - Подключение к серверу** ============================ ***1. Подключение через Doomseeker*** Вне зависимости от того, какой способ подготовки файлов был выбран, у Вас в комплекте будет Doomseeker. Через Doomseeker проще всего подключаться к серверам, к тому же он может автоматически докачать отсутствующие моды в большинстве случаев. В ситуации, когда не получается докачать моды автоматически, или в случае когда уже есть коллекция скачанных WAD/PK3 файлов, которой Вы хотите пользоваться, придётся настроить путь к ним в настройках Doomseeker. ***1.1. Как указать Doomseeker'у путь до WAD/PK3 файлов/модов*** Открываете **настройки** и выбираете "**File paths**". Откроется список путей, по которым Doomseeker будет искать файлы при подключении к серверам. Определитесь с тем, где будете хранить WADы и добавьте соответствующий путь через кнопку "**Browse**". Примечание: если по указанному пути файлы у Вас распиханы по папкам, то придется тыкнуть галочку "Recurse", чтобы Doomseeker искал файлы в том числе и в "подпапках". Doomseeker не рекомендует использовать Recurse режим с большим количеством вложенных папок (об этом в настройках есть ремарка). Так же можно добавить все вложенные папки как отдельные пути и не включать Recurse. ***1.2. Как поменять версию Q-Zandronum*** Если нужно подключиться к **серверу с версией Q-Zandronum, отличной от Вашей**, придётся **сменить путь до исполняемого файла** в настройках Doomseeker. После того, как Вы скачали и распаковали нужный Q-Zandronum, идёте в настройки, **Games -> Q-Zandronum** и меняете там "path to client executable". В случае с виндой Вас интересует "q-zandronum.exe" из распакованных Вами файлов. ***ВНИМАНИЕ!*** Не распаковывайте новую версию поверх старой. Скорее всего Вы не сможете подлючиться к серверам на старой версии, пользуясь новой, поэтому целесообразнее иметь обе и переключаться между ними по необходимости. ***1.3. Подлючение к серверу*** Находите нужный сервер с списке серверов и пробуете подключиться. Скорее всего все отсутствующие моды/файлы подтянуться автоматически, во всяком случае если они достаточно популярны и были ранее размещены в публичных источниках. Если Вы не можете найти нужный Вам сервер, значит он либо не в сети, либо был неправильно настроен (владелец сервера не открыл порты или выключил публичное обнаружение сервера), либо в Doomseeker'е выставлены какие-либо фильтры поиска (в этом случае над списком серверов будет красоваться надпись "Server filter is applied"). ***1.4. Прямое подключение по IP адресу*** К сожалению, я не нашёл способа подключиться по IP из Doomseeker'а. Но Вы можете запустить игру напрямую, минуя Doomseeker, открыть консоль и написать "connect" и адрес сервера через пробел. Консоль открывается на тильду (~). Если не получается открыть консоль, находясь в главном меню игры, - "закройте" меню нажав Escape (чтобы было видно только фон, без интерфейса) и попробуйте ещё раз. ----------------------------------------------------------------- ***2. Запуск через консоль/шелл-скрипт*** Не обазятельно пользоваться Doomseeker для подключения к серверам, если известен адрес сервера. Однако в подробности я вдаваться не буду, предполагая, что Вы плюс-минус знаете, что делаете, и зачем это Вам. Оставлю пример шелл-скрипта для запуска QC:DE: ```#!/bin/sh PATH_TO_MY_WADS="/some/path/to/my/wads" /path/to/q-zandronum/binary \ -iwad "$PATH_TO_MY_WADS"/freedm.wad \ -file "$PATH_TO_MY_WADS"/QCDEv3.0.pk3 \ -file "$PATH_TO_MY_WADS"/QCDE_Combalance_Official.pk3 \ -file "$PATH_TO_MY_WADS"/QCDEmaps3.0.pk3 \ -file "$PATH_TO_MY_WADS"/QCDE_RetiredMaps_v4.pk3 \ -file "$PATH_TO_MY_WADS"/aeonqcde3.0_beta4.pk3 \ -file "$PATH_TO_MY_WADS"/QCDE_PvPvisibility.pk3 \ -file "$PATH_TO_MY_WADS"/QCDEmus3.0.pk3 \ "$@"``` После запуска игры, если что-то нажали и появилось главное меню, то сначала жмёте Escape, чтобы "закрылся" интерфейс меню, после этого открываете консоль на тильду (~) и "connect" и адрес сервера через пробел. Обратите внимание, что к серверу получится подключиться, только если в точности совпадают все WAD/PK3 файлы, которые сервер использует. Сервер так же может использовать "необязательные" файлы, их можно не подгружать, на сервер пустит и без них, но если были загружены файлы, которые НЕ ЗАГРУЖЕНЫ СЕРВЕРОМ, то на сервер Вас не пустит.