About Offline Raid Announcer
Features
Automatically detects when offline players are being raided
Notifies online players about raids in progress
Tracks and stores raid statistics for each player
Provides map markers at raid locations
Optional Discord webhook integration for raid notifications
Customizable notification cooldowns
Notifies players of raids that occurred while they were offline
Team-based notification system
Commands
| Command | Description | Permission |
|---------|-------------|------------|
| /raidinfo | View your own raid statistics | offlineraidannouncer.stats |
| /raidinfo [player] | View raid statistics for another player | offlineraidannouncer.admin |
| /raidstats | Alias for /raidinfo | Same as raidinfo |
| /ofra.clear | Clear all stored raid data | offlineraidannouncer.admin |
Permissions
| Permission | Description |
|------------|-------------|
| offlineraidannouncer.receive | Allows a player to receive raid notifications |
| offlineraidannouncer.bypasscooldown | Allows a player to bypass the notification cooldown |
| offlineraidannouncer.admin | Grants administrative access to commands and features |
| offlineraidannouncer.stats | Allows a player to view raid statistics |
Configuration Options
| Option | Description | Default |
|--------|-------------|---------|
| NotificationCooldown | Time in seconds before sending another notification to the same player | 600 |
| IncludeOwnerName | Whether to include the name of the base owner in raid alerts | true |
| IncludeRaiderName | Whether to include the name of the raider in raid alerts | true |
| WipeDataOnWipe | Whether to clear all stored data when the server wipes | false |
| NotifyRaidersTeam | Whether to notify the raider's team members about the raid | true |
| SaveRaidStatistics | Whether to save and track raid statistics for each player | true |
| NotifyOfflineOnReconnect | Whether to notify players about raids that happened while they were offline | true |
| RecentlyOfflineTime | Time in seconds to consider a player 'recently offline' after disconnecting | 300 |
| UseDiscordWebhook | Whether to send raid alerts to a Discord webhook | false |
| DiscordWebhookUrl | The URL of your Discord webhook for raid notifications | https://discord.com/api/webhooks/your/webhook/url |
| ExcludedZones | List of zone names where raid notifications won't be triggered (requires ZoneManager) | [] |
| RaidThreshold | The minimum number of raid events before triggering notifications | 3 |
| ShowMapMarker | Whether to show a map marker at the location of a raid | true |
| MapMarkerDuration | Duration in seconds that a raid map marker will remain visible | 300 |
| AdminOnlyNotifications | Whether to only send raid notifications to admins | false |
| MonitoredEntities | Entity types to monitor for raid detection | [BuildingBlock, Door, StorageContainer, ExternalWall, Lock, Trap, Barricade, SleepingBag, Turret, Furnace, Workbench] |
Dependencies
Optional: ZoneManager - Required for zone exclusion functionality
Discord Integration
To enable Discord notifications:
Create a webhook in your Discord server settings
Set UseDiscordWebhook to true in the plugin config
Add your webhook URL to the DiscordWebhookUrl setting
The plugin will now send raid notifications to your Discord server whenever an offline raid is detected.