Prerequisites
- An XCS account with an organization created
- Owner or Admin role in that organization
Create a Location
Download the Starter Kit
Once your location is created, open its Settings page. You will see a Download kit button. Clicking this button downloads astarter-kit.rbxmx file — a pre-configured Roblox place file that includes:
- XCS integration code — The stock XCS package
- Auto-generated API key — A new organization API key is created and pre-configured into the file, no manual configuration is needed
- Your location ID — Pre-configured into the code, no manual configuration is needed
Using the Starter Kit
- Open the downloaded
.rbxmxfile in Roblox Studio. - Review the included scripts and configuration in
ServerScriptService. - Publish the place to your Roblox experience, or merge the relevant scripts into your existing place.
- Your game server will now automatically subscribe to unlock commands from XCS.
The starter kit handles the MessagingService subscription and acknowledgment
system automatically. If you prefer to implement the integration manually, see
the Remote Unlock Setup guide.
Add Access Points
Once your location and starter kit are set up, you can add access points — doors, gates, or checkpoints that XCS controls.- From your location’s page, go to the Access Points section and click “Create Access Point.”
- Give it a name (e.g., “Main Gate”, “VIP Room”).
- Add access rules by assigning access groups or specific identities.
- Copy the access point’s ID from its dashboard page.
- In Roblox Studio, open the reader model’s configuration script and set
accessPointIdto the ID you copied. The reader will then enforce the rules you’ve configured.
The stock XCS package comes with a built-in reader model that handles scanning and
access evaluation in-game.
Configure Remote Unlock (Optional)
If you want to use the remote unlock feature, you’ll also need to configure your Roblox Open Cloud credentials in the location settings. See Remote Unlock Setup for detailed steps.Next Steps
- Add access points and rules to your location
- Try remote unlocking from the dashboard or API
- Invite members to your organization to manage the location together

