Skip to content

Getting started

Installing the addon

The MaxWhwere Blender Exporter addon can be downloaded here. The downloaded io_b2mw.zip can be installed the same way as any other blender addon. The whole .zip file should be used, without extracting it.

If you are not familiar with the addon installing process, please refer to this page of the blender user manual.

Clearing the old version

If a previous version of the addon was installed to Blender and it was later removed to install the new one, sometimes the previous addon is not removed correctly by Blender's addon manager. If there is some unexplained behavior shown by the addon, that is probably the reason. In this case, after uninstalling the addon again, you should run the MaxWhere Blender Exporter's clearing script which can be found in the .zip file of the addon under the name of b2mw_clear.bat.

Creating, exporting, and testing your first MaxWhere space

This section will show you the step-by-step process of creating your first MaxWhere space in Blender, as well as exporting it to and testing it in MaxWhere, by a very simple example.

Creating the Blender scene to be exported

Let us create a new file in Blender. In a new default Blender file, the Scene Collection contains a Camera, a Point Light, and a Cube mesh object.

The default Blender cube comes with its default texture map and material. For our simple example that will be sufficient.

Default Blender scene

Let us add a webtable to the scene. Choose Add->MaxWhere->Webtable at the 3D Viewport header menu.

Add webtable

The "Webtable" operator panel appears. If you expand the dialog:

  • The Align, Location X/Y/Z, and Rotation X/Y/Z values will not have any effect on the webtable.
  • You can choose a preset size and resolution, but by default the resolution is calculated automatically (autoresolution option) and you can resize the webtable in object mode.

Click on Webtable_1 in the Outliner. The operator panel disappears.

Fort detailed information on webtable creation and handling in Blender please refer to this page.

Add webtable

Open the 3d Viewport Sidebar and move the webtable to (-2, -1, 1) and rotate it around X and Z axes, each 90°.

Webtable pose settings

Now that we have an adequate scene, let us export it.

Exporting the Blender scene

For saving your Blender scene as a MaxWhere space select File->Export-> Maxwhere(.jsx, .json, .mesh, .obj, .material). Example export

Default settings fit most cases, as well as our example. Choose a name and location to save for your MaxWhere space and press the Export MaxWhere button. A folder will be saved with the chosen name. In this example, we choose the name simple_test.

Example export settings

The exported simple_test folder has the following structure:

Where space structure

The exported mesh elements, textures, etc. are in the resources folder.

Loading the result into MaxWhere

The resulting structure can be loaded in MaxWhere for debugging. After starting MaxWhere, in the 3d Browser press Shift+Ctrl+Alt+D and choose the exported folder to load.

Open folder for debugging in MaxWhere

The exported scene is opened in MaxWhere.

Test in MaxWhere

As we said, this is a pretty simple example, meant for merely demonstrating the scene creation and export process. For detailed settings and advanced export options please browse our documentation pages.