Headless Server Software: Difference between revisions

Latest revision as of 19:53, 19 November 2024

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

Setup a Headless - How to setup a headless for the first time
Managing Worlds - Guidance on world management with a headless.
Docker Setup - Guidance on creating a headless using Docker.
Configuration File - Learn about Headless Configuration Files
Commands - Learn about Headless Commands
Troubleshooting - A guide for troubleshooting Headless issues.
Loading a specific world - A guide for loading a specific world.

Migrations

Migrating to .NET 9 - Migrating the headless to .NET 9
Migrating to .NET 8 - Migrating the Headless to .NET 8

@@ Line 1: / Line 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.
+At the Discoverer, [[Patreon]] tier and above. You'll gain access to our Headless Server Software.
-== Prerequisites ==
+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.
-* Be a Resonite [[Patreon|Patron]] at the Discoverer level or higher.
-* Have a Windows or Linux server or machine ready to go
-=== Windows Prerequisites ===
+You can run the software on Windows and Linux.
-* [https://dotnet.microsoft.com/en-us/download/dotnet-framework/net462 .NET Framework 4.6.2]
-=== Linux Prerequisites ===
+== Terminology ==
-* Mono (mono-complete)
+We have some overloaded terminology in this area so for clarity, the following items essentially mean the same thing:
-** You can find instructions on [https://www.mono-project.com/download/stable/#download-lin-ubuntu Mono's website]
+* Headless Server Software
-** Follow instructions for the <code>mono-complete</code> package
+* Headless Server
-* steamcmd
+* Headless Client
-** You can find instructions on the [https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Valve Software Wiki].
+* Headless
-== Access to Headless client builds ==
+== Hosting ==
-To gain access to the Headless client you will need a headless steam beta code:
+Headless Servers created using the Headless Server Software are hosted by '''You''', we do not host them for you.
-* Send <code>/headlessCode</code> to the [[Resonite Bot | Resonite bot]] in-game.
-* You'll get a headless beta code for steam. With this in hand you need to proceed to getting the files.
-== Getting the Headless client files ==
+In the future, Resonite does intend to explore offering hosted sessions that are operated and hosted by Resonite.
-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 ===
+== Guides ==
+* [[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.
+* [[Headless Server Software/Loading a Specific World|Loading a specific world]] - A guide for loading a specific world.
-# Open Steam
+=== Migrations ===
-# Find Resonite in your Installed Games list
+* [[Headless Server Software/Migration_Net9|Migrating to .NET 9]] - Migrating the headless to .NET 9
-# Right Click Resonite and select "Properties"
+* [[Headless Server Software/Migration | Migrating to .NET 8]] - Migrating the Headless to .NET 8
-# Click the "Betas" option in the window which appears
-# Enter your code from Resonite bot into the "beta access code" field.
-# This will grant you access to the headless-client build.
-# Switch to the headless-client build
-=== Using Steam's Command Line Interface ===
-# Run Steam CMD with: <code>steamcmd</code>
-# Run: <code>app_license_request 2519830</code>.
-# Run: <code>app_update 2519830 -beta headless -betapassword <headless beta access code></code>
-== Your first time running a Headless Client ==
-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"
-Once you've found them you can try running the "Resonite.exe" file in there:
-* For Windows, we still recommend a terminal window.
-** Powershell or CMD works well
-** This allows you to see any errors or problems in a much easier way.
-* For Linux you'll need mono: <code>mono Resonite.exe</code>
-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>_".
-If you see this, you're good to go! You've got a running Headless Client. You'll probably want to create a [[Headless Client/Configuration File|Configuration File]] next.
-== See Also == <!--T:14-->
-* [[Headless Client/Managing Worlds|Managing Worlds]] - Guidance on world management with a headless.
-* [[Headless Client/Docker|Docker Setup]] - Guidance on creating a headless using Docker.
-* [[Headless Client/Configuration File|Configuration File]] - Learn about Headless Configuration Files
-* [[Headless Client/Commands|Commands]] - Learn about Headless Commands