View source for Headless Server Software/Loading a Specific World/en

<languages/>
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|Group's]] Inventory
** This option is the easiest, but does require a [[Groups|Group]]

=== User's inventory ===
# Setup your world as per normal
# Save your world to your inventory
# Spawn a world orb of the world and click on it
# Select "Edit Meta-Data"
# Ensure "Who can open this world?" is set to "Anyone"
[[File:WorldAccessAnyone.png|Screenshot of the world meta-data screen showing "Anyone" selected under "Who can open this world?"]]
# Click save
# Wait for your Sync status to say "All Synced"

=== Group's inventory ===
# Setup your world as per normal
# Save your world to your Group's Inventory
# Ensure that the Headless User is a member of your target Group
# 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:
# Select the world in the World Browser
# Click the Right Arrow in the top right of the world preview. This will open an expanded world dialog.
# Click "Copy Record URL"

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

<code>resrec:///GROUP OR USER ID/WORLD RECORD ID</code>

== 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 <code>loadWorldURL</code> property of a world.

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}}