Nutshell¶
Nutshell is a lightweight open source game engine.
It is standalone and portable: you don't have to install any other programming software to build or run your games with it!
Ready? Set? Go nuts!
What is Nutshell?¶
A game engine¶
It is a game engine: It runs your game.
Or any game someone made to be used with it, for that matter.
Nutshell is not limited to games however, any kind of project can be built with its simple framework.
However, it is not (yet!) a game editor, there is no shiny user interface to build your game... you will need to use at least a text editor to write your game's code.
In a nutshell...¶
Nutshell enables you to easily :
- Read keyboard / mouse / gamepad inputs
- Draw primitives
- Draw Images
- Draw Text
- Play Music / Sounds
- and much more!
Multiplatform¶
Nutshell games work on:
Built on the shoulders of giants¶
It leverages the power of the Squirrel programming language and the flexibility of the SDL to provide a simple game programming framework.
It is made with the Go programming language and use PureGo to wrap the Squirrel library, and go-sdl3 to wrap the SDL 3 library.
License¶
Nutshell is, and always will be, entirely free and open-source software.
This project and its documentation are released under the zlib license.
This license allows you to use Nutshell freely:
Free as in "Beer"¶
You can download, use, and distribute Nutshell without paying anything. There are no royalties or licensing fees required to use it.
Free as in "Speech"¶
You can modify its source code, distribute it or altered versions of it. You can use it commercially if you want to.
However...¶
Don't.
- You CANNOT claim that you wrote the original code.
- If you modify the code and distribute it, you MUST clearly mark it as altered so it isn't confused with the original version.
- The copyright notice and the license text CANNOT be removed from any source distribution.
Do. (If you want to!)
- If you use part of the code or the whole software, an acknowledgment in your documentation is appreciated but is not required.

Eastern Grey Squirrel eating acorns, Author: Dkwikiedt