Add-On Releases - [PBPG] Tournaments and Ladders

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/showthr...ess-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
[s]Struck[/s] 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.

[Covert-OPs_]

I went ahead and put it up on my test site, however when I go to upload the product I receive thie DB error:

Invalid SQL:
SELECT * FROM pbpg_plugin WHERE dir='tournaments';

MySQL Error : Table 'tactical_testforums.pbpg_plugin' doesn't exist
Error Number : 1146
Request Date : Wednesday, January 27th 2010 @ 10:59:39 PM
Error Date : Wednesday, January 27th 2010 @ 10:59:40 PM

[Carnage]

I went ahead and put it up on my test site, however when I go to upload the product I receive thie DB error:

Did you install this product: https://vborg.vbsupport.ru/showthread.php?t=232900 first? It provides the framework that this mod runs on top of. (including the database tables)

1. I think it would be great if there was a way to set a date cut-off for ladders. Once that date is hit then the ladder gives the admin/mod the ability to create a tournament based on the results of the ladder. The top teams would be placed high on the bracket with bye's into the second round/third round depending on the number of participants. It would also matchup teams based on their record from the ladder, so the lowest ranked teams would face the strongest teams(assuming that a bye system is not possible or doesn't make sense). This would create a league/playoff atmosphere around the mod and would be VERY helpful in my opinion.

I've currently only programmed (1) tournament type amongst the planned tournament types is the swiss-seed tournament, which works in a very similar way, however instead of a ladder you get a swiss style tournament. I could probably fairly easilly create a ladder -> single elimination type as well, or i might make this possible in other ways eg a 'create a tournament based off this tournament' button.

2. Challenge Details are needed for the ladder. Basically, a place to put in the details of the match in question. A few suggestions would be Map Name, Mode, Number of players needed, Date & Time, Notes.

not something i'd thought of but as i've not written a challenge system yet, this is deffinatly something I can include when I do. I also need to include a method to add a tournament description.

The ability to seed players/teams in the tournament bracket.

Already in the planned features

[Covert-OPs_]

Alright I was able to install it, I did not realize that the other mod was required.

So everything looks ok except for when I go to create a thread using the mod. The "configuration" that I made is there in a drop down but then nothing else works. The "set options", "join" and "start" don't do anything but enter those words in the quick reply box. Also the "configuration" in the admin panel only consists of the event name.

[Carnage]

The "set options", "join" and "start" don't do anything but enter those words in the quick reply box.

That is as designed; you can add a comment if desired and then post the reply - the concept behind these mods is 'Play by post' Start won't do anything unless there are two players in the tournament - theres not much point in having a tournament with yourself.

Also the "configuration" in the admin panel only consists of the event name.
Reply With Quote

the current version of this mod has no admin configurable options. The next release however will; in order to fix the bug in ie, I needed to update js files in all the pbpg releases and I wanted to add features to both of them before releasing the next update. I plan to get beta 1 of the core product out tomorrow, with releases for this mod and the chess mod following sometime over the weekend, all being well.

[Covert-OPs_]

Originally Posted by Carnage-

That is as designed; you can add a comment if desired and then post the reply - the concept behind these mods is 'Play by post' Start won't do anything unless there are two players in the tournament - theres not much point in having a tournament with yourself.



the current version of this mod has no admin configurable options. The next release however will; in order to fix the bug in ie, I needed to update js files in all the pbpg releases and I wanted to add features to both of them before releasing the next update. I plan to get beta 1 of the core product out tomorrow, with releases for this mod and the chess mod following sometime over the weekend, all being well.

Ok but where do you set the type of tournament you want to have?

[Carnage]

Ok but where do you set the type of tournament you want to have?

That will become both a user and admin option once there is more than one type avaliable. (One of the features I want to add to the next release is the swiss tournament type)

[Carnage]

Update version now avaliable. Huge number of changes, see changelog for details.

Make sure you update the pbpg core product before installing/upgrading as this requires the latest version.

[ozpinkpanther]

Not working in IE8 !! Firefox seems ok

[PharaohsVizier]

I just wanted to say that this looks like a really cool mod and I'll probably install it soon. Thanks for making it!

[ozpinkpanther]

Installed the update and it is working on IE8 now.
As the World Cup is coming soon, it would be nice to have a "Tipping competition" in the forums, participants picking up the winning teams before due date, and the winner gets certain points on a ladder. Is this possible?