EXCOSC Launcher
---------------
This is a combined launcher and patcher for the EXCOSC game jam:
http://forums.tigsource.com/index.php?topic=31996

It's designed to launch any games it finds in subfolders of the directory it's
sat in, and act as a patch bay for connecting them together.


How To Use It
-------------
The Games:
----------
To connect EXCOSC games together, you need to set a listen port, a send port,
and a send address for each game. The launcher assumes that these can be set
by passing each game a set of command line arguments, but this may not be the
case for all games.

The launcher has two tabs at the bottom: 'OSC Settings' and 'Command Line'. Only
one of these tabs is active at any one time. i.e. Clicking 'Launch Game' will
not apply any arguments you've set in 'Command Line' if 'OSC Settings' is
currently selected, and vice versa.

'OSC Settings' provides editors for the ports and address necessary to setup a
game to communicate with others, while 'Command Line' lets you set the game's
command line arguments directly.

The Patcher:
------------
To use the Patcher, follow these steps:
1.) For each game, set it to send messages to the Patcher:
    a.) The game's send address should be the IP address of the machine the
        Patcher is running on (this is displayed in the top right of the
		launcher's window.
	b.) The game's send port can be an arbitrary number, though certain ports
	    are reserved for standard actions (e.g. 80 is used for interacting with
		websites).
2.) The game's listen port can also be an arbitrary number.
3.) In the Patcher, add a Listen Port for each game. Match the port numbers to
    the send ports you set for each game in step 1b). The port number is the
	editable number beneath the editable 'Game Name' text.
4.) In the Patcher, add Send Ports for each game. The Patcher's Send Ports have
    three editable components: the game name, the address to send to, and the
	port to send to.
    a.) Set the send address to the IP address of the machine the game is
	    running on. If the game is running on the same machine as the launcher
		then the address should be set to 127.0.0.1. Otherwise you can use the
		launcher to determine the IP address of the machine the game is running
		on.
	b.) Set the send port to match the game's listen port, set in 2).
5.) You can now connect and disconnect games by dragging connections from the
    Patcher's listen ports to its send ports.


For Developers
--------------
To have your game play nicely with the launcher, you should do two things:
1.) The game should respond to command line arguments to set the listen port,
    send port and send address. The arguments (respectively) are:
	-lp <port number> -sp <port number> -sa <send address>
2.) You should provide screenshot.png and metadata.txt files in your game
    folder. screenshot.png is just a thumbnail of your game. metadata.txt is
	a three-line text file, with the following format:
<game name>
<game author(s)>
<short game description>


License Details
---------------
Source code for this launcher is licensed under the GPL v3.


- Niall Moody (13/8/13).
