> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexocorporation.pl/llms.txt
> Use this file to discover all available pages before exploring further.

# NexoSessions

> NexoSessions is a new, improved, and refreshed version of old NexoSessions Version. It features integration capabilities with services such as Hyra, SeriesHR, and Planetary. You can freely customize the UI to suit your needs, set your preferred time zone, adjust the refresh interval, and more.

#### NexoSessions is a new, improved, and refreshed version of old NexoSessions Version. It features integration capabilities with services such as **Hyra, SeriesHR, and Planetary.** **You can freely customize the UI to suit your needs, set your preferred time zone, adjust the refresh interval, and more**.

<Info>
  Information how to Ungroup model you can Find [HERE](https://www.youtube.com/watch?v=cXsn8-FX_PE).
</Info>

<Steps>
  <Step title="Download NexoSessions file from [Vault](https://vaultroblox.com/navigator/licenses)" />

  <Step title="Put Downloaded file to your Game at Roblox Studio">
    Go to the Downloads folder, select the **NexoSessions.rbxm** file and press **Ctrl+C**, then go to Roblox Studio and press **Ctrl+V.**
  </Step>

  <Step title="Select NexoSessions | UNGROUP ME and click CTRL+U">
    Select **NexoSessions | UNGROUP ME** and click **CTRL+U** and then remove "**DELETEME**" model.
  </Step>

  <Step title="Ungroup &#x22;UNGROUPME&#x22; model (CTRL+U)">
    Ungroup "UNGROUPME" model use CTRL+U or Left-click while this model is selected and choose "**Ungroup**".
  </Step>

  <Step title="Delete the &#x22;DELETEME&#x22; model">
    Delete the "DELETEME" model - If you need it for anything, keep it.
  </Step>

  <Step title="Go to NexoPOS | NexoSessions > Loader > Configuration">
    <u>You can have </u>`Enabled = true`<u> set for only ONE service—for example, Hyra—while the others must be set to </u>`Enabled = false`<u>. This is very important.</u>

    Example Configuration:

    ```luau theme={null}
    local Configuration = {}

    Configuration.Hyra = {
    	Enabled = false,
    	WorkspaceID = "",
    	APIKey = "", -- Change to your APIKey
    }

    Configuration.SeriesHR = {
    	Enabled = false,
    	APIKey = "series_xxxxxxxxxxxxxxxxxxxxxxx", -- Change to your APIKey
    }

    Configuration.Planetary = {
    	Enabled = true,
    	InstanceURL = "https://instance.planetaryapp.cloud", 
    	WorkspaceID = "", -- Roblox Group ID set in Planetary
    	APIKey = "orbit_xxxxxxxxxxxxxxxxxxxx", -- Change to your APIKey
    }

    --============================================= CUSTOMIZATION =============================================--
    Configuration.refreshTime = "60" -- In seconds. This board will refresh at the set interval.
    Configuration.background = "rbxassetid://4561557527" -- For example rbxassetid://4561557527 .
    Configuration.upText = "Upcoming Sessions" -- For example "Upcoming Trainings".
    Configuration.timezone = "CEST" -- Only WET, CET, CEST, EET, EEST.

    return Configuration
    ```

    You can find information on how to locate API key data in the documentation for the specific service.
  </Step>

  <Step title="Done - Place the Screens where you want" />
</Steps>

List of all errors in Output:

| Error Name                                                                     | Explanation of the error                                                                                                                                                         |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \[NexoSessions] Failed to load Configuration                                   | There is an issue with the Loader. Please contact our Support team.                                                                                                              |
| \[NexoSessions] Configuration error: only one session provider can be enabled. | Only one service—for example, Hyra—can have `Enabled = true` in the configuration module. If, for instance, both SeriesHR and Hyra are enabled simultaneously, it will not work. |
| \[NexoSessions] Configuration error: no session provider is enabled.           | At least one service must be Enabled = true.                                                                                                                                     |
| \[NexoSessions] Configuration error: Hyra WorkspaceID is missing.              | The Hyra WorkspaceID is missing from the Configuration module.                                                                                                                   |
| \[NexoSessions] Configuration error: Hyra APIKey is missing.                   | The Hyra APIKey is missing from the Configuration module.                                                                                                                        |
| \[NexoSessions] Configuration error: SeriesHR APIKey is missing.               | The SeriesHR APIKey is missing from the Configuration module.                                                                                                                    |
| \[NexoSessions] Configuration error: Planetary InstanceURL is missing.         | The Planetary InstanceURL is missing from the Configuration module.                                                                                                              |
| \[NexoSessions] Configuration error: Planetary WorkspaceID is missing.         | The Planetary WorkspaceID is missing from the Configuration module.                                                                                                              |
| \[NexoSessions] Configuration error: Planetary APIKey is missing.              | The Planetary APIKey is missing from the Configuration module.                                                                                                                   |
| \[NexoSessions] Avatar failed: USER\_ID                                        | The game cannot load the Session Host Avatar. It is likely an issue with Roblox.                                                                                                 |
| \[NexoSessions] Update failed: ...                                             | Failed to refresh sessions for the given service. Likely an issue with Loader – Please contact our Support team.                                                                 |

<Tip>
  Do you have a problem, a suggestion, or anything else? <br />Contact us on our [communication server](https://discord.gg/mHXvV46brH).
</Tip>