Crate curses_game_wrapper

This crate is wrapper of curses games like rogue and nethack, for AI making.

What this crate provie is spawning CUI game as child process and emulation of vt100 control sequence(helped by vte crate).

To run AI, You have to implement Reactor trait to your AI object. The result of vt100 emulation are stored as Vec<Vec<u8>> and AI recieves it as Changed(Vec<Vec<u8>>).

Examples

extern crate curses_game_wrapper as cgw;
use cgw::{Reactor, ActionResult, AsciiChar, GameSetting, Severity};
use std::time::Duration;
fn main() {
    struct EmptyAI {
        loopnum: usize,
    };
    impl Reactor for EmptyAI {
        fn action(&mut self, _screen: ActionResult, turn: usize) -> Option<Vec<u8>> {
            let mut res = Vec::new();
            match turn {
                val if val == self.loopnum - 1 => res.push(AsciiChar::CarriageReturn.as_byte()),
                val if val == self.loopnum - 2 => res.push(b'y'),
                val if val == self.loopnum - 3 => res.push(b'Q'),
                _ => {
                    let c = match (turn % 4) as u8 {
                        0u8 => b'h',
                        1u8 => b'j',
                        2u8 => b'k',
                        _ => b'l',
                    };
                    res.push(c);
                }
            };
            Some(res)
        }
    }
    let loopnum = 50;
    let gs = GameSetting::new("rogue")
        .env("ROGUEUSER", "EmptyAI")
        .lines(24)
        .columns(80)
        .debug_file("debug.txt")
        .max_loop(loopnum + 1)
        .draw_on(Duration::from_millis(200));
    let game = gs.build();
    let mut ai = EmptyAI { loopnum: loopnum };
    game.play(&mut ai);
}

Structs

GameEnv

This is for spawning curses game as child process.

GameSetting

Game process builder, providing control over how a new process should be spawned.

Enums

ActionResult

Result of the game action. Changed(Vec<Vec<u8>>) contains virtual terminal as buffer.

AsciiChar

It’s imported from ascii crate for convinience. An ASCII character. It wraps a u8, with the highest bit always zero.

Severity

The severity of a log record.

Traits

Reactor

You have to implement Reactor for your AI to work.