gaiman

Gaiman Engine and Programming Language

Gaiman: Storytelling Text Based Game Engine and Programming Language

Main part of Gaiman is a minimalist programming language and main purpose is to help create Text Adventure Games. But it can also be used to create any interactive CLI applications (Web Based Terminal applications). It support browser based CLI applications and in the future also native command line.

Installation

npm install -g gaiman@beta

Usage

gaiman -o directory input.gs

This will compile your source file and generate dir/index.html and dir/index.js files. And you can open generated html file in browser and run the game.

Documentation

See Reference Manual on Wiki.

Examples

This is Hello world Gaiman DSL example:

echo* "Hi, What is your name?", 50 # Typing animation with 50ms delay
let name = ask "name? "
echo "Hello $name, nice to meet you."

More advanced example:

def ask_details(msg)
    echo msg
    echo "Do you want me to contact you with updates?"
    let confirm = ask "yes/no: ", lambda(answer)
        return answer =~ /^(y|yes|n|no)$/i
    end
    if confirm =~ /y|yes/i then
        echo "what is your name?"
        let name = ask "name: ", lambda(name)
            let valid = name != ""
            if not valid then
                echo "You need to type something"
            end
            return valid
        end
        cookie.user = name
        let email = ask "email: ", lambda(email)
            let valid = email =~ /^.+@.+\..+$/
            if not valid then
                echo "wrong email"
            end
            return valid
        end
        cookie.email = email
        let response = post "/register", { "name" => name, "email" => email }
        if response then
            echo "Welcome $user. You're successfully registered"
        end
    else
        echo "Ok, as you wish. Bye"
    end
end

if cookie.visited then
    if cookie.user then
        let user = cookie.user
        echo "Hello $user, welcome back"
    else
        ask_details("Welcome back strager")
    end
else
    cookie.visited = true
    ask_details("Welcome stranger")
end

More examples in examples directory See Reference Manual

Live Demo

See Gaiman language Playground

Roadmap

See Wiki TODO & Roadmap.

Name and Origin

Name came from Neil Gaiman, Author of novels, comic books, graphic novels and films. Great storyteller.

You can read about the origin of the language in the beginning of the article:

• How to create programming language that compiles to JavaScript

Acknowledge

Logo use:

• Font Calling Heart by Lettersiro Studio
• Clipart Book with bookmarks by Kevin David Pointon

License

Released under GNU GPL v3 or later
Copyright (c) 2021 Jakub T. Jankiewicz