Docs / User guide

Exporting

Turn your project into a standalone game folder you can share with other people.

When your game is ready, export it. The result is a folder that runs on another PC with nothing installed: no Voxel Game Maker, no Godot, nothing else.

#Export your game

1. Choose File ▸ Export Game (Ctrl+E), or click Export on the top toolbar.
2. Type a game name.
3. Choose an output folder.
4. Pick an icon, a PNG picture.
5. Tick the platforms you want.
6. Start the export.

Before exporting, the editor runs the same checks as Play: something to stand on at the Player Start, a start world, a player model, and no objects with a missing model or script. It offers a one-click fix if something's wrong.

#Platforms

Windows is the main target. A platform shows greyed out in the dialog if its runtime is missing.

#Windows

The .exe uses the icon you picked. Keep the .exe and the .pck together in the same folder, with the same name. The game needs both to run.

#Mac

The Mac app isn't code-signed, so players need to right-click it and choose Open the first time. The README in the zip explains what to do if macOS says the app is damaged. Mac exports haven't been tested on a Mac yet.

#Web

Upload the zip to itch.io as an HTML game. Browsers won't run the game from a double-clicked file, so it needs to be on a website.

#When it's done

A finished export ends with Your game is ready! It shows:

• the game's name;
• its folder, with Open folder;
• a poster: the World view as you left it, framed with the game's title and subtitle.

The poster is saved next to the game as <Name>-poster.png, with dashes instead of spaces, such as Sample-Village-poster.png. It's handy for a store page. Set the title and subtitle in Game Settings ▸ Basics.

#Sharing your game

For Windows players, zip up the export folder and send it, or upload it to a site like itch.io. Players unzip it and run the .exe.

Things to know:

• Saved games are kept on the player's PC, not in the game folder.
• Saves are encrypted, so players can't edit them in a text editor to give themselves extra coins. This stops casual editing, not someone determined to take the game apart.
• The debug keys you use when playing from the editor, such as F3 and F4, aren't in exported games.
• Players set their own volume, fullscreen, mouse sensitivity and keys in Options.

#Graphics

Game Settings ▸ Graphics has two levels. Standard runs on almost any PC. Enhanced looks better on newer graphics cards, and an Enhanced game falls back to Standard on PCs that can't run it. See Game settings.

#Exporting models and music

You can also export pieces of your project to reuse elsewhere:

• File ▸ Export Model saves a model as .vox, .obj, .glb or a .png picture.
• Right-click a prefab ▸ Export… saves it as a .vgmprefab file that any project can import.
• Music Gen ▸ Export… saves a song as a .vgmsong file, or as a .wav.