# MTG Random Interface

This small project provides a web based tool for running a bespoke randomized MTG card game.

## This project requires

* PHP ImageMagick

## Don't forget to:

* Create a MySQL/MariaDB database for the app with privileges granted to a user
  * `create database mtgrandom`
  * `create user 'mtgrandom'@'localhost' identified by 'password'`
  * `grant all privileges on mtgrandom.* to 'mtgrandom'@'localhost'`
* Import the `install/initial_db_mysql.sql` database structure
  * `mysql --host=localhost --user=mtgrandom -p mtgrandom < install/initial_db_mysql.sql`
* Change the ownership of the `images/` folder to the web server user
  * `chown :www-data images`
  * `chmod g+ws images`
* Copy the `config-dist.php` file to `config.php` and edit that file appropriately

## Usage Instructions

Here is a collection of notes about how the interface operates:

* When the page loads (or reloads) the game is reset
  * Card count is set to zero, but not displayed
  * The server-side list of played cards is emptied
  * Any displayed cards are removed
* Long pressing (press and hold) an image will toggle a card enabled or disabled
  * Disabled images are not in the pool of available cards when selecting a random card
  * If it is semi-transparent it is disabled
  * if it is not semi-transparent it is enabled
  * Card state can be edited in the management interface
* Clicking the **Show First Card** button will show the first card
  * Note that the very first card does NOT increment the card count
* Clicking the **Show Second Card** button will:
  * If a single card is displayed it will show a second card
  * If a second card is displayed it will replace the existing second card
  * Note that the **Show Second Card** button does not appear until at least one card is displayed
* Clicking the **Sun** (yellow) icon starts a game
  * A dice is rolled (turn up the volume to hear a dice roll!)
  * The dice results are set to the server as the starting card count
  * The dice roll is displayed over the diamond icon
* Clicking the **Fire** (red) icon will replace the most recently played card
  * The replacement card is **NOT** flagged as played for the current session
  * The replaced card is **STILL** flagged as played
* Clicking the **Skull** (gray) icon will reverse the most recent card play
  * The removed card will be set as "unplayed" in the current session and may show up again
  * It is impossible to go back further than the first card played
  * The card count will go backwards to match the reversed play
* Clicking the **Water** (blue) icon will hide the dice roll number displayed on the **Sun** icon
  * This is currently pointless as the dice roll is always hidden, but the functionality is retained
* Clicking the **Diamond** (bottom right) icon will reset the game session
  * Click once to stage the reset and the number will turn red
  * Click a second time to finish resetting the session
  * If it is not clicked a second time before another action is made it will go back to normal
* Clicking the **Tree** (green) icon will open the management interface in a new tab
  * This requires login credentials