Games::Multiplayer::Manager - Perl extension for easy management of multiplayer games in interactive environments.
use Games::Multiplayer::Manager; # Create a new game manager. my $game = new Games::Multiplayer::Manager (); # Set up broadcast handler. $game->setHandler (broadcast => sub { my $self = shift; print "Got message for $self->{to}: $self->{message}\n\n"; }); # Create a new game. $game->create ( id => "tag", name => "The Game of Tag", ); # Add a player. $game->addPlayer ("tag", host => "Perl", name => "foo", ); # Drop that player. $game->dropPlayer ("tag", "foo"); # Destroy the game. $game->destroy ("tag");
Games::Multiplayer::Manager is a simple interface for creating and managing multiplayer games in interactive environments (for example, with IRC bots).
Create a new game manager. This method should be called only once (a single manager object can manage as many games as you need). You can also pass in default variables (try to avoid any that begin with an underscore).
my $manager = new Games::Multiplayer::Manager (debug => 1);
Returns the module's version.
my $version = $manager->version;
Create a new game instance. Passed in are details on the game, which must include a unique identifier and a name (you can pass in any extra data if you want to, but not much else is used by the module itself).
This creates a new, empty game. To add players to it later, call the addPlayer method with the same ID that you created the game with.
This method will return 0 if there was an error (most likely the ID was already in use by another game).
$manager->create ( id => "tag", name => "The Game of Tag", );
Destroy a game instance. Pass in arguments in hash form. The required element is the ID of the game to destroy. Optional arguments are "force" (boolean) to force any existing players out of the game. If that is true, another argument "alert" should be provided to define whether or not the players should be told about the game being terminated. You can also pass a "message" to be broadcasted to those players.
$manager->destroy ( id => "tag", force => 1, message => "Game terminated by an administrator.", alert => 1, );
Set a handler. Currently the only handler is for "broadcast" - your handler sub would receive a hash containing "to" and "message"
$manager->setHandler (broadcast => \&broadcast);
Send a message to a single person. This method is usually called from within the module.
$manager->sendMessage (to => "foo", message => "Hello!");
Send a message to all players in a given Game ID.
$manager->broadcast ("tag", "Soandso has been tagged!");
Check a game's existence. Pass in the Game ID. This method will return 1 if the game exists, or 0 if it does not.
my $exists = $manager->queryGame ("tag");
Returns an array of every Game ID that is currently in existence under this manager.
my @games = $manager->listGames;
Add a player to an already created game. The first parameter is the Game ID, followed by a hash that must contain (at least) a unique name for the player.
$manager->addPlayer ("tag", name => "foo", );
Remove a player from a game. The game ID must exist, and a name must be defined.
$manager->dropPlayer ("tag", "foo");
Searches every existing game for a certain player. This method returns an array of each Game ID that the player exists in.
my @ids = $manager->findPlayer ("foo");
Check a player's existence within a game. Returns true if they exist there.
my $exists = $manager->queryPlayer ("tag", "foo");
Returns an array of players that exist in the passed in Game ID.
my @players = $manager->listPlayers ("tag");
Nothing else to see at the moment.
Version 1.01 - Fixed a few bugs with arrays being returned by the module. It used to return "0" when the array would've been empty, causing $array[0] = 0. This has been fixed. empty arrays return empty now. - Revised the module page. The broadcast handler receives "to" and "message" as the hash keys, not "msg". - Fixed the test script; Makefile should install more smoothly now. Version 1.00 - Initial release.
Cerone Kirsle, <cerone@aichaos.com>
Games::Multiplayer::Manager - Multiplayer game management for interactive environments. Copyright (C) 2005 Cerone Kirsle This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
To install Games::Multiplayer::Manager, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Games::Multiplayer::Manager
CPAN shell
perl -MCPAN -e shell install Games::Multiplayer::Manager
For more information on module installation, please visit the detailed CPAN module installation guide.