The software behind the Interactive Fiction Competition (as of 2014).
This is the software that runs the Interactive Fiction Competition, a.k.a. the IFComp, an annual celebration of independently authored, text-based video games that began in 1995.
The organization of the IFComp changed hands after its 2013 iteration, and the new organizer elected to come at the role with, among other things, a wholly refreshed, public-facing web application. The software found in this repository resulted. We created its first draft over the course of the 2014 IFComp, and it has served the competition annually since then.
This is a LAMP application whose server-side business logic is implemented in Perl, using a modern, Moose-based dialect, by way of the Catalyst web application framework.
Note that the software additionally performs some goofy business involving system calls to a couple of custom PHP scripts (found in the scripts/ directory) based on HTTP endpoints defined in IFComp::Controller::Profile. These are necessary to support a custom API for secure, federated logins used by a handful of other sites in the IF community. This controller and these scripts are otherwise not used by the IFComp itself; forks of this repository may feel free to disregard them.
-
masteris what's running at http://www.ifcomp.org right now. -
devis the shared development branch, corresponding to a (restricted-access) project staging server.
To install this project's CPAN dependencies, run the following command from the IFComp/ directory of your cloned repository (the directory that contains the file called "cpanfile"):
curl -fsSL https://cpanmin.us | perl - --installdeps .
(If you already have cpanm installed, you can just run cpanm --installdeps . instead.)
This should crunch though the installation of a bunch of Perl modules. It'll take a few minutes.
Copy conf/ifcomp_local.conf-dist to conf/ifcomp_local.conf and then update the database pointers therein as appropriate.
Run script/ifcomp_deploy_db.pl to construct the database tables (having first created the database, user, and password, and set up the application configuration appropriately). Note this script won't fill in the role table, the comp table, or the federated_site table. The last of these isn't required for most operation, but the first two do need to be manually filled in once the tables are created.
It's a Catalyst application, and works as any other. See the Catalyst documentation for more details.
The project maintainer is Jason McIntosh ([email protected]).
Contributors to this codebase include Joe Johnston ([email protected]) and Jason McIntosh ([email protected]).
For a list of contributors to the larger IFComp project, see the IFComp credits page.