Custom Session IDs: Difference between revisions

From Resonite Wiki
No edit summary
No edit summary
Line 1: Line 1:
Custom Session Ids are a custom format for regular [[Session IDs]], that can be easier to remember and work with.
Custom Session Ids are a custom format for regular [[Session IDs]], that can be easier to remember and work with.
== Benefits ==
Custom Session Ids are
* Static
** Unlike regular session ids which have randomized elements, custom session ids are static. This lets you use them in other configuration items without needing to update them each time the session re-starts.
* Automatic
** When used with the <code>ressession://</code> url format, things like IP Addresses and ports are automatically resolved.


== Format ==
== Format ==
Line 36: Line 43:
** The [[ProtoFlux:Open World]] node.
** The [[ProtoFlux:Open World]] node.
** The [[ProtoFlux:Focus World]] node.
** The [[ProtoFlux:Focus World]] node.
* The [[Component:WorldLink]] component
* The [[Component:WorldLink]] component.
* As a uri for a <code>autoJoinSessions</code> item within the [[Startup Config File]]
* As a uri for a <code>autoJoinSessions</code> item within the [[Startup Config File]].
 
When using it with the above methods, you'll need to ensure that it is used within a valid session url, there are a number of options:
# Use an LNL URL
#* For Example <code>lnl-nat://aba6f27b-c51c-49ba-ac03-0bcc96cd97cc/S-U-ProbablePrime:CheeseLand</code>.
# Use a <code>ressession</code> url
#* For Example <code>ressession:///S-U-ProbablePrime:CheeseLand</code>

Revision as of 05:47, 28 September 2024

Custom Session Ids are a custom format for regular Session IDs, that can be easier to remember and work with.

Benefits

Custom Session Ids are

  • Static
    • Unlike regular session ids which have randomized elements, custom session ids are static. This lets you use them in other configuration items without needing to update them each time the session re-starts.
  • Automatic
    • When used with the ressession:// url format, things like IP Addresses and ports are automatically resolved.

Format

Custom Session Ids, have 3 Components.

S-<User Id or Group Id>:<custom text>

  • The S- this is automatically added when setting a custom session id, but must be supplied when using a custom session id.
  • A user id or group ID
    • E.g. U-ProbablePrime for a User ID
    • E.g. G-Cheese for a Group ID
  • The custom text portion can be anything you'd like, but there are some restrictions.
    • Only Alphanumeric Characters, Dash(-) and Underscore(_) can be used.

Combining everything together a full custom session Id example would be: S-U-ProbablePrime:CheeseLand.

Setting a Custom Session Id

In the Headless Server Software configuration

Remember to not include S- in this configuration file.

Within the Headless Server Software/Configuration_File startWorlds configuration. For example:

... other properties ...
"startWorlds":[
{
  ... other properties ...
  "customSessionId":"U-ProbablePrime:CheeseLand"
  ... other properties ...
}]

Using a Custom Session Id

You can use a custom session id, anywhere that expects a session Id, examples include:

When using it with the above methods, you'll need to ensure that it is used within a valid session url, there are a number of options:

  1. Use an LNL URL
    • For Example lnl-nat://aba6f27b-c51c-49ba-ac03-0bcc96cd97cc/S-U-ProbablePrime:CheeseLand.
  2. Use a ressession url
    • For Example ressession:///S-U-ProbablePrime:CheeseLand