===================================== = GENERAL GAME PLAYING BASE PACKAGE = ===================================== Application Suite for the General Game Playing Project; - A GUI-based GameKiosk (for playing human-vs-computer matches) - A GUI-based GamePlayer (for running computer players) - A GUI-based GameServer (for hosting matches) - A GUI-based GDLValidator (for validating game rulesheets) Support code for the above. === QUICK START GUIDE === Getting started is as simple as writing a new player that inherits from the StateMachineGamer class. StateMachineGamer is based on the state machine view of general game playing, in which playing a game is represented as proceeding through a state machine. The underlying state machine, which you can access via getStateMachine() when inheriting from StateMachineGamer, provides methods that you can use to investigate the game being played: * Each game has a starting state. getInitialState() is the starting state. * Each state has legal moves for every player. getLegalMoves(state, role) are the legal moves for <role> in <state>. * Some states are terminal, and in those states "goal" values are defined for every player, indicating whether they won or lost. isTerminal(state) indicates whether a state is terminal. getGoal(state, role) is the goal value for <role> in <state>. * Given a legal move for each player, you can transition from one state to the next state, after the players make their respective moves. getNextState(state, moves) is the result of making <moves> at <state>. A simple Prover-based state machine implementation is included in GGP Base, so you don't need to worry about the details of converting a game description into a state machine. To write a gamer based on StateMachineGamer, derive your class from players.gamer.statemachine.StateMachineGamer. Applications like the PlayerPanel should automatically recognize your new class and it should appear in their lists of available players right away. For examples of simple players, see src/player/gamer/statemachine/reflex, where two extremely simple "reflex-based" players are included: LegalGamer and RandomGamer. LegalGamer always chooses the first legal move available, and the RandomGamer always chooses a random legal move. === BUILD NOTES === The project must be built with Java 7 or later. The project contains Eclipse project files that allow it to be imported directly into Eclipse as an "Existing Project" or "Project from Git". This is the easiest way to get started with building, running, and modifying the code. For those who don't want to use Eclipse, there is also a Gradle-based build system. Gradle can generate project files for IntelliJ IDEA or build and test the codebase from the command line. The commands below use a Gradle wrapper included in the repository that automatically installs Gradle when run. Sample commands (use gradlew.bat instead if on Windows): Confirm Gradle version: ./gradlew -v Show list of available tasks: ./gradlew tasks Compile code and run tests: ./gradlew build Compile without running tests: ./gradlew assemble Run the Kiosk app: ./gradlew kiosk Run the Player app: ./gradlew player Run the Server app: ./gradlew server Create IntelliJ IDEA files: ./gradlew idea See the PROGRAMS file for additional programs that can be run, including non-GUI player and server applications. === MISC NOTES === * This is based on the 4/1/2010 release of GGP code for Michael Genesereth's CS227B class at Stanford University, compiled by Sam Schreiber with help and support from Ethan Dreyfuss, Eric Schkufza, Keith Schwarz, Steven Bills, and Mike Mintz. It is currently maintained by Sam Schreiber and Alex Landau. * This project is currently hosted on GitHub at https://github.com/ggp-org/ggp-base. The most recent version of the code can be found there. * This project is licensed under the New BSD License. Licensing information for the project can be found in the licenses/LICENSE file. Licensing information for the included external libraries can be found in the licenses/ directory.