Marketplace Installs

Marketplace Installs

The Marketplace allows you to install and manage extensions for Skyreal VR and Unreal experiences. This guide covers setup for both server and standalone solutions.

Prerequisites

• XR Center must be installed on the server device (for server solution).

Marketplace Configuration

The Marketplace configuration is set up by default in XR Center, Deck Standalone, and all client apps. You can customize the settings by modifying the configuration files.

XR Center and Deck Standalone Settings

Example — XR Center configuration:

"MarketplaceSettings": {
    "ScanDirectoryPath": "C:\\.skrpackages\\ScanDirectory",
    "PackageArchivesDirectoryPath": "%programdata%\\Skydea\\xrcenter\\packages",
    "ScanNewPackages": true
}

Example — Deck Standalone configuration:

"StandaloneXRCenterSettings": {
    "MarketplaceSettings": {
        "ScanDirectoryPath": "C:\\.skrpackages\\ScanDirectory",
        "PackageArchivesDirectoryPath": "%programdata%\\Skydea\\xrcenter\\packages",
        "ScanNewPackages": true
    }
}

Client Apps Settings (Deck, PrepAgent, CollabAgent)

To use extensions stored in XR Center, configure the PackagesDirectoryPath in each client application configuration file:

"PackagesDirectoryPath": "C:\\.skrpackages\\Packages"

Installation Steps

Server Solution

1. Ensure XR Center is installed (version 1.21 or higher) and the service is running.

2. Configure your XR Center with the Marketplace settings (see above).

3. For each extension you want to install, open the installer:

[IMAGE: Marketplace installer dialog — original at /pictures/v1.21/maketplace_installer.png]

• Choose the Marketplace flow to automatically upload the extension to XR Center.

• Choose the Legacy flow to install the extension locally on your machine only.

• If the Marketplace button is greyed out, there was an issue with the XR Center service installation.

• Once installed, the extension is available in XR Center for use in your experiences.

Note: If you are using a SkyPrepAgent, ensure the agent plugins are installed and the package cache path is configured correctly in the agent configuration file. The agent will not start correctly until all necessary plugins are available on XR Center.

Standalone Solution

1. Ensure Deck Standalone is installed on your device.

2. Navigate to the Deck configuration location (default: C:\\ProgramData\\Skr\\1.21\\deck) and open deck.json. The Marketplace is enabled by default.

3. To install extensions:

   • Open Deck and navigate to your standalone workspace.

   • Copy the zipped extension files into the Scan Directory created by Deck.

   • Restart Deck — it will automatically scan the directory and install the extensions.

Every time you want to install a new extension, copy the zipped file into the Scan Directory and restart the server (XR Center or Deck Standalone). The server monitors the Scan Directory and automatically deletes packages after upload.

Legacy Installation Flow

If you prefer the legacy installation flow, extensions installed this way will be used at every Skyreal VR launch. However, if you launch an experience that uses the Marketplace, it will skip legacy extensions and use the Marketplace extensions instead.

1. Download the extension package.

2. Launch the installer and select the Legacy installation flow.

3. Follow the prompts to complete the installation.

Troubleshooting

• Check XR Center Status: Ensure the XR Center service is running and accessible.

• Verify Configuration: Double-check that scan and cache paths are correct.

• Check Scan Directory: Ensure the ScanDirectoryPath exists on your server or standalone device.

• Permissions: Ensure XR Center or Deck has read access to ScanDirectoryPath and write access to PackagesDirectoryPath.

• Logs: Check the logs in XR Center or Deck for error messages related to package scanning or installation.