vBulletin LTS

[PBPG] Tournaments and Ladders
Mod Version: 4.0-0.1 a3, by Carnage

What does it do?
This is a tournaments and ladders plugin for my Play by post gaming mod. The basic premise is to run tournaments within a forum thread. As of the current version, the only tournament format supported is Single Elimination with no support yet for ladders; however more formats will be included in future releases.

What can I use it for?
This mod is used for running tournaments of any kind. Gaming forums can use this for running tournaments for pretty much any game from snake to TF2. Forums with different themes for example writing or role playing can pitch members against each other in head to head write offs or in character spars.

Live demo
I've now installed this mod on my own forums; a live demo can be seen here:
http://www.giveupalready.com/showthread.php?77116-Test-Chess-Tournament

Features

• Javascript powered tournaments interface within a forum thread.
• Members have options to leave and join the tournament
• Gamesmaster (Person who posts the thread) has options to start the tournament and adjust and options the admin has left open.
• Once the tournament has started the gamesmaster can post results of games and have tournament standings update in real time.
• Tournament formats included:
  • Single Elimination
  • Swiss
• Admin options
  • Set max players
  • Set min players
  • Set/force* players
  • Set/force auto start full tournaments
  • Set/force tournament type
  • Set/force results posting type
  • Options for automatic tournaments (Threads for a plugin eg chess will be auto posted for players; results will be gathered from the plugin)
• Member options
  • Opponant verified score posting
• Support for auto posting game threads (for pbpg games)
• Support for auto harvesting results (for pbpg games)

Planned Features
Struck out items; are completed and will make the next release.

• Admin options
  • Option to decide what happens in the event of a draw in an automatic tournament
• Games master options
  • Kick players
  • Assign other games masters
• Member options
  • Challenge player (ladders only)
• Tournament formats
  • Basic ladder
  • Round robin
  • EOL ladder
  • Double elimination
  • Swiss-seed (swiss for x rounds, top n players go into seeded single elimination)
  • 'Football' style ladder
  • 'Prediction' ladder (requested feature)
• Support for player seeding (by games master, admin or previous performance)
  
• Player stats (eg wins/positions/average rank) globally over all tournaments
• Create tournament from tournament - take the results of a tournament and use them as the basis for another tournament (eg seedings or tournament for top x players only)
• Admin help
• player FAQ's
• Phrasing
• UI improvements (esp when the number of players is high)

Installation
1. Install Play by post gaming core product
2. Upload contents of upload folder.
3. Import product file.
4. Select the Manage plugin configurations option from the play by post gaming menu
5. Against Tournaments and ladders, select the create new configuration option.
6. Fill out the settings and save.
7. Create or edit an existing forum and assign the configuration you just created to it.
8. Posting threads in that forum will now show a drop-down list to select a confiuration to play; select the configuration you created in 6 and post a thread to start a tournament.

Upgrading
1. Ensure that Play by post gaming core product is upto date. (Beta 3 is latest version as of writing)
2. Upload files overwriting as needed
3. Import product using the allow override option set to yes.
4. Edit any existing configurations and set defaults for the new options.

Uninstallation
1. Edit the forums that have a configuration of this plugin assigned and remove it from the list.
2. Now uninstall the product.
3. Delete the tournaments directory in pbpg_plugins.

Changelog

• 4.0-0.1 a3
  • Added automatic tournament options
  • Added auto result harvesting from pbpg games
  • Added ability for members to post results for games; verified by the other player
  • Requires beta 4 of core.
• 4.0-0.1 a2
  • Fixed bug with javascript in IE.
  • Plugin will now not install if you do not have core product installed and upto date.
  • added max/min players admin option
  • added autostart admin/gamemaster option
  • added players admin option
  • added tournement format: swiss.
  • added tournament format setting for admincp
  • added force torunament type for admincp
  • very defensive install/uninstall code
  • minimum core version now 4.0-0.1 b3
• 4.0-0.1 a1
  • Initial release

Notes

• You need at LEAST version Beta 4 (4.0-0.1 b4) of pbpg core for this product to work; unfortunatly vb's dependancies system dosn't allow me to enforce this.
• Set/force means that the admin setting this up can set something as a default, there is also the option to force that default so that it can't be changed by members.
• In large tournaments (32 players+) the swiss tournament format may in some instances be unable to find suitable pairings in later rounds. If this happens, please report it as a bug so I can fix the issue.