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]

If you've deleted the uninstall code from the chess plugin, it will not do anything to prevent its removal.

Alternativly: upgrade both the core and this product to the latest versions and then uninstall.

[TimberFloorAu]

I have tried that. Will give it one more go.

[TimberFloorAu]

Ok Deleted.

But you still have issues with file paths.

Images to chess pieces are not showing up, I posted this in one of your threads.
I imagine that is why the game doesnt work, also because paths are incorrect

[Carnage]

I'm planning a release as soon as I'm able to get it finished.

Will feature privacy mode; admin settings for the images directory and commands to change the games status (eg checkmate, stalemate etc) an important step towards being able to do cool things like tracking user stats and integrating into my tournaments and ladders mod.

[Carnage]

Update released.

[ShawnV]

Hey Carnage, Ive installed and uninstalled the latest versions of this and the core and I still have the pbpg_chess_blackbg & pbpg_chess_whitebg Stylevars.

[Carnage]

That seems to be a bug in vbulletin; I just checked the delete product code; there is no code to remove added style vars.

Edit: Did some research; known bug in 4.0.2 http://www.vbulletin.com/forum/proje...?issueid=36241

[ShawnV]

Ah thanks man, figures. lol

[ricardoNJ]

I looking chess for 3.8.4....

[DragonBlade]

Originally Posted by Carnage-

From the admin side; I'm going to assume you followed the install instructions and have managed to create a configuration and assigned it to a forum.

From there, you need to goto the forum you assigned it to; create a new thread. There will be a list of avaliable games to play on the post new thread form. Select the chess configuration you just made. Make a post, at this point it dosn't really matter what you say in it.

The thread will then display as a chess board, with a comments box at the bottom and a moves list at the side. Clicking any piece on the chess board will select it (red border) and selecting an empty space (or space containing an enemy piece) will move it there. You will notice that some characters representing the move you just made were put into the quick reply box and the move was added to the moves list. You may now add a comment to the quick reply box (maybe something like 'check' or 'good move') and post a reply.Only when you've posted the reply has the move become commited.

Anyone who views the thread can now see your move. By default the first two people to post valid moves become white and black respectivly, but you can change this by adding the string (option,white,<username for white>) and (option,black,<username for black>) to your first post.

Yo.

We've got the correct image path on our forums, and it does display the pieces. However, it's not allowing us to set players and make moves and stuff.

If it helps at all, we DO get this javaScript error when loading a thread that has the board:
Error: complete is not defined
Source File: http://(myforum)/showthread.php?87079-Testing...
Line: 1027

Here's the relevant piece of code:

    <script type="text/javascript">
    <!--
        black_sugg = new vB_AJAX_NameSuggest('black_sugg', 'black', 'blackplayername');
        white_sugg = new vB_AJAX_NameSuggest('white_sugg', 'white', 'whiteplayername');

    YAHOO.util.Event.on(window, 'load',function(){
    YAHOO.util.Event.addListener('rotation_menu_body','click',complete);
    YAHOO.util.Event.addListener('quiet_menu_body','click',complete);
    });
    //-->
    </script>

Did we screw up somewhere?