DYNAMIC LINK LIBRARY : racetoseven Project Overview
========================================================================
This plugin was made for the mofo league to assist in having matches. To
use the plugin, you must compile it. Skip this step if you already have
the .dll or .so file.
With the .dll or .so, put it in the same directory as BZFS. In the command
line for BZFS, type -loadplugin racetoseven .
To verify the plugin is active, type "/match" in BZFS. It should give you
information about the /match commands.
The Commands:
/match - Gives you command info
/match start - Starts a match
/match end - A command for an admin to manually end a match
/match score - Prints the current score
/match config - Lets you screw with the configuration
When a match is started, no new players are allowed to join as a player on
the server. All "joinees" will be kicked, with the reason "There is a
match in progress. Please join the observer team". When a team captures
another team's flag, the current score is displayed. You may also type
/match_score to see the score. When a team gets to 7 captures, the plugin
automatically ends the match. Ending the match consists of:
*Resetting all flags
*Killing all players
*Resetting the team scores
*Resetting all player scores
The configuration file works like this:
When loading the plugin, in the first and only argument, enter the name and
path of the config file. Example:
-loadplugin racetoseven,/path/to/config.txt
If no config file is set, the plugin will use it's default values, which may
be accessed and set via /match config set. Here is a sample config file:
-allowMatches <true|false>
-allowPlayersDuringMatch <true|false>
-capNum <interger>
-reportURL <string>
-------------------------
-allowMatches true
-allowPlayersDuringMatch false
-capNum 7
#Note there are NO quotation marks around http://www.garrettsites.net. Let's keep it that way, OK?
-repotURL http://www.garrettsites.net/
-------------------------CHANGELOG-------------------------
1.12.1 (Release):
BUGFIX: Replaced all TextUtils functions with API functions, to comply with API 12.
BUGFIX: All crashes shall cease... check data pointers for NULL value before using them.
1.11.1 (Release):
FEATURE: Added -allowMatches config option, so in essence, admins can "dissalow" matches.
0.11.1:
FEATURE: When you /match config set _variable, it will show you what you set it to.
FEATURE: Added configuration file support
FEATURE: New versioning system (Major.APIversion.minor)
Beta 4:
REMOVAL: Took out /match ? and /match help, and combined that documentation with the documentation when you type /match.
BUGFIX: Upgraded to API 11.
BUGFIX: Commented out bz_resetPlayerScore as an attempt to stop the crashes we get.
BUGFIX: Changed the spelling of some of the classes to reflect changes in bzfsAPI.h.
BUGFIX: Admins could end matches when they weren't running, causing a blank report to be sent. This has been fixed.
FEATURE: If there is nobody on the server, the plugin will automatically end the match.
BUGFIX: Fixed the code that logged what team the person who typed "/match start" was on.
FEATURE: When a match is started, the plugin says "First team to # captures wins!".
Beta 3:
FEATURE: Punishes and kicks people who cap their own flag during a match.
FEATURE: Congratulates the capper if he caps the other team's flag.
FEATURE: Added the MATCHCONFIG perm, for users to be able to modify the configuration.
FEATURE: Added the /match config <list|add|reset> <name> <value> command, to manage the configuration.
FEATURE: In the command list that is displayed when the user mistypes a command, it lists the commands the user can and can't run.
REMOVAL: Took out the /set variable, _allowPlayersDuringMatch, due to it's buggy nature
FEATURE: Added MATCHEND perm, for people allowed to forcefully end matches.
Beta 2:
FEATURE: Added new permission, MATCHSTART, that must be put in your groups file if you want a player to be able to start a match.
BUGFIX: If a match is not in progress, nobody can end it (since there is none), not even an admin.
FEATURE: Added new /set variable, _allowPlayersDuringMatch to control the flow of players during a match. (although has some bugs)
FEATURE: Added 4 team support.
FEATURE: Admins can join matches as players, even if players are being locked out.
FEATURE: "/match" now shows the documentation.
BUGFIX: You can't start a match if one is already in progress.