The Kabal Invasion

The Kabal Invasion is a web-based 4X space game. It is coded in PHP/HTML/JS/SQL.

What is it?

A web based space exploration (4x) game based on the old BBS door games that went
by many names (Tradewars, Galactic Warzone, Ultimate Universe, and
many other games like this) but shares no code with them.  It is
written 100% in PHP/HTML/JS/SQL.

Why should I run this?

Web-based games that recreate the door game BBS experience can be fun!
Since it is Free and open source software, anyone can examine, learn, and contribute.

License: Affero GPL v 3

Requirements:

Server (generally, the most recent/current version of each is our recommendation, but these should suffice):

• A webserver capable of supporting htaccess, and TLS.
• apache v2.4+ (we have not determined a required minimum).
• php v7.1.0+ (needed for void return types).
• mariadb v5.5+ or v10.0+ (needed for utf8mb4 schemas).
• mbstring PHP extension.
• pdo PHP extension.

Web:

• Chrome v50+ or Firefox v40+ (recommended).
• Safari v9.1.2+.
• IE v11.

Notes:

• TKI will likely run on lighttpd and nginix, but has not been tested on either.
• IIS is NOT supported, please do not ask! (But we welcome code to make it work on IIS)
• Development "Snapshots" are intended only for developers that are actively involved in the development process, and require additional effort to work (composer, etc).
• We make use of Smarty templates, HTML Purifier, Swiftmailer, and Adodb (although we are working to replace adodb with PDO).

Credits:

The Kabal Invasion forked from Blacknova Traders, please visit their sourceforge page for more information about their project.

Installation:

Please see the /docs/install.md file.

Upgrades:

As is typical with releases, we highly recommend a fresh install. Upgrades are not supported at this time.

Code quality:

The project began in the early PHP4 era, and as a result, is less than ideal. Substantial progress has been made towards modernization, and we are continuing that process. As a general guideline, we follow PSR-1,2,4, and the upcoming 12, with the major exceptions that we use BSD/Allman brace/brackets and do not yet follow line length limits. Feedback and PR's are welcome and appreciated.

Contributing:

Feel free to contribute to the project! We use GitHub for our issues tracking (provide feedback!), milestone planning, code storage, and releases.

I hope you enjoy the game!
The Kabal