Setup Guide

Up and running in minutes

Follow these steps to get ControlArk fully configured on your Discord server — from adding the bot to automating your first shop delivery.

01

Add the Bot to Your Server

Invite ControlArk to your Discord server with the correct permissions.

  1. Join the ControlArk Discord and open a ticket in the support channel to request a bot invite link.
  2. Select the Discord server you want to add ControlArk to and authorise the requested permissions.
  3. Once the bot joins, all slash commands are immediately available to server administrators.
🔑

Required permissions: Send Messages, Embed Links, Use Application Commands, Read Message History, Create Public Threads, Send Messages in Threads, Manage Messages, Attach Files, and Manage Channels (for setting up log forums). The bot also needs to be able to DM members for shop order notifications.

02

Connect Your Nitrado Account

ControlArk accesses your ARK servers through a Nitrado Long-Life Token — no FTP clients or manual file downloads required.

  1. Go to server.nitrado.net and navigate to Developer Portal → Long Life Tokens.
  2. Create a new token and enable the service and user_info scopes. No other scopes are needed.
  3. Copy the token — you will only see it once at creation time.
  4. In Discord, run /configurate and select Connections.
  5. Click Add and paste your token when the bot prompts you.
  6. ControlArk will verify the token and automatically detect all ARK game services on your Nitrado account.
⚠️

Never share your token. It grants full API access to your Nitrado services. You can revoke it from the Nitrado Developer Portal at any time. If your servers are on a different Nitrado account than the one you logged into, connect that account's token instead. Up to 3 Nitrado connections are supported per Discord server.

03

Configure Features

Run /configurate to open the main configuration menu and enable the features your server needs.

Every feature is configured through Discord slash commands — no config files, no restarts. The /configurate menu has 12 sections. Enable only the ones you need.

📋
Server Log Streaming

Select a parent Discord category and the bot creates forum channels for each ARK server, automatically streaming chat, kills, tribe events, admin commands, and join/leave logs into separate threads.

🔍
Detection Systems

Enable any of the 6 detection systems — alt accounts, admin command monitoring, explorer notes, illegal player names, name spoofing, and chat keyword filter. Each gets its own alert channel.

🦖
Dino & Player Tracking

Set stat thresholds for wild creature species via /track dinosaur — alerts fire when a qualifying dino is spotted. Use /track player to monitor specific players across all servers.

📊
Live Player List

Pick a Discord channel and select up to 30 servers. The bot posts a live, auto-refreshing list showing every online player across your cluster — updated every 5 minutes.

📝
Command Logging

Set dedicated Discord channels to receive a log of every admin command, player ban, and server management action taken through the bot. Useful for audit trails.

🔒
Permissions

Grant specific Discord users access to individual bot feature groups — bans, player lookup, server management, shop, and more — without giving them Discord Administrator.

04

Set Up the Ingame Shop

Enable the shop, designate a delivery server, build your packs on the dashboard, and credits will flow automatically.

4a
Enable the shop & pick a delivery server

Run /configurate and select Ingame Shop. Enable it, then choose a dedicated PVE server to act as the delivery server. This server is used solely for item delivery rooms — it should not have active player progress as it gets restored after each delivery cycle.

4b
Set delivery intervals

In the same menu, configure how often orders are assigned rooms (default: every 10 minutes) and how often items are physically delivered (default: every 3 hours). These can be adjusted at any time.

4c
Build packs on the dashboard

Log in at controlark.net → your server → Shop → Packs. Click New Pack and use the pack builder to add items, set quantities, quality tiers, blueprint variants, creatures (with gender and stats), costumes, and credit pricing. Organise packs into categories for your public store.

4d
Give players credits

Use /credits give @user <amount> to give players credits to spend in the shop. Credits are also awarded automatically via the playtime reward system. Players can check their balance with /credits balance and view their history with /credits history.

🚚

Once a player places an order, a delivery room is automatically assigned and they receive a Discord DM with the room number and PIN code. Items are then placed directly into the room vault on the delivery schedule — no admin involvement needed at any step.

Stuck or have questions?

Join the Discord — we're active and happy to help with any part of the setup.