View Categories

How to Work With Multiple Locations

2 min read

The XR4ED shop cannot handle projects with multiple locations on its own. This is due to 2 factors

  • the ids of items in the store change whenever you create an update. So, uploading a new vrml file would break the references of other locations which reference this vrml link
  • the ids of the vrml files are decided when the vrml file uploads, so the Change Location Node cannot know the ids of the other locations.

To be clear, after exporting your project to the shop, all the vrml files you created contain correct references to their corresponding location description files (ending in .wbz). So, you could download these vrml files to e.g. put them on your desktop and launch any location in the hopper by double-clicking the vrml file. But you could not use a Change Location Node to reference another location from within this location, because you don’t know it’s name (link) in the shop.

To get around this dilemma (only applies to projects with multiple locations), you need a tiny bit of space on any external server.

Step 1: edit your project so that all Change Location Nodes use external references to your server/folder. For instance to HTTP://MyDomain.web/MyFolder/location2.vrml.

Step 2: Upload your project as usual including all locations

Step 3: then, download all the vrml files from the shop and copy them to your server/domain. In this example the domain is MyDomain.web and you have some space there in a folder called MyFolder.

Step 4 (optional): you delete all the vrml files in the shop except the vrml file which represents the start location, so the shop only offers one entry point to your project. This prevents that the user who bought your app hops directly into your 2nd location before finishing the first

Step 5: you upload all vrml files onto your server at MyDomain.web/MyProject. The Change Location Node already references the vrml file at this location and not the shop. Thus, the Portal Hopper will download the vrml files for each location from your server and the location description files from the XR4ED Shop.