This is the legacy client. The offically supported version can be found here. The development is more or less discontinued.
This is the source code for the FA Forever Lobby.
Pre-requisites are:
-
Python 3.12+
-
PyQt5 >=6.7
-
Requirements as in the requirements (Linux) or win_requirements (Windows) file.
pip install -r requirements.txt
By contributing, you agree to license your work to the FAForever project in such a way that it can forever be distributed under the conditions of the GPL v3.0 license.
Downlord's FAF Client Contribution Guidelines
- Quality has highest priority
- Write readable code
- Use comments only when absolutely necessary to explain complex algorithms or inherently unintuitive reasons for how or why your code functions
- Use the logger
- Open an issue for every improvement or problem you want to work on
- Open a PR that references the issue, name of the feature branch for the PR should start with issue number
- Use reasonably structured commits in your PR, for example like this:
- Cosmetic changes necessary to prepare your work
- Infrastructure / low level changes necessary for your high-level feature/fix
- Implementation of your feature/fix
- Additional work, such as localizations
- Use "Closes #xxx" in commit messages
- Changelog messages of the form
* Fix the foo #issue (@myname #pr)are appreciated when done in a final rebase after PR is marked "ready", but otherwise tend to cause annoying merge conflicts - PRs without test coverage for all logic will not be accepted
Small fixes by contributors who "own" (have recently made commits on) the part of the project they are making changes on may be fast-tracked, but when in doubt open at least a PR with a descriptive title and description.
https://github.com/FAForever/client/wiki/Windows-Dev-Py36
This guide is about runnning the client from source repository. For a ready-made Arch-Linux package follow the instructions in the wiki.
Clone this repository locally:
git clone https://github.com/FAForever/client.git faf-client
Create a python3(!) virtualenv for installing its dependencies:
virtualenv ./faf-client-venv --system-site-packages
./faf-client-venv/bin/pip install -r ./faf-client/requirements.txt
Note that many distributions have separate names for Python 2 and Python 3 virtualenv, such as "virtualenv" and "virtualenv3" - ensure you're using the Python 3 specific version on your distribution!
Now download the faf-uid executable:
mkdir ./faf-client/natives
wget https://github.com/FAForever/uid/releases/download/v4.0.6/faf-uid -O ./faf-client/natives/faf-uid
chmod +x ./faf-client/natives/faf-uid
Note that the faf-uid smurf protection executable needs to run xrandr, lspci, lsblk and uname to gather unique system information. Additionally the lsblk command must support the "--json" flag, which was added in util-linux-2.27.
You will also need java-ice-adapter in faf-client/natives/ice-adapter and JRE (java runtime environment) in faf-client/natives/ice-adapter/jre
Run the client:
cd ./faf-client && PATH=$PATH:./natives && ./faf-client-venv/bin/python -m src
For more information see the wiki.
Run the lobby from the main directory using:
python3 -m src
Run the unit test suite using:
python3 runtests.py
GPLv3. See the license file.