Headless Server Software/Loading a Specific World

From Resonite Wiki

A common goal for [[Headless Server Software|Headlesses] is to load a specific world on start-up. This article guides you through doing that with the goal of as much success as possible.

Preparing the World for a Headless

The first step is also the most important for success, we need to ensure the world is ready for a Headless. The steps required for this depend on where the world will be stored.

  • Using User's Inventory
  • Using a Group's Inventory
    • This option is the easiest, but does require a Group

User's inventory

  1. Setup your world as per normal
  2. Save your world to your inventory
  3. Spawn a world orb of the world and click on it
  4. Select "Edit Meta-Data"
  5. Ensure "Who can open this world?" is set to "Anyone"

Screenshot of the world meta-data screen showing "Anyone" selected under "Who can open this world?"

  1. Click save
  2. Wait for your Sync status to say "All Synced"

Group's inventory

  1. Setup your world as per normal
  2. Save your world to your Group's Inventory
  3. Ensure that the Headless User is a member of your target Group
  4. Wait for your Sync status to say "All Synced"

Getting the Record URL

The next step is ensuring that you have the correct url. There are a variety of world urls available and for Headlesses you need the "Record Url".

To get this:

  1. Select the world in the World Browser
  2. Click the Right Arrow in the top right of the world preview. This will open an expanded world dialog.
  3. Click "Copy Record URL"

If you want to check if the URL is correct, ensure that it starts with resrec:///, it should also have your user id, or group id as the first part of the URL.

resrec:///GROUP OR USER ID/WORLD RECORD ID

Adding the Record URL to the configuration

Once you have the Record URL, you just need to add it to the Headless Server Software/Configuration File, in the loadWorldURL property of a world.

An example is available on our example configuration page.