{{comment .License}} Ebiten - A simple SNES-like 2D game library in Go

Ebiten (海老天)

v{{.StableVersion}}

A simple SNES-like 2D game library in Go
Works on
- Web browsers (powered by GopherJS)
  - Supported browsers: Chrome, Firefox, Safari on desktops
- Mac OS X
- Linux (maybe)
- Windows (possibly)
API Docs
Source Code (Development version: v{{.DevVersion}})

Features

2D Graphics
Input (Mouse, Keyboard)

Example

// {{.Name}}

{{.Source}}

Click to play!

Install on Mac OS X

:; brew install glew
:; brew install glfw3 # or homebrew/versions/glfw3
:; go get github.com/hajimehoshi/ebiten

If you want to run your game on a web browser, execute this:

:; go get github.com/gopherjs/gopherjs
:; go get github.com/gopherjs/webgl

Execute the example

:; cd $GOHOME/src/github.com/hajimehoshi/ebiten/example
:; go run rotate/main.go

Execute the example on a web browser

If you can the example screens above, Ebiten is working on your browser! Each example above works as an independent html in an iframe. If you want to execute the examples apart from this site, execute this:

:; go run $GOPATH/src/github.com/hajimehoshi/ebiten/example/server/main.go

Then, open localhost:8000 on your browser.

localhost:8000/?EXAMPLE_NAME shows other examples (e.g. localhost:8000/?rotate).

Of cource, you can execute gopherjs yourself. Please see GopherJS site for more detail.

Run your game on a web browser

Compile your game with GopherJS:

:; gopherjs build -o yourgame.js path/to/yourgame

Then, open the below HTML on your HTTP server:

<!DOCTYPE html>
<script src="yourgame.js"></script>

Change Log

2015-??-??

v1.1.0-rc1 released.
- Support for web browsers: Ebiten now includes support for web browsers with GopherJS.
- Some API has changed:
  - ImagePart is deprecated. Use ImageParts interface instead.
  - ColorM.Element and GeoM.Element's recievers changed from structs to pointers.
  - A lot of keyboard keys have been added. KeyMax and MouseButtonMax were removed.
- The game is stopped when the window is not active.

2015-01-04

v1.0.0 released.
- Nothing has changed from v1.0.0-rc1.

2014-12-29

v1.0.0-rc1 released.

License

Ebiten

{{.License}}

Go Gopher photograph

The original photograph of Go gophers by Chris Nokleberg is licensed under the Creative Commons 3.0 Attributions license.