forked from ggp-org/ggp-base
-
Notifications
You must be signed in to change notification settings - Fork 0
andreyz4k/ggp-base
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
===================================== = 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 player: * 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 the 4/1/2010 release of GGP code for CS227B, compiled and maintained by Sam Schreiber with help and support from Ethan Dreyfuss, Eric Schkufza, Keith Schwarz, Steven Bills, and Mike Mintz. * 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.
About
The General Game Playing Base Package
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published
Languages
- Java 98.6%
- XSLT 0.7%
- Scala 0.2%
- HTML 0.2%
- Python 0.1%
- Shell 0.1%
- Other 0.1%