Note: This project currently requires using the nightly build of Rust, as the parser relies on unstable compiler features to generate the parsing code. The easiest way to maintain multiple distributions of Rust is multirust.
ggp-rs is a library for creating GGP (general game playing) players in Rust that is based off of GGP Base. While GGP Base allows the creation of players backed by a propositional network or a logic prover, this library currently only supports logic prover based players. Note that while this library is functional, it is still in early development. That means that the API may change, and there may be bugs and performance issues. Please file an issue to report a bug or request a feature. Pull requests are welcome.
You can install this library from crates.io by adding the following to your Cargo.toml:
ggp-rs = "*"
Here is an example of a player that plays random legal moves (this example can be found in the examples folder):
``` extern crate rand; extern crate ggp_rs;
use ggp_rs::{Player, Game, Move}; use std::net::Ipv4Addr;
struct RandomPlayer;
impl Player for RandomPlayer { fn name(&self) -> String { "RandomPlayer".to_string() }
fn select_move(&mut self, game: &Game) -> Move {
let state = game.current_state();
let role = game.role();
let mut moves = game.legal_moves(state, role);
let r = rand::random::<usize>() % moves.len();
moves.swap_remove(r)
}
}
fn main() { ggp_rs::run((Ipv4Addr::new(0,0,0,0), 9147), RandomPlayer); } ```
To test the player you can use the Server application in GGP Base or make an account on Tiltyard and add your player. Note that you should run your player with cargo run --release or your player may not be fast enough for most games.
You can find the API documentation here.