|
|
| (21 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| <!--T:1-->
| |
| Headless Clients are versions of Resonite that lack a graphical user interface, allowing them to run efficiently in scenarios where rendering is not needed (such as when used as a server). It is common to use a Headless Client to run events or servers for large volume applications within Resonite. Headless Clients can run on Windows and Linux servers wherever they may be, including your own computer.
| |
|
| |
|
| == Access to Headless Client Builds == <!--T:2-->
| | At the Discoverer, [[Patreon]] tier and above. You'll gain access to our Headless Server Software. |
| You will need to be a member of the Resonite Patreon at the Discoverer level or higher to gain access to the Headless Client Builds. Once this is done, send the command "/headlessCode" to the Resonite bot in-game to receive the password for the Headless beta on Steam.
| |
|
| |
|
| == Getting the Headless Client Files == <!--T:3-->
| | The Headless Server Software is a version of Resonite that lacks a graphical user interface, allowing it to run efficiently in scenarios where rendering is not needed. It is common to use this software to run events or sessions for larger communities or events. |
| There are two options for getting the files required to run a headless client:
| |
| # Using Steam's Graphical Interface
| |
| # Using Steam's Command Line Interface - Common for within Docker files and Linux servers.
| |
|
| |
|
| === Using Steam's Graphical Interface === <!--T:4-->
| | You can run the software on Windows and Linux. |
|
| |
|
| <!--T:5-->
| | == Terminology == |
| # Open Steam
| | We have some overloaded terminology in this area so for clarity, the following items essentially mean the same thing: |
| # Find Resonite in your Installed Games list
| | * Headless Server Software |
| # Right Click Resonite and select "Properties"
| | * Headless Server |
| # Click the "Betas" option in the window which appears
| | * Headless Client |
| # Enter your code from Resonite bot into the "beta access code" field.
| | * Headless |
| # This will grant you access to the headless-client build.
| |
| # Switch to the headless-client build
| |
|
| |
|
| === Using Steam's Command Line Interface === <!--T:6--> | | == Hosting == |
| # [https://developer.valvesoftware.com/wiki/SteamCMD install SteamCMD]
| | Headless Servers created using the Headless Server Software are hosted by '''You''', we do not host them for you. |
| # Run Steam CMD with: <code>steamcmd</code>
| |
| # Paste the following command into SteamCMD: <code>app_update 2519830 -beta headless -betapassword <beta access code></code>
| |
|
| |
|
| == Running a Headless Client == <!--T:7-->
| | In the future, Resonite does intend to explore offering hosted sessions that are operated and hosted by Resonite. |
| First, look for the files you've installed. Look for Resonite.exe:
| |
| * For SteamCMD it will be in the location which you downloaded the files to with SteamCMD
| |
| * For Steam's GUI it will be in the regular Steam installation folder for Resonite inside a folder called "Headless"
| |
|
| |
|
| <!--T:8-->
| | == Guides == |
| Once you've found them you can try running the "Resonite.exe" file in there:
| | * [[Headless Server Software/Setup|Setup a Headless]] - How to setup a headless for the first time |
| * For Windows just double click it | | * [[Headless Server Software/Managing Worlds|Managing Worlds]] - Guidance on world management with a headless. |
| * For Linux you'll need mono: <code>mono Resonite.exe</code>
| | * [[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 |
| <!--T:9-->
| | * [[Headless Server Software/Commands|Commands]] - Learn about Headless Commands |
| This will run a default Resonite Headless, as we haven't specified any configuration properties it will just open a default world using a non-logged in user. This isn't that useful but it does verify that everything is installed and setup correctly. After it starts up you should see "World Running" and something along the lines of "<your computers name> World 0>_".
| | * [[Headless Server Software/Troubleshooting|Troubleshooting]] - A guide for troubleshooting Headless issues. |
| | | * [[Headless Server Software/Loading a Specific World|Loading a specific world]] - A guide for loading a specific world. |
| <!--T:10-->
| | * [[Headless Server Software/Migration | Migrating to .NET 8]] - Migrating the Headless to .NET 8 |
| If you see this, you're good to go!
| |
| | |
| <!--T:15-->
| |
| '''You've got a running Headless Client. You'll probably want to create a [[Headless Client/Configuration File|Configuration File]] next.'''
| |
| | |
| == Saving Headless Worlds == <!--T:11-->
| |
| | |
| <!--T:16-->
| |
| When you're running a headless client, you may wish to save changes to the world for things like collaborative building. When doing this keep in mind:
| |
| | |
| <!--T:17-->
| |
| # You must have save access to the world you are trying to save.
| |
| #* Simply loading someone else's world via your [[Headless_Client/Configuration_File|configuration file]] might not give you this permissions.
| |
| # Saving must be configured or invoked, saving is not automatic.
| |
| #* Check the parameters with "save" in them on our [[Headless_Client/Configuration_File|configuration file]] page.
| |
| #* Also see [[Headless_Client/Commands|the headless commands reference]] for how to invoke a save.
| |
| # For Cloud saving ([[Headless_Client/Configuration_File##SaveAsOwner|saveAsOwner:"CloudUser"]]), you must:
| |
| #* Ensure the headless is logged into a user account
| |
| #* Ensure the logged in user has cloud storage space for the world and any changes
| |
| | |
| <!--T:18-->
| |
| For a smooth experience '''if you want to save a world from a headless''' it is recommended to:
| |
| * Copy worlds you might want to save changes to, to the headless user's account using Save As
| |
| ** You'll need to log in as the headless user on regular Resonite to do this
| |
| * Utilize [[Groups]], and load the headless world from a group's storage
| |
| ** This let's your group work on and save a headless' world without interacting with the headless. The next time it restarts it'll pickup the changes from the group storage.
| |
| ** When doing this make sure to disable saving on the headless, make all changes outside it.
| |
| * Experiment: Create a headless, add a cube to the world, save it, make sure the cube stays there. Don't do a lot of work without validating your setup.
| |
| | |
| == See Also == <!--T:14-->
| |
| * [[Headless Client/Configuration File|Configuration File]] - Learn about Headless Configuration Files | |
| * [[Headless Client/Commands|Commands]] - Learn about Headless Commands | |
At the Discoverer, Patreon tier and above. You'll gain access to our Headless Server Software.
The Headless Server Software is a version of Resonite that lacks a graphical user interface, allowing it to run efficiently in scenarios where rendering is not needed. It is common to use this software to run events or sessions for larger communities or events.
You can run the software on Windows and Linux.
Terminology
We have some overloaded terminology in this area so for clarity, the following items essentially mean the same thing:
- Headless Server Software
- Headless Server
- Headless Client
- Headless
Hosting
Headless Servers created using the Headless Server Software are hosted by You, we do not host them for you.
In the future, Resonite does intend to explore offering hosted sessions that are operated and hosted by Resonite.
Guides
