Major Additions - Chess

Chess for vbulletin.

This mod turns an existing forum into a forum for playing chess in. Members can then play games against each other as easilly as posting a new post in a regular forum.

NB: the beta version of this dosn't enforce the rules of chess so illegal moves are possible - this does have the advantage of allowing handicap matches and variations on standard chess rules.

beta

This mod is a beta mod, this means that i have all the functions working on my board however there may be unforseen problems and conflicts on different vb setups. I'm 95% confidant that there are no major isseus left in the core code, the only issues that may arrise are from the new ajax features. If this is a problem for you, you can disable the ajax features in the admin cp.

Demo

A live demo can be seen here: http://www.giveupalready.com/forumdisplay.php?f=349 (running v1.0.1 till i've time to upgrade it)

Screenshots

Screen shot shows new UI

Version History

1.1b (beta): current version
- improved user interface (if you've changed the chess template you will need to revert/apply the changes manually)
- back/forward buttons for local moves (unsaved. Full backward/forward movement will be added in a later version)
- highlight for currently selected square.

1.0.1b (beta):
- fixed a couple of misisng TABLE_PREFIX's
- fixed table spacing issue

1.0b (beta):
- forced quick reply to be enabled.
- added reset board link + javascript to reset the board without reloading.
- ajax posting of moves.
- board updates itself every 10 secs via ajax.
- added option to flip layout of board.

0.2b (beta):
- added some javascript to update piece replacments instantly.
- templates are now fully phrased.

0.1b (beta):
- added faq entries to product file
- (hopefully) improved compatablity with vbseo
- modified instal instructions to avoid potential javascript problems.
- changed version numbering scheme.

beta:
- re-exported product file to contain all the settings fields.

alpha:
- changed image paths to allow for customised images.

Known Issues

- Table sizes are inconsistant
- If min post length is greater than 7 moves wont post without a comment.

Compatability

This mod was written on vb 3.6.0 and has been tested on 3.6.7 compatablity with other versions is unknown. Reported working on 3.6.8

Instalation

1. Backup your Database
2. Upload images into your images directory.
3. new for v1.0b Upload Chess.php to your main forum directory.
4. Turn your board off.
5. Create a new forum, browse to it and make a note of its forum id.
6. Disable Html, bb code,smilies,[img] code and post icons in this new forum
7. Import the chess product
8. In the vbulletin settings change the forumid to the new forum you created. You can also change the piece colour to better match your forums style.
9. (Optional) Create a link forum to point to the chess faq which explains how to play.
10. Turn your board back on
11. Click installed.

Upgrade from < 1.0b

1. Backup your Database
2. Upload Chess.php to your main forum directory.
3. Import the chess product (allow overwrite must be set to yes)
4. Check the new settings are set to your liking.

Upgrade from 1.0b

1. Import the chess product (allow overwrite must be set to yes)

Support

As all of my boards have been upgraded to vbulletin 4, I am no longer actively maintaining any of my vb3.x mods. Free support for all of my 3.x mods is being removed from the 31st of March 2010 after this date, I will only be offering paid support for 3.x mods; downloading and usage of the mods will remain free but unsupported.

For support of 3.x mods, please pm me as I won't be checking the threads very often.

Liscense
THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

You may modify this software to suit your own purposes but may only distribute said modifications within this thread and with my approval.

Credits

Images were modified from icon files downloaded from http://www.enpassant.dk/chess/grafeng.htm

Checkers

Untill i get arround to coding and releasing a checkers game you can play checkers using this mod using the following instructions provided by one of my forum members:

(b8,b8)(d8,d8)(f8,f8)(h8,h8)(a7,a7)(c7,c7)(e7,e7)(g7,g7)(a1,a1)(c1,c1)(e1,e1)(g1,g1)(b2,b2)(d2,d2)(f2,f2)(h2,h2)(c8,bR)(e8,bR)(g8,bR)(b7,bR)(d7,bR)(f7,bR)(h7,bR)(a6,bR)(c6,bR)(e6,bR)(g6,bR)(b1,wR)(d1,wR)(f1,wR)(a2,wR)(c2,wR)(e2,wR)(g2,wR)(b3,wR)(d3,wR)(f3,wR)(h3,wR)

Just copy the code when you are making the first post. Simple as that.

Notes:
1. When you jump a piece, you must also double-click on the piece that you jump to get rid of it. If you write out the code manually, just write the code twice. [ex: (f4,f4)]

2. To get a king piece, use the same code as you would to promote a pawn.
[ex: (a1,bK)]

3. If you double jump, please put in the full syntax and not just the finishing move. This will help your opponent see all the jumps that you made.

Custom Images

You can add image sets by uploading a gfx for each piece identified by its initial into a new directory within the /images/chess/ directory and then changing the image settings in the admincp.

If anyone has any custom image sets that they can legally distribute pm me a link and i'll link to them in this post.

Feature requests
- Leader board
- Other games (checkers, monopoly,risk, go)

[Carnage]

ah... that'd be the new csrf protection thingy that got added somewhere along the line. It needs a template change but i'm not sure what atm...

[Digital Jedi]

Took me a while to pin this down, but I tracked the disappearance of my Quick Reply to this modification. I can't quite pinpoint the timeline, but I believe it was after I made the upgrade 3.8.4 and did the last upgrade on this shortly afterward. It appears they're not compatible, at least in that regard.

[Carnage]

It should only edit the quick reply settings for the forum its active on.

I've not tested it on .8.4 however so there may be an unforseen complication.

[imported_silkroad]

Originally Posted by Digital Jedi

Took me a while to pin this down, but I tracked the disappearance of my Quick Reply to this modification. I can't quite pinpoint the timeline, but I believe it was after I made the upgrade 3.8.4 and did the last upgrade on this shortly afterward. It appears they're not compatible, at least in that regard.

We had the same problem with 3.7.4, no quick reply (running 1.1b (beta) of this mod).

In addition, the pieces did not move either using AJAX or replying with (e2-e4) so we had to uninstall the latest version (1.1b (beta)) as well.

Our forum members look forward to the day when this is a robust mod. So far we have had to try and deinstall every attempt at installation.

[Carnage]

Our forum members look forward to the day when this is a robust mod.

Me too

Just need a few weeks free to really work on my various mods and get the creases ironed out.

[SDDirtySox]

Originally Posted by Texas_Dawg

When I try to post a move on the game in my chess forum, I get this message:



Anyone know what is causing that and how I can fix it? Thanks.

Has this been fixed?

[SDDirtySox]

Originally Posted by Texas_Dawg

When I try to post a move on the game in my chess forum, I get this message:



Anyone know what is causing that and how I can fix it? Thanks.

Here's how I fixed it. In the chess Template, search for: value="$session[sessionhash]"

add this line directly after it:

<input type="hidden" name="securitytoken" value="$bbuserinfo[securitytoken]" />

Link to Implementing CSRF Protection in modifications: https://vborg.vbsupport.ru/showthread.php?t=177013

This mod has a ton of potential. I'm also looking forward to a more robust mod. Great work!!

[SDDirtySox]

Originally Posted by Digital Jedi

Took me a while to pin this down, but I tracked the disappearance of my Quick Reply to this modification. I can't quite pinpoint the timeline, but I believe it was after I made the upgrade 3.8.4 and did the last upgrade on this shortly afterward. It appears they're not compatible, at least in that regard.

I made this change and it looks like it fixed my problem with Quick Reply.

line 673 in product-chess.xml.

eval('$postbits = "' . fetch_template('chess') . '";');

$show['quickreply'] = false;

}



]]></phpcode>

[Carnage]

Ok, i tracked the problem with the quick reply down.

As posted above, the $show['quickreply'] = false; is the wrong side of the bracket.

Edit the plugin showthread_complete and edit the last 3 lines to be:

eval('$postbits = "' . fetch_template('chess') . '";');

$show['quickreply'] = false;

}

Sorry, i don't have time to put this fix into a release at the moment; i'm working on a port of this mod to vbulletin 4; just as a fyi:

The mod will be split into parts; there will be a 'core' mod "Play by Post gaming" which will then have multiple plugins to support various different games. When vb4 goes gold i'm /hoping/ to have the core finished and two plugin games; chess and chess freeplay (eg one with rules enforced, one without)

[dethfire]

looking forward to the next release!