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.
Is this game ready to install and play?
At the moment, we've identified a number of release-blocking issues including broken password management, user sign-up, and issues with non-functional database calls. Serious effort is underway to fix all of these issues, and we are working towards a release. In the meantime, curious developers are encouraged to download, install, and play as the admin user to find issues and report them. When we get to a point where the game is stable for players, we will make an announcement, change this note, and release!
The Kabal Invasion forked from Blacknova Traders, please visit their sourceforge page for more information about their project. We proudly stand on the shoulders of giants, with BNT originally having hundreds of developers, players, and admins. We honor and appreciate their 15+ year contribution that makes our project possible.
Server (generally, the most recent/current version of each is our recommendation, but these should suffice):
- A Linux server. Our primary development platform is Fedora, but most Linux distributions should work, and potentially even OpenBSD.
- A webserver capable of supporting htaccess, and TLS such as
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).
- Chrome v50+ or Firefox v40+ (recommended).
- TKI will likely run on
nginix, however htaccess will not work out of the box - potentially causing security risks. It 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).
Please see the
As is typical with our releases, we highly recommend a fresh install. Upgrades are not supported at this time.
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.
The two areas we need the most focus in would be the documentation, and testing. Both can be done with little or no knowledge of PHP, and would help us dramatically.
Security issue reporting:
Please report all security issues to email@example.com.
Feel free to contribute to the project! We use Gitlab for our issues tracking (provide feedback!), milestone planning, code storage, and releases.
I hope you enjoy the game!