How to configure RoyalKillFeed

1. Before you start

• The RoyalKillFeed bot must already be in your Discord server with permission to read/send messages, embed links, and manage messages in feed channels (for pinned guides).
• Your DayZ server must be on Nitrado. You will paste your own long-life API token on Server setup so the bot can read ADM logs.
• Log in here at admin.royalkillfeed.com with your panel password.

Changes you save here apply to the live bot within a few seconds. You do not need to restart the bot for channel IDs or rewards.

2. Prepare Discord

Create text channels (or use existing ones) for each feature. A simple layout:

Optional feeds: online players, connections, build/dismantle, bounty tracker, wanted board, wealth board, mod alerts — add channels only if you use those features.

3. Copy channel IDs

1. In Discord (desktop or browser): User Settings → Advanced → Developer Mode → ON.
2. Right-click the channel → Copy Channel ID (a long number like 1511403282873061558).
3. Paste that number into the matching field on Server setup (or Channels) — no # prefix, numbers only.

For role IDs (rules gate, mod roles): right-click the role → Copy Role ID, same idea.

Leave a field empty to disable that feed. The bot will not post there.

4. Wire channels in the panel

Open Server setup and fill in each group (same as Channels):

• Combat & leaderboards — kill feed, death feed, kill leaderboard, wealth board.
• Economy & bounties — economy channel (all /wallet, /daily, games), link channel, bounty tracker, wanted board.
• Server activity — online list, connections, build, dismantle (optional).
• Moderation & onboarding — mod alerts, rules, how-to.

Click Save channels & rules. Or use the Dashboard — click Edit → on any feature to change only that setting (e.g. kill feed opens just the kill channel field).

5. Nitrado long-life token

Each server uses its own token so RoyalKillFeed can download ADM files from your Nitrado box.

1. Log in at nitrado.net.
2. Top right: your username → My Account → Developer Portal.
3. Click Long-life tokens (top right).
4. Description: e.g. RoyalKillFeed. Tick Service only (not user/file). Click Create.
5. Copy the full token immediately — Nitrado shows it once.
6. On Server setup, paste the token and your service ID (from your server URL: …/services/12345678/…).
7. Click Save setup, then Test Nitrado link. You should see a green connected message.

If you change your Nitrado password, old tokens are deleted — create a new long-life token and save it again.

6. Rules gate (optional)

On Channels, under Rules gate & mods:

• Enable Rules gate enabled if new members must react before seeing the rest of the server.
• Set Gate reaction emoji (e.g. 👑 or ✅).
• Set Access role ID — the role granted after they react (create a “Verified” or “Member” role in Discord first).
• Set Mod role IDs — comma-separated list for staff slash commands and alt tools.

Point Rules channel ID at your rules channel. Under Your rules text (this server only), edit the fields — each customer’s Discord server has its own rules post (not shared). Grey placeholder text shows examples; replace with your rules and Save. Use {server} and {emoji} in the intro.

7. Economy & bounties

1. Set Economy channel ID on Channels — players run economy commands only in that channel.
2. Set Link channel ID — players run /linkgamertag here first.
3. Tune scrap amounts on Economy: daily reward, kill reward, work/rob limits, bounty min/max.

Players must link before kill rewards and leaderboard credit apply. The bot posts a pinned economy guide in the economy channel on startup.

8. Combat & activity feeds

Kill / death feeds — require kill and death channel IDs. Data comes from ADM logs automatically while the server is running.

Leaderboard — set leaderboard channel; choose layout on Settings (royal = one embed, classic = three).

Wanted board — channel on Channels; streak and rewards on Settings.

Crown threat — enable on Settings; alerts when a streaking player enters a base ping zone.

9. Base ping zones

1. On Base pings, click Add zone.
2. Choose a zone key (short id, e.g. severograd) and a label (display name).
3. Paste the Discord channel ID where alerts for this base should post.
4. Enter center X and center Z from your map (Chernarus coords). Use Live map or iZurvive to find coordinates.
5. Set radius in meters (default on Settings applies if left blank).

Mods can test with /testbaseping and zone id severograd in Discord. Emojis and thumbnails are on Settings.

10. Tell your community

After channels are set:

1. Members read #how-to (bot pins a guide if how-to channel ID is set).
2. They link in #link-gamertag with /linkgamertag YourDayZName.
3. They use economy commands in the economy channel only.
4. If rules gate is on, they react in #rules to get access.

Use Players in this panel to look up stats, links, wanted status, and scrap balance.

11. Test checklist

• Dashboard Nitrado ADM link is ON; Test Nitrado link succeeds.
• Dashboard shows ON for features you expect.
• Kill/death channels receive a post after PvP on the server (linked killer for rewards).
• /linkgamertag works in the link channel.
• /wallet and /daily work in the economy channel.
• Leaderboard embed updates in the leaderboard channel.
• Base ping test fires in the zone channel (/testbaseping).
• Live map shows players when someone is online (ADM position lines).

If a feed stays quiet, check the server is running, ADM is updating (see Dashboard → Bot sync), and the channel ID is correct.

12. Secrets & hosting

Never share your admin panel password, Nitrado long-life token, or Discord bot token in public channels.

• Channel, role & server IDs — Server setup.
• Nitrado token + service ID — same page, Nitrado section (each server owner has their own).
• FTP — optional on Server setup only if you do not use the Nitrado API.

First-time values may be copied from the server .env automatically; after that, edit IDs in the panel.