RaidAlarm

A raid never waits for you to log in. RaidAlarm stands guard over every structure your tribe owns, and the moment an enemy starts breaking walls, the alarm goes off in your Discord. Your tribe can be asleep, at work, or on another map. They still hear about it while the raiders are at the door, not the next morning over a crater.

RaidAlarm watches your structures for damage and turns a raid into a single, readable alert. It batches every hit inside a time window, so one raid is one ping and not a wall of spam. Each alert names the tribe that got hit, the raider, how many hits landed, and where on the map the attack is happening. It runs light on the server because the hot path stays tiny and the heavy work only runs when an alert is ready to send.

What the alarm watches for

• Offline raid alerts: I warn your tribe their base is under attack even when nobody is logged in.
• One alert per raid: BatchSeconds rolls every hit in a window into a single alert, so a long raid is a few pings, not a hundred.
• Quiet the small stuff: MinHitsToAlert holds back a single stray hit and only fires on a real attack.
• Player raids only: PlayerAttackersOnly skips a wild dino that wanders into your base.
• Skip self damage: IgnoreSelfDamage keeps your own demolition or pickups from setting off an alarm.
• Raid coords: LogCoords adds the attacker's map spot, so you know where to defend.
• In game warning: WarnOnlineTribe also messages any tribe members who are online right now.
• Channel ping: PingEveryRaid adds an @here to each Discord alert so no one misses it.
• Team filter: MinTeamId drops unowned or neutral builds so only real bases alert.
• Easy to run: no database, no economy, and no permission plugin needed to get it working.

The two admin commands

RaidAlarm runs itself. Players type nothing, there is nothing to gate, and you do not need the Permissions plugin. The console and RCON commands are admin side by nature. Admins get two:

Getting it on your server

You need AsaApi v2.01 or newer on a Windows dedicated server. A Discord webhook for your raid channel is the only other piece, and even that is optional, since the in game warning still fires without it. No ArkShop, no Permissions, no database.

1. Extract the RaidAlarm folder into your server's ArkApi/Plugins/ folder. AsaApi finds a plugin by its folder, so the folder must carry the exact same name as the DLL inside it.
2. Open config.json, set Discord.Enabled to true, and paste your WebhookURL.
3. Set ServerName and tune BatchSeconds, MinHitsToAlert, and the other rules to taste.
4. Start the server again with AsaApiLoader.exe.
5. Watch ArkApi.log for the line that says RaidAlarm loaded, then run a test hit or RaidAlarm.TestDiscord.

Tuning the alarm

Every setting, what it does, and what a bigger or smaller value changes is written up in our docs. If you would rather click than edit JSON by hand, our configuration editor builds the file for you.

When the alarm will not sound

Something not firing, or stuck on setup? Come find me on Discord and we will get it watching your base: https://discord.gg/8GGaEzWk9p

Owners ask

Does RaidAlarm work when my whole tribe is offline? Yes. That is the job. RaidAlarm reads the damage on your structures server side and posts to Discord no matter who is logged in. The whole tribe can be offline and asleep, and the alert still lands in your channel while the raid is happening.

Will it flood my Discord during a long raid? No. Every hit inside BatchSeconds folds into one alert, and MinHitsToAlert keeps a stray tap quiet. A raid that runs ten minutes at the defaults sends about ten alerts, one a minute, enough to show the fight is still on without a wall of pings.

Can each tribe get alerts in their own channel? Not yet. Right now every alert lands on the one webhook you set in WebhookURL, so most servers point it at a public raid alert channel. A per tribe split is on the list for a later build of RaidAlarm.

Will a wild dino or my own demolition set it off? Not with the defaults. PlayerAttackersOnly skips wild creatures, and IgnoreSelfDamage checks the attacker's team, so tearing down your own walls stays silent. Flip either one in the config if you want the alarm louder.

Does it need ArkShop, Permissions, or a database? No to all three. RaidAlarm keeps its raid windows in memory and talks to one Discord webhook, so there is nothing extra to install and nothing to break.

How do I add it to a live server? Drop the RaidAlarm folder into ArkApi/Plugins/, keep the folder named exactly like the DLL, set your webhook in config.json, and restart through AsaApiLoader.exe. Then fire RaidAlarm.TestDiscord from the console to prove the webhook before the first real raid.

RaidAlarm v0.0.1