The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Games::Perlwar - A Perl variant of the classic Corewar game

DESCRIPTION

For the rules of Perlwar, please refers to the Games::Perlwar::Rules manpage.

HOW TO START AND MANAGE A PW GAME (THE SHORT AND SKINNY)

Use the script pwcreate to create a new game.

    $ pwcreate [ <game_directory> ]

pwcreate will create game_directory and populate it with the everything the new game will need. If game_directory is not provided, pwcreate will create a sub-directory called 'game'.

Once the game is created, the script pwupload can be used to submit the agents to be introduced into the Array:

    $ pwupload <game_directory> <player> 

pwupload takes two arguments: the game directory and the name of the agent's owner. The script then reads the script from STDIN. E.g.:

    $ pwupload /home/perlwar/myWar yanick < borg.pl

Finally, pwround executes an iteration of the game:

    $ pwround <game_directory>

pwround isn't interactive and can easily be called from a cron job.

BUGS AND LIMITATIONS

pwupload currently only works for local games. It will be soonishly extended to allow submissions to network games.

CONTACTS

For bug reports, please use the CPAN request tracker on http://rt.cpan.org/NoAuth/Bugs.html?Dist=Games-Perlwar.

The Games::Perlwar git repository can be found at http://babyl.dyndns.org/git/perlwar.git.

AUTHOR

Yanick Champoux (yanick@perl.org)

LICENCE AND COPYRIGHT

Copyright (c) 2005, 2006 Yanick Champoux (yanick@cpan.org). All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perldoc perlartistic.

This program is distributed in the hope that it will be useful (or at least entertaining), but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.