We value your privacy. We use cookies to enhance your experience on our site. By using this site you agree to our Privacy Policy.

WonderlandEditor CLI

To allow packaging project on Continuous Integration and to allow developers a even more efficient workflow, the Wonderland Editor provides a Command Line Interface (CLI).

WonderlandEditor 

The main WonderlandEditor executable contains UI as well as CLI functionality. It is located in the bin/ folder of your installation.

CLI Arguments 

 1WonderlandEditor [--magnum-...] [-h|--help] [--project PROJECT] [--version] [--windowless] [-p|--package] [--create] [-b|--benchmark BENCHMARK] [--client-platform CLIENT_PLATFORM] [--browser BROWSER] [-o|--output OUTPUT] [-s|--server] [-w|--watch] [--accept-eula] [--credentials CREDENTIALS] [--preferences PREFERENCES] [--import IMPORT] [--config CONFIG] [--enable-plugins] [--inspect-brk]
 2
 3Arguments:
 4  -h, --help                  display this help message and exit
 5  --project PROJECT           Project to load at startup
 6  --version                   Print version information and terminate
 7  --windowless                Use the editor without window (e.g. for automated builds)
 8  -p, --package               Package the project
 9  --create                    Create a new project if it does not exist.
10  -b, --benchmark BENCHMARK   Run benchmark with given config file
11  --client-platform CLIENT_PLATFORM  The target client platform to run the app on
12                              (default: desktop)
13  --browser BROWSER           The target browser to run the app on
14                              (default: default)
15  -o, --output OUTPUT         Package project to given destination
16  -s, --server                Start the web server
17  -w, --watch                 Watch JavaScript files
18  --accept-eula               Automatically accept the EULA. By using this you agree with the terms in the EULA
19  --credentials CREDENTIALS   Credentials
20                              (environment: WLE_CREDENTIALS)
21  --preferences PREFERENCES   Path to a preferences.json file to override default
22  --import IMPORT             Import a scene
23  --config CONFIG             Path to the packaging configuration file
24  --enable-plugins            Enable plugin execution.
25  --inspect-brk               Launch with node inspector and wait for it to attach

Examples 

Here are some useful commands to automate some workflows:

Package Your Project via CLI 

1WonderlandEditor --windowless --project MyProject.wlp --package

Coding Without the Editor 

1WonderlandEditor --windowless --project MyProject.wlp --server --watch

Convert a Scene To Streamable .bin 

To convert a scene file (e.g. a GLTF file) into a streamable .bin file, create an empty project Streamable.wlp and enable Views > Project Settings > packageForStreaming.

Now you can use the following command to convert a GLTF file:

1WonderlandEditor --windowless --project Streamable.wlp --package --import my-scene.glb
2mv deploy/Streamable.bin my-scene.bin

On windows, use move instead of mv.