Add-On Releases - [PBPG] Chess

What does it do?
This is a chess plugin for my Play by post gaming mod. It allows members to play chess against each other within a forum thread.

What can I use it for?
The main aim of games is fun but you could also run tournaments as well

Live Demo
A live demo of this mod can be seen on my own forums here: http://www.giveupalready.com/forumdi...r-Gaming-Forum

Features

• Javascript powered chess game within a fourm thread.
• Admin options:
  • Board Rotation (play with white at top or bottom)
  • Force board rotation (decide if players can override the default setting)
  • Private mode (only players can comment while game is in progress)
  • Image directory
  • pbpg_path
• Admin help for chess specific options
• Interface for setting options by members
• Member options:
  • Board rotation (if allowed by admin)
  • White player username/userid
  • Black player username/userid
  • Private mode (only players can comment while game is in progress)
• Status changing commands (resign, stalemate,check,checkmate)
• Tournaments and ladders integration. (Requires T+L v 4.0-0.1 a3+)
• Member statistics (games played/won/lost/drawn)

Planned features
[s]Struck out[/s] items in this list are implemented in my latest development copy and will make the next release. *** items are planned for next release.

• Admin options:
  • Enforce rules on/off/ignore first
  • Input format (support for PGN and other standard input formats)
• User options: (all can be forced to a certain value by the admin)
  • Enforce rules on/off/ignore first
  • Input format (support for PGN and other standard input formats)
• Javascript move forward/backward through moves.
• Ajax updating of board
• Updated member FAQ
• Full phrasing of front + back end to help translations.

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 Chess, 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.


Uninstallation
As of beta 1, the product will not allow you to uninstall it while it is still in use. (this would break your board.)
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 chess directory in pbpg_plugins.

Changelog

• 4.0-0.1 b5
  • Fixed a number of minor issues.
  • Fixed issue with reset being hit half way through making a move.
  • Added comms support; this allows the plugin to share information with other plugins. Currently, this is used to provide automatic tournament results to the tournaments + ladders plugin.
  • Added statistics (wins, losses, draws and games played) These can be mapped to profile fields using the interface in the core product.
  • Now requires PBPG core b4
    
• 4.0-0.1 b4
  • Fixed bug with javascript paths
  • Fixed extra move exploit in stalemate code
  • UI enhancements
    • Comment and post move button now appear along side chess board
    • Reset button added to reset board to current game state.
    • move list prevented from growing to big
    • Check/checkmate statuses highlight king
    • Status buttons go green when selected; can be toggled on and off.
  • Status changing commands for check and checkmate
  • Admin help
• 4.0-0.1 b3
  • Added status changing commands, players can now resign and request a stalemate.
  • Added private mode; hides comments from none players while the game is in progress, once the game ends (stalemate or a player resigns) the comments are shown.
  • Private mode can be set/locked by admin
  • Directory for images can be set
• 4.0-0.1 b2
  • Fixed bug with javascript in IE + chrome.
  • Plugin will now not install if you do not have core product installed and upto date.
  • Added option hinting to option boxes.
  • Fixed bug with castling/en passant causing the game to skip the next players turn.
  • Added highly defensive install/uninstallation code.
  • Now requires version 4.0-0.1 b3 (Beta 3) of pbpg core.
• 4.0-0.1 b1
  • Added uninstall code with safety check to prevent you breaking your board.
  • Added JS interface for users to set game options and choose players. This only shows for the thread starter. (ajax autocomplete on usernames)
  • Fixed bug causing default value for white square to be transparent.
  • Numerous user interface improvments; now shows players who are playing, move number and who's turn it is next.
• 4.0-0.1 a3
  • Fixed aditional database error in install code
• 4.0-0.1 a2
  • Fixed database error in install code
• 4.0-0.1 a1
  • Initial release

Notes

• enforcing rules was a hot request for my vb3.6 chess mod. This version has INCOMPLETE rules enforcing that is disabled. You could enable it by editing the code, however this will probably render most games unplayable at some point.
• This version is quasi-compatible with the vb3.6 version; however it requires some messing around to get it to work. At some point in the future I will release /something/ to convert between the two, however I don't have an ETA on this. Anyone asking for one without making a donation is likely to be ignored. UPDATE: this wasn't needed on my board, as members weren't interested in saving their old games, I will only work on this if requested by a donator.

[Carnage]

Yeah, the version on my site is the vb3 version; its got a lot more features implemented in it as i've been developing it longer; with the advent of vb4 changing all the style stuff, i've had to reimplement the entire user interface.

A good portion of the interface is done and will be in the next release; feel free to copy the instructions from my site in the interim thou. There are also some faq entries, but these will be out of date as since i've had to reimplement the user interface, i'm improved it quite a bit as well.

For the db error, find the get ALL posts plugin (from the pbpg core) find this line:

PHP Code:

$perpage = 99999999999999999; //should be enough... 


change to:

PHP Code:

$perpage = 99999999; //should be enough... 


This will be fixed in the next pbpg core release.

[ShawnV]

Awesome, looking forward to the update.

Oh, I noticed that I cannot deselect a forum once I have selected it for the game, even after uninstalling the plug in, it still leaves the game selection drop-down option when you create a post. Not sure if you knew about that.

[Carnage]

Little known fact, if you ctrl+ click a selected item in a multi select box, in most browsers it de-selects it. You can use this to remove plugin from a forum.

The reason that uninstalling it dosn't help is that the uninstall code is currently //todo. It'll probably be there in the next release.

[ShawnV]

If possible, It would be good to post an uninstall script for this since uninstalling the product does nothing at the moment.

[Carnage]

PHP Code:

$q = $db->query_first("SELECT * FROM ". TABLE_PREFIX."pbpg_plugin WHERE dir='chess'"); 
$q2 = $db->query("SELECT * FROM ".TABLE_PREFIX."pbpg_pluginconfig WHERE pbpg_pluginid = $q[pbpg_pluginid]");
while($row=$db->fetch_array($q2))
{
    foreach($vbulletin->forumcache AS $forum)
    {
        $test = unserialize($forum['pbpg_enabledpluginconfigs']);
        if(isset($test[$row['pbpg_pluginconfigid']]))
        {
            print_cp_message('Error Plugin still in use. Remove all configs using this plugin from forums its enabled in and delete all threads using it before removing the plugin.');
        }
    }
    $threads = $db->query_first("SELECT * FROM ".TABLE_PREFIX."thread WHERE pbpg_pluginconfigid = $row[pbpg_pluginconfigid]");
    if(is_array($threads))
    {
        print_cp_message('Error Plugin still in use. Remove all configs using this plugin from forums its enabled in and delete all threads using it before removing the plugin.');
    }
} 
$db->query_write("DELETE FROM ".TABLE_PREFIX."pbpg_pluginconfig WHERE pbpg_pluginid = $q[pbpg_pluginid]");
$db->query_write("DELETE FROM ". TABLE_PREFIX."pbpg_plugin WHERE pbpg_pluginid = $q[pbpg_pluginid]"); 


That will do it, however you should remove any configs that use the plugin from the forums you have them enabled in first.

The next version will ship with uninstall code.

Edit: updated with safer uninstall code.

[Carnage]

Uploaded beta 1 of this product.

Most important improvment of note is a substantial improvment to the user interface; more information has been added to the default display and the thread starter gets a form to set game options untill the first move is posted.

For anyone who is interested; i've also begun work on a tournaments mod which will be released soon. (At the point at which it first becomes usable)

[Carnage]

Added some screenshots.

[TimberFloorAu]

All we get is Blank Chess Board

[TimberFloorAu]

Your plugin image path is wrong:

http://www.yobromofo.com/pbpg_plugin.../images/bR.gif

Should be

http://www.yobromofo.com/forum/pbpg_.../images/bR.gif

[TimberFloorAu]

Also in chess product, all gif paths are wrong. In our case I have had to prefix with /forum