Q1menG Client

A project to rebuild a customised client based on DDNet / TaterClient

📄 This document is available in 中文

📝 Project Overview

Q1menG Client is a customised client built upon DDNet and TaterClient.
The aim is to provide a more modern UI experience, a wider range of configurable visual effects, and more user-friendly day-to-day features, whilst maintaining compatibility with the core gameplay.

✨ Features

• Smooth UI transitions and HUD animations
• Enhanced input and interaction experience
• More client configuration options and customisation settings
• Core capabilities that remain compatible with the DDNet ecosystem

❤️ Contributors

We would like to thank all contributors who have submitted code, reported issues and suggested improvements for this project.

🚀 Build

Windows

Use the repository wrapper so cmake always runs inside a configured MSVC developer environment, even from a normal PowerShell or cmd.exe session:

qmclient_scripts\cmake-windows.cmd -S . -B cmake-build-release
qmclient_scripts\cmake-windows.cmd --build cmake-build-release --target game-client -j 10

macOS / Linux / already-initialised developer shell

cmake -S . -B cmake-build-release
cmake --build cmake-build-release --target game-client -j 10

✅ Test

Windows

qmclient_scripts\cmake-windows.cmd --build cmake-build-release --target run_cxx_tests
qmclient_scripts\cmake-windows.cmd --build cmake-build-release --target run_rust_tests
qmclient_scripts\cmake-windows.cmd --build cmake-build-release --target run_tests

macOS / Linux / already-initialised developer shell

cmake --build cmake-build-release --target run_cxx_tests
cmake --build cmake-build-release --target run_rust_tests
cmake --build cmake-build-release --target run_tests

🙏 Special Thanks

• All contributors to DDNet, Teeworlds, DDRace, TaterClient, Best Client, RClient and CactusClient
• Friends who have taken part in testing, provided feedback and offered inspiration
• Everyone who continues to contribute to the open-source community
• All donors – thank you

🏛 Credits

• Teeworlds — Magnus Auvinen
• DDRace — Shereef Marzouk
• DDNet — Dennis Felsing and contributors
• TaterClient — Community modifications
• Best Client — Community modifications

📜 License

This project is licensed under the zlib/libpng licence, in line with the upstream DDNet / TaterClient projects.
Modified versions must be clearly attributed and must not misrepresent the identity of the original authors.

📮 Notes

This project is a personalised customisation and does not represent the official stance of DDNet or TaterClient.