Compiling your Expansion

🔐 Why Compile to .NXE?

  • Security: Your JavaScript and asset files are encrypted, preventing easy reverse‑engineering.

  • Integrity: Bundles include an authentication tag (AES‑GCM), so corrupted or modified packages fail to load.

  • Convenience: Distribute a single file per Expansion, rather than a folder of multiple files.

  • Expansions Store: Our expansions store only accepts compiled expansions, you won't be able to share through our store without an NXE file.

🚀 Step-by‑Step: nexomaker.compileNxe()

  1. Launch Nexo Maker Make sure the app is running and you can interact with your workspace as usual.

  2. Open Developer Tools Press Ctrl + Shift + I

  3. Switch to the Console Tab Click the “Console” tab to get a JavaScript REPL where you can call internal functions.

  4. Invoke the Compiler In the console prompt, type:

    nexomaker.compileNxe()

    and press Enter.

  5. Verify the .nxe Files Open your Documents/NexoMaker/Expansions folder in your file explorer. You’ll see:

    Folder: AwesomeExpansion
File: MyAwesomeExpansion.nxe
Folder: AnotherTool
File: AnotherTool.nxe

    The .nxe files are what Nexo Maker will prefer and recognize as "Production Version".

🏷️ Loading Order & Fallbacks

  • Production Mode: Nexo Maker gives priority to .nxe files. If both MyExpansion/ and MyExpansion.nxe exist, only the encrypted bundle is loaded.

  • Development Mode: If no .nxe is present, the plain folder loads as before—letting you iterate quickly without re‑packing after every change.

🛠️ Troubleshooting Tips

  • No .nxe Appears: Ensure you ran the console command while the app had write permission to your Documents folder.

  • Invalid Bundle: If you manually create or rename the .nxe from a zip file, its authentication tag will fail and encryption method won't match — simply run nexomaker.compileNxe().

  • Error compiling: To troubleshoot errors, you can run Nexo Maker directly through a CMD to see all backend console logs to find which errors happend through the compilation.

With this process, exporting and securing your Expansions becomes a one‑step operation—letting you focus on building great tools without worrying about source protection or distribution complexity.

PreviousStarting a ExpansionNextModularjs

Last updated