The comfortable framework for making games in Wren

View the Project on GitHub avivbeeri/dome

< Back

Distributing your games

DOME is designed to be cross-platform, and so the same Wren game files and assets should work across Windows, Mac and Linux. On Mac and Linux, the SDL2 shared library will need to be provided.

Basic Packaging

The easiest way to share a game you’ve made is to place a DOME binary, your source code and game assets into a single zip file. Do this once for each platform you wish to support, and share those zip files with your users.

NEST - Easy bundling

(Please note: NEST is still in development, and has to be built from source)

For easy distribution, you can package all of your games resources into a single .egg file using a tool called NEST. DOME automatically plays any file named game.egg in the current working directory.

If you use a .egg file, DOME expects your game to start from a main.wren in the base directory as it’s entry point.

Install NEST, and then navigate to your main game directory, before running the following:

> nest -z -o game.egg -- [files | directories]

Cross-Platform Distribution

(You can ignore this section if you are using pre-compiled DOME binaries.)

This section discusses the needs of various platforms when distributing games with DOME.


On Windows, DOME comes compiled with all it’s dependancies, so you just need to provide your game files.

Mac OS X

On Mac, the SDL2 library needs to be provided. This can either be globally installed, or you can package it as part of an application bundle, using the following layout:

+-- Game.app
    +-- Contents
        +-- Info.plist
        +-- MacOS
            +-- dome
            +-- libSDL2.dylib
            +-- Game (This is a small runscript)
        +-- Resources
            +-- game.egg
            +-- icon.icns

The runscript is very simple and looks like this:

cd "${0%/*}"

Finally, the Info.plist at minimum needs to look like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">

The .app bundle, runscript and the CFBundleExecutable must all be named the same.

Doing this results in a self contained and easy to distribute application bundle.


To run your game on linux, make sure SDL2 is installed, then run the dome executable with a game.egg file in the same directory.