Headless Server Software/Loading a Specific World: Difference between revisions

From Resonite Wiki
 
No edit summary
Line 39: Line 39:


An example is available on our [[Headless_Server_Software/Example_Configurations#Minimal_with_Specified_World|example configuration page]].
An example is available on our [[Headless_Server_Software/Example_Configurations#Minimal_with_Specified_World|example configuration page]].
== See Also ==
* [[Headless Server Software/Setup|Setup a Headless]] - How to setup a headless for the first time
* [[Headless Server Software/Managing Worlds|Managing Worlds]] - Guidance on world management with a headless.
* [[Headless Server Software/Docker|Docker Setup]] - Guidance on creating a headless using Docker.
* [[Headless Server Software/Configuration File|Configuration File]] - Learn about Headless Configuration Files
* [[Headless Server Software/Commands|Commands]] - Learn about Headless Commands
* [[Headless Server Software/Troubleshooting|Troubleshooting]] - A guide for troubleshooting Headless issues.
{{FurtherHelp}}

Revision as of 00:31, 2 June 2024

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.

See Also


Further Help

If you need further help then you can: