Jocular (adjective)
Characterized by jokes and good humor.
(Wordnet)

Jocular is a basic general game player written in Java, developed and maintained by the Stanford Logic Group. Although Jocular's primary purpose is pedagogical (for Stanford's GGP class), we provide it as an aid to anybody who would like to get started with GGP.

Getting the Player:

The current release is Jocular 0.2. Java class documentation is available online and in the release archive.

Since Jocular is still under active development, we will also be giving access to our version control system. Stay posted for more details.

Please note that by downloading this player, you are agreeing to all terms in the license. If you do not agree to this license, you may not download the software.

Running the Player:

To run the player, execute the file run-jocular.sh from the Jocular directory. This will work in any Unix-like environment (including Mac OS X and Cygwin). Windows users without Cygwin should create a batch file the contents of which can be easily derived from run-jocular.sh.

Future Plans:

Highest on our priority list is writing more documentation. We want to not only complete the Javadoc but also write higher-level documentation to explain the general architecture of the code.

Known Issues:

When running several Minimax gamers at once, there are rare instances of failure to find legal moves, which results in returning a nil move.

License:

Please see the license file. In brief, we have adopted a generous open-source license and our main request is that you send us bug reports and, if you feel so inclined, bug fixes or suggestions. The main restriction is that you may not redistribute the source code.

Although we try very hard to write bug-free code, we make no guarantees whatsoever that our code is error-free. The code is provided as is, without any warranty whatsoever. Please see the license for more details.

Contact:

As said above, this code is provided as is and as such we do not intend on providing support beyond bug fixes and the documentation we provide. Jocular is intended to be a starting point only, not a finished product. We will be creating a FAQ as questions become common enough, and given enough demand we will set up a wiki.

That said, feedback, suggestions and especially bug reports are very appreciated. Until we set up an issue tracker, please send them to David Haley (dhaley@cs.stanford.edu) or info@games.stanford.edu.