The Singularity Trap is written in PHP and Javascript using a MySQL database. It is a server/browser game.

It requires a server (such as Apache) with PHP and MySQL database and can be used as localhost or on a LAN or on the web.
- Localhost pass-and-play is tedious with more than 2 players.
- Web based PBEM requires extreme patience from non-combat players during combat rounds.
   - It is best played with multiple devices and all players present/online while playing.
 
- Tested with a standard Xampp installation as localhost and LAN server.

- Tested on a 2 gig thumb drive with UwAmp as localhost and LAN server.
   - Looks like a 1 gig would also work without issues.

- Chat and Automode not recommended for free web hosts. Daily hit limits may block access or trigger ads on those.
   - Free hosts that limit bandwidth instead of hits do not seem to be a problem.

- Chat uses the file system not the database and works on economy web hosts that prohibit database use for chat.

For players: Tested in Firefox and Explorer browsers. 
The display is sized for 1280x720 pixels or better and can use browser zoom and scroll functions.

Generic Web Server installation of The Singularity Trap game: Unzip and copy the "the-singularity-trap" folder (which contains a docs folder and a games folder) to your server. (or upload the zip file if that is supported by the host) Create a database and modify the dbinfo.php file settings to match as needed. Use any text editor if you need to modify dbinfo.php $servername = "localhost"; - your web host will give you the server - possibly something like "db61448377.db.RandR.com" $username = "username"; - your web host will give you your database id or username - maybe something like "dbo61448377" $password = "password"; - your web host will give you your database password - these vary all over the place $dbname = "mydatabasename"; - your web host will give you the name of your database - maybe something like "db61448377" Upload the modified file to the-singularity-trap folder and browse to the index.html page in that folder on the internet. Use the Sysop link there to come to this page and click the makegametables.php link. This also renames that file to prevent further use. Return to index page, click Mod link, and create your Mod password. Installation is now complete. Create a war.
Passwords for Mod and Players: Passwords were added as a retrofit for players (for web use to prevent spying/cheating) and for the Mod functions as those were linked from the index page. They are a set once when join a game or first access mod page and no functions are built in to reset them. Using PHPmyAdmin in the database the SQL query to clear Mod password is UPDATE `logins` SET `pswd` = '' WHERE `gamename` = 'admin' AND `player` = 'mod' And to change password for green player to "hoody" in the war named "hats-vs-cowls": UPDATE `logins` SET `pswd` = 'hoody' WHERE `gamename` = 'hats-vs-cowls' AND `player` = 'green' UwAmp includes PHPmyAdmin and most web hosts also supply it.
Installation - to run UwAmp (Apache/MySQL/PHP) and The Singularity Trap game off a thumb drive with Windows. Unzip the files onto a thumb drive. Open the UwAmp.exe file (in the main UwAmp folder on the thumb drive). Windows 7 and Windows 10 like to pop up 2 permission boxes for you to click at this point. Be sure Apache and MySQL both show as running. WINDOWS 10 USERS - Use Task Manager to stop the W3SVC service. (If needed select more details to see the tab for services - this must be done every time the computer reboots for Apache to run on Windows 10) Click the "www Site" button. Visit the Mod page to set a Mod password. Installation is now complete. Create a war.
The UwAmp program console can set Apache as localhost only (offline) or as online for LAN server use. In online mode it can be accessed by the LAN (router) assigned IP of the computer it is running on, and if internet connected also by internet IP of the computer it is running on if distinctive.
ROUTER NOTE for LAN On my old Belkin router I looked at connected devices to see the local IP assigned to my computer by the router (my router claims 192.168.2.1 for itself, my laptop is 192.168.2.2, other devices 192.168.2.3 and so forth) --- so to any computer on my router 192.168.2.2 is always the same as localhost on mine ------ if I put the thumb drive in my wife's computer it is 192.168.2.3
Possible issues running a LAN or localhost server: Port 80 - Skype and some others may use Port 80 - if so, stop that service or program. The location of the Apache program file, with the thumb drive as drive G: is G:\UwAmp\bin\apache\bin\httpd.exe Some firewalls may need to be told to allow Apache to run - especially as a LAN server. The next info is for Windows 10 firewall but others are similar if they need to be told to allow it. ---------------------------------------------- To be able to access via LAN (actually by any other computers using same router): control panel, windows firewall, allow an ap or feature through windows firewall, change settings, allow another ap, then browse to your apache\bin folder and select the httpd.exe as program to allow. ---------------------------------------------- If specific firewall permissions are needed they do NOT need to be redone every time the computer reboots.
Read Usage License                                                                back to index page