ALttP VT Randomizer
First and foremost, big thanks to Dessyreqt, Christos, Smallhacker, and Karkat for their work.
Without their work none of this would even be remotely possible.
Install
You will need Composer for the Laravel Dependency. Once you have that, run the following
$ composer install
Next create a new mysql database for the randomizer (see mysql documentation for how to do this, you'll need to install mysql server if it's not installed already)
Run the following command to create a new config for the app
$ cp .env.example .env
Then modify .env with appropriate username, password, and database name. Change the db connection to mysql Example:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=randomizer
DB_USERNAME=foo
DB_PASSWORD=bar
Then run the following commands to setup the app configuration
$ php artisan key:generate
$ php artisan config:cache
p.s. If you update the .env file then you'll need to run the config:cache command to pick up the new changes.
Now run the db migration command:
$ php artisan migrate
Running
Command line
To generate a seed one simply runs the command:
$ php artisan alttp:randomize {input_file.sfc} {output_directory}
For help (and all the options):
$ php artisan alttp:randomize -h
Web interface
You will need to build assets the first time (you will need Yarn to install the javascript dependencies).
$ yarn
$ ./node_modules/gulp/bin/gulp.js --production
Once you have the dependencies installed. Run the following command then navigate to http://localhost:8000/.
$ php artisan serve
Running tests
You can run the current test suite with the following command (you may need to install PHPUnit)
$ phpunit
API Documentation
The API documentation can be generated after you install by running:
$ composer documentation