Export Mod¶

Export packages an editable mod folder into a shippable mod file. Once exported, the mod becomes available in the main game. Export only after the mod has been tested from the in-game editor, making sure all content loads and behaves correctly.

Before Exporting¶

Run Test Mod first. Check that:

The mod opens without missing dependency errors.
Characters load with the correct icon, portrait, sprites, sounds, and behave correctly in all scenarios.
Levels load with the intended art, spawns, walls, music, and cutscenes.

Character color palettes can be tested in editor test mode, including through Hot Reload. Still test the exported package before distributing it.

Don't make changes through the bundled editor tools during the export process.

The exporter builds the playable package in the game's Mods folder. The export screen reports the current step, such as exporting entities, palettes, audio, levels, or scripts. The more content a mod has, the longer it takes to export. Try to keep mods small. Prefer having multiple mods with individual purposes (e.g. reskin, characters pack, new game mode), than a single monolitic mod with everything.

After Exporting¶

Test the exported content in the main game. This catches differences between editable folder loading and packaged loading.

The file in Mods is the package to share. Upload it wherever you prefer, post a download link for other players, or send it directly to friends. New Era does not currently provide hosting for community mods.

Lua scripts are precompiled during export. Keep the game executable updated together with the exporter: older executables cannot read newer bytecode formats. The current loader also repairs the function addresses in exports made with the older format, so those packages do not need to be exported again to use them with the updated game.

Exported OGG music uses Unity's native audio decoder and retains the track's loop points. If an older executable plays WAV music but leaves OGG tracks silent, update the executable; the existing exported OGG files do not need to be converted or exported again.

For netplay, every player must use the same exported version. The game compares the loaded mod checksum, so if you re-export the mod after a change, send the new package to every player.