Local Generals.io

Intro

Welcome to the Local Generals.io (LocalGen) project!

With LocalGen, you can now play generals.io entirely offline!

Enjoy the game with ready-to-use bots or challenge your friends over the same LAN network!

Interested? Get started by downloading LocalGen from the releases page.

Got a new idea or discovered a bug? We welcome contributions! Simply open an issue or submit a pull request, and we’ll get back to you as soon as possible.

To contribute your own bot, check out the instructions in the contribution guide and the bot README.

Releases (Changelog)

Building the project

You'll need Qt 6.7+, CMake 3.19+, and Ninja 1.10+ installed under PATH. Run the following commands, using the actual Qt6 toolchain path on your system (typically $QT_ROOT_DIR/lib/cmake/Qt6/qt.toolchain.cmake):

cmake -B build -S . -G "Ninja Multi-Config" -DCMAKE_TOOLCHAIN_FILE=/path/to/qt.toolchain.cmake
cmake --build build --config Release

Then find the executable under build/Release.

Note

On Windows, create a portable package with windeployqt after the build.

On macOS, the build already deploys build/Release/LocalGen-new.app. To sanitize, ad-hoc sign, and package it into a Finder-launchable DMG, run bash scripts/package-macos-dmg.sh build/Release/LocalGen-new.app.

Avoid macdeployqt ... -dmg here: recent Qt/macOS combinations can leave disallowed bundle metadata on copied frameworks, which breaks the app signature inside the generated DMG.

Star History

Disclaimer

The "Local Generals.io" project (hereinafter referred to as "LocalGen") is an independent, open-source project developed by the SZXC-WG community. LocalGen is in no way affiliated with, associated with, endorsed by, sponsored by, or connected to generals.io or its original developers.

generals.io, along with its name, logo, and all associated assets, are the exclusive trademarks and properties of their respective owners. All rights to the original online game are reserved by them.

LocalGen is a strictly unofficial, fan-made tool designed for local, offline environments. Its primary purpose is to provide an isolated space for local gameplay, educational purposes, and AI/bot development. LocalGen does not connect to, interact with, or attempt to replicate the proprietary backend services of the official generals.io platform.

Please note:

• Any bugs, issues, or feature requests regarding LocalGen should be directed solely to the issue tracker of this repository and should not be reported to the generals.io support team.
• The use of LocalGen does not imply any endorsement by generals.io, nor does it grant any special rights or privileges on the official generals.io servers.
• Users must comply with the Terms of Service of generals.io when using the official platform. The developers of LocalGen bear no responsibility for how individual users choose to utilize this tool in relation to the original game.

By using LocalGen, you acknowledge and agree to this disclaimer.