Setup guide

Link up to 4 kingdoms

Onyx can scan more than one kingdom at the same time, each with its own alerts and commands. Here is exactly how to set it up, step by step.

Watch first

Video walkthrough

Two short walkthroughs, one for each platform. Pick the one you use.

On Telegram

On Discord

The idea

How multi-kingdom scanning works

Your plan sets how many kingdoms Onyx can scan at once. One kingdom is your primary, set with /move in your main group. Every extra kingdom is linked to its own place: a Discord channel, a Telegram topic, or a separate Telegram group. That way each kingdom's alerts and commands stay separate and never mix.

Primary
K212
Your main group
Linked
K213
Channel, topic, or group 2
Linked
K214
Channel, topic, or group 3
Linked
K215
Channel, topic, or group 4

Kingdom limit by plan: Lite = 1  ·  2× = 2  ·  3× = 3  ·  4× = 4

Step by step

How to link a kingdom

The method you use depends on where the kingdom's alerts should go. A Discord channel or a Telegram topic uses Method A. A separate Telegram group uses Method B.

Method A

Discord channel or Telegram topic

Use this when the kingdom's alerts go to a Discord channel in the same server, or a Topic inside your main Telegram group. The bot already knows it is the same server or group, so you run the command right there with no IDs.

1

Set your primary kingdom

In your main group, pick the kingdom Onyx scans by default.

/move 212 ✅ Kingdom set to K212
2

Open the destination

On Discord, make a new channel in your server. On Telegram, turn on Topics in your main group and add a new topic. Make sure the Onyx bot is there.

3

Run /movelink right there

Inside that channel or topic, link the kingdom. Its alerts and commands now arrive here.

/movelink 213 ✅ K213 alerts and commands now come here.
4

Repeat for each extra kingdom

One channel or topic per kingdom, up to your plan's limit. On 4× that is four kingdoms in total.

Method B

A separate Telegram group

On Telegram, a completely separate group does not work with Method A, because the bot cannot tie a different group to your setup on its own. Give it the group's chat ID instead.

1

Get the group's chat ID

In the separate group, with the Onyx bot added, run /chat.

/chat 🆔 This chat's ID: -1001234567890
2

Link it from your main group

Pass the chat ID and the kingdom number together. Now K213's alerts go to that group.

/movelink -1001234567890 213 ✅ K213 linked.
Quick rule. Same server or same group (a Discord channel, or a Telegram topic) uses Method A. A different Telegram group uses Method B with /chat and the chat ID.

Manage

Check and remove kingdoms

/links

List everything you are scanning: your primary 👑 and linked 🔗 kingdoms, for example "🗺 Your Kingdoms (2 of 3)". Alias: /kingdoms.

/unlink 213

Remove a single linked kingdom. Your primary cannot be unlinked. Group admins only.

/unlinkall

Remove every linked kingdom and keep only your primary. Alias: /clearlinks. Group admins only.

Good to know. Your primary kingdom cannot be unlinked. Change it any time with /move <kingdom>. How many kingdoms you can link at once depends on your plan, and all linking commands are group admins only.
Need more kingdom slots? See plans Full command guide