The Chess Variant Pages
Custom Search



The Chess Variants Game Courier FAQ

What is a preset?

A preset is a set of values for the different parameters that can be changed in Game Courier. The parameters control such things as board size and shape, piece positions, graphics used for boards and pieces, methods for rendering diagrams, and code for automating complicated moves or for enforcing rules. In brief, a preset is a set of parameters that define a particular game with a particular appearance. A preset is normally expressed as a set of default values and changes to the defaults.

What is a settings file?

A settings file is a set of default values. Game Courier defines default values with an array called $default. Although Game Courier gives this array a set of default values, a settings file changes the values of the default array, thereby creating a new set of defaults. So there are two kinds of default values. There are default defaults, and there are custom defaults. The default defaults are defined in the program, while the custom defaults are defined in a settings file. When it comes time to write a log, Game Courier enters into the log only those values that differ from the defaults. This saves space, and it allows automation code to be debugged without needing to touch individual log files.

What is the difference between a preset and a settings file?

A settings file, when used, is only part of a preset, never the whole thing. For one thing, a preset may be defined by a settings file and some changes to the values in the settings file. But even when the preset makes no changes to the values of a settings file, it has made a change to the value of the $settings parameter, which is by default an empty string. This change to the default defaults is required when you use a settings file, and it has to be made outside the settings file for Game Courier to know which settings file to use for its new set of defaults.

What browsers can I use with Game Courier?

To fully make use of all its features, you will need a modern browser that handles JavaScript, CSS, cookies, and PNG images. It works very well in the latest versions of all the major browsers for Windows 7: Chrome, Firefox, Internet Explorer, and Opera. It should also work well in these or related browsers on Linux, the Mac, and other versions of Windows. Although it makes use of features lacking in early browsers, it will let you move without JavaScript by entering the notation for a move, it can render boards as GIF or JPG images for early browsers like Mosaic or Netscape, and it can render boards as ASCII diagrams for Lynx, the text-based Unix browser. The main question these days is with mobile browsers. In my experience, it works well with Firefox and Boat Browser on my Toshiba Thrive tablet running Ice Cream Sandwich (Android 4.0.4), with Safari on the iPad, and on the experimental browser on the Kindle Touch. But it is not working well with many Android browsers on my rooted Nook. The main cause seems to be that my Nook uses Android 2.1, a very early version of Android, and the latest versions of browsers expect features in later versions of Android. The one browser that has worked well with Game Courier on my Nook is Opera Mobile 12, an earlier version that I sideloaded in instead of getting it from the Android market. It's also notable that this version uses Presto, while the browsers that have been exhibiting buggy behavior are mainly or entirely Webkit-based browsers. Opera later abandoned Presto, but that means it hasn't been tinkered with recently, and an old Presto-based browser may remain more compatible with an early OS like Android 2.1.

Are there any known problems with specific browsers?

If you're playing in real time, you will need the ability to play wave files with your browser. Internet Explorer has this ability built in, but Mozilla-based browsers (Netscape, Mozilla, and Firefox) require a plug-in. As long as your plug-in for playing wave files works, you should have no problems. But I am currently having a problem with Firefox, which is my main browser, because it isn't working with the Quicktime plug-in. This problem may well be specific to my computer and not exist for others. Firefox is a great browser, and I do recommend it despite this problem I am having with it.

Many mobile browsers have not been working well with Game Courier on my rooted Nook Simple Touch. This device runs Android 2.1, an early version of Android, and most of the browsers I've tried with it are the latest versions. I expect they have been designed with later versions of Android in mind, causing them to have bugs when running on an earlier version of Android.

One particular mobile browser, UC Browser Mini, has a speed mode, which speeds up downloads by fetching compressed pages from a server, and which also rearranges webpages to focus more on text. Other mobile browsers have similar features. This kind of feature can cause problems for Game Courier if it changes anything on the page. On my tablet, on which I assume it is running bug free, speed mode disables the menu and the ability to move a piece to an empty space by touching it. With speed mode turned off, it works fine.

Does Game Courier use cookies?

Yes, Game Courier uses cookies. The cookies it uses are PHPSESSID, which keeps track of the PHP session, cvpuser, which keeps track of your userid, and landscape and portrait for remembering screen sizes on mobile devices, which it uses for fitting a diagram to the available space. The first two cookies are used not only by Game Courier but by other pages on our site. The first lets us use sessions to note whether you're logged in and to keep some information about you on hand for customizing the web pages served to you. The advantage of storing your information in a session is that it is kept protected on the server-side instead of being placed insecurely in cookies. But the use of sessions does require the use of a session cookie. The other cookie lets you log in more quickly by keeping track of your userid even when you're not logged in.

My opponent tells me he moved, but I didn't receive the email from Game Courier. What should I do?

To move, go find your game on the Logs page. Enter your userid in the Userid field and hit submit. It will show you your recent games, and it will provide a link for moving in any game for which it is your turn. The link will use your name as its link text, and it will show up under the "Next Move For:" column.

If you didn't see the email in your inbox, check your junk folder for it, if you have one. The email may have been stopped by a spam filter, perhaps because Game Courier forges email from your opponent's address. If you can, put your opponent's email address on a white list to prevent the email of his moves being interpreted as spam.

I didn't see my game on the logs page. How can I find it?

If it's not a publicly viewable game, it will not show up unless you also enter your password. Enter both your userid and password to see it.

If it's not a recent game, it may have been filtered out because of its age. Extend the maximum age allowed for the logs that show up.

If your game has finished, it will no longer show up among the ongoing games. Change the status filter to allow finished games to show up.

If it's still not showing up, make sure the Log and Game filters are both set to *.

Do I have to be a member of the cvgameroom Yahoo group to send open invitations?

No, you don't. You may send an open invitation to any email address you specify.

Do I have to be a member of the cvgameroom Yahoo group to send open invitations to the cvgameroom Yahoo group?

You don't have to be a member to use its email address in your open invitation, but you do have to be a member for the invitation to be mailed to the members of the group. This group blocks spam by not delivering mail from anyone who is not a member.

I am a member of the cvgameroom Yahoo group, and I sent an invitation to that group, but it wasn't delivered to the members.

Make sure that the email address we have on record for your userid is the same address the cvgameroom Yahoo group has on record for you. Your open invitation will be sent to the members of the group only if these two email addresses are the same.

How can I post open invitations while avoiding Yahoo?

Enter a different email address into the opponent field, preferably a mailing list of people who would be interested in receiving an open Game Courier invitation. But the only mailing list set up for just that purpose is a Yahoo group. So that one is the default.

How can I protect myself from cookies in the CV Gameroom Yahoo group?

Cookies are not really a danger. But in case you think they are, Firefox has extensions available for it which can automatically disable cookies. Once you are a member of the group, you don't have to ever visit its website. It will just send you cookie-free email.

How do I resign a game?

Enter the word resign in the same place you normally enter your move. This is a command which will automatically change the game status to say that your opponent has won.

What has happened to the Status field?

I have hidden it. Many presets are now programmed to update the status automatically, and for those that aren't, there are commands available for updating it from the Moves field. If you have won a game, enter won to mark your victory. If you have lost a game, and your opponent has not already entered won, you should enter lost to mark your defeat. This functions the same as resign, but it should be reserved for losing normally, such as by checkmate, rather than for resigning.

What has happened to the second background field?

To better accomodate user customization, certain background images are now paired together in the code for the program. If the background image you chose has a pair, its pair will show up as the background image for the second player. If you create a set of paired background images, you should contact me about adding some lines to the code for pairing them together.

How do I convert a Zillions Rules File to GAME Code?

There is no straightforward way to do this, since the ZRF language and GAME Code are too dissimilar. You will have to know how to program in both languages, and it will generally be best to just program a game in GAME Code from scratch. That said, GAME Code does include the ability to use logical directions, which are the only type of directions available in Zillions-of-Games. In the developer's guide, look up map, link, logleap, logleaps, lograys, and logride. Using these may allow you to adapt some of the code from a ZRF.


Written by Fergus Duniho
WWW Page Created: 10 November 2004.