A cross-platform game engine written in Go following an interpretation of the Entity Component System paradigm. Engo is currently compilable for Mac OSX, Linux and Windows. With the release of Go 1.4, supporting Android and the inception of iOS compatibility, mobile has been be added as a release target. Web support (gopherjs) is also available.
This table shows the current state of what's working and what's not. We are aiming to turn all No columns into Yes columns.
| Aspect/Target | Linux | Windows | OSX | WebGL | Android | iOS* |
|---|---|---|---|---|---|---|
| Compilation | Yes | Yes | Yes | Yes | Yes | ? |
| AudioSystem | Yes | No | Yes | No | No | ? |
| RenderSystem | Yes | Yes | Yes | Yes | Yes | ? |
| XXXXXSystem | Yes | Yes | Yes | Yes | Yes | ? |
*iOS will not build at all (due to gomobile limitations), if it would, most of these would be supported the same way Android is.
We are working towards a 1.0 release, and making good progress.
We welcome any contributions.
Currently documentation is pretty scarce, this is because we have not completely finalized the API and are about to go through a "prettification" process in order to increase elegance and usability. For a basic up-to-date example of most features, look at the demos.
We have a gitter chat for people to join who want to further discuss engo. We are happy to discuss bugs, feature requests and would love to hear about the projects you are building!
There are currently two major important packages within this repository: engo.io/engo and engo.io/engo/common.
The top level engo package contains the functionality of creating windows, starting the game, creating an OpenGL
context and handling input. It is designed to be used with Systems designed as per engo.io/ecs specifications.
The common package contains our ECS implementations of common game development Systems like a RenderSystem or
CameraSystem.
- First, you have to install some dependencies:
- If you're running on Debian/Ubuntu:
sudo apt-get install libopenal-dev libglu1-mesa-dev freeglut3-dev mesa-common-dev xorg-dev libgl1-mesa-dev git-all - If you're running on Windows you'll need a gcc compiler that the go tool can use and have
gcc.exein your PATH environmental variable. We recommend Mingw since it has been tested. You'll also need git installed, we recommend getting it from The official Git site - If you're on OSX, you will also need Git. You can find instructions here. You can also use homebrew to install git as well. Open an issue if you have any issues
- Then, you can go get it:
go get -u engo.io/engo - You may also want to get the dependencies of platform specific builds, so that build tools like godef can use them:
go get -u -tags netgo ./...go get -u -tags android ./... - Now, you have two choices:
- Visit our website, which hosts a full-blown tutorial series on how to create your own game, and on top of that, has some conceptual explanations;
- Check out some demos in our demos folder.
- Finally, if you run into problems, if you've encountered a bug, or want to request a feature, feel free to shoot us a DM or create an issue.
Engo is currently undergoing a lot of optimizations and constantly gets new features. However, this sometimes means things break. In order to make transitioning easier for you, we have a list of those changes, with the most recent being at the top. If you run into any problems, please contact us at gitter.
engo.PreloadedSpriteSingleis nowengo.LoadedSpriteengo.Files.Loadandengo.Files.LoadManyhave been merged into one functionengo.Files.Loadwhich does the same thing asengo.Files.LoadManyallowing an indefinite ammount of parameters to be passed in.engohas been split inengo(which contains stuff about creating windows, starting the game, creating an OpenGL context, input handling, etc.) - andcommon(which contains a lot of commonSystemimplementations for common tasks (RenderSystem,CameraSystem,AudioSystem, etc.)engo.Width()andengo.Height()have been changed toengo.GameWidth()andengo.GameHeight()respectively.RenderComponent.Scaleis now no longer a method, but a variable you can change / access directly.engo.NewRenderComponentwas removed. You can now define the values you want directly by usingengo.RenderComponent{}. Note that theDrawableis still required.ecs.Entitychanged toecs.BasicEntity,world.AddEntityis gone - a lot has changed here. The entire issue is described here, while this comment in particular, should help you migrate your code.- Renamed
engo.io/webgltoengo.io/gl, because the package handles more than only webgl. github.com/EngoEngine/engo->engo.io/engo- Our packagesengo,ecsandglshould now be imported using theengo.iopath.engi.XXX->engo.XXX- We renamed our packageengitoengo.
Engo, originally known as Engi was written by ajhager as a general purpose Go game engine. With a desire to build it into an "ECS" game engine, it was forked to github.com/paked/engi. After passing through several iterations, it was decided that the project would be rebranded and rereleased as Engo on its own GitHub organisation.
Thank you to everyone who has worked on, or with Engo. None of this would be possible without you, and your help has been truly amazing.
- ajhager: Building the original
engi, which engo was based off of - paked: Adding ECS element, project maintenance and management
- Newbrict: Font rendering, TMX support
- EtienneBruines: Rewriting the OpenGL code, maintenance and helping redesign the API
- otraore: Adding in GopherJS support, maintenance
- Everyone else who has submitted PRs or issues over the years, to any iteration of the project
These are 3rd party projects that have made engo possible.
- The original engi game engine which engo was based off of (BSD license)