RaidAlerts

Raid Alerts  Real-Time Base Defense Notifications for Rust

 

Simple Plugin Preview:

 

 

Raid Alerts is an essential plugin for Rust, providing instant notifications when your base is under attack. With in-game alerts, Discord integration, and Clan compatibility, Raid Alerts ensures you’re always informed of any threats to your base, even if you’re offline.

 

 

Key Features:

• Instant Alerts: Immediate in-game notifications keep you informed the moment a raid begins.
• Clan Compatibility: Integrates with the Clans plugin to notify all authorized clan members of any raid, enabling coordinated defenses.
• Advanced Discord Integration:
• Personal Webhooks: Each player can register a unique Discord webhook, allowing notifications to be sent to their private Discord server.
• Clan Webhooks: Clan owners can set a clan-wide Discord webhook so that all members are alerted on a shared Discord server.
• Global Notifications: Server owners can specify a global webhook for all raid alerts.
• Embed Option: Configure alerts as embedded messages for rich visuals or simple text for minimalistic notifications.
• Note: Each player and clan can save one webhook at a time, allowing personalized or clan-specific Discord notifications.

 

Why Use Raid Alerts?

• Knowing your base is under raid as it happens is vital in Rust. Whether you’re farming resources or raiding another base, Raid Alerts keeps you connected, helping you act quickly to defend your assets.

 

Use Cases:

• Resource Gathering or Raiding: Rest assured you’ll be notified if your base is compromised.
• Monument Exploration: Raid Alerts informs you of any threats, so you can stay focused on looting.
• Clan Defense Strategy: Enable seamless coordination as Raid Alerts notifies all clan members, facilitating quick defenses.

 

 

Command Overview:

Example Usage:

To register a personal or clan webhook, only part of the webhook URL is required. Simply use the ID and token (as shown below) to configure alerts. The complete link is not necessary.

All Player And Clan WebHooks Are Automatically Saved And Dynamically Stored/Removed/Loaded From The Generated Config

 

Command Example

/myraid 1300063659304947833/KxfSH7NFWd65HGfHSv9yBoLNj6rC1ISjU0zAjh0zoCBqCQUWipCDtTGYdMB8Nf6j5EO5

 

/clanraid 1300063659304947833/KxfSH7NFWd65HGfHSv9yBoLNj6rC1ISjU0zAjh0zoCBqCQUWipCDtTGYdMB8Nf6j5EO5

 

Discord Webhook URLs typically look like:

https://discord.com/api/webhooks/1300063659304947833/KxfSH7NFWd65HGfHSv9yBoLNj6rC1ISjU0zAjh0zoCBqCQUWipCDtTGYdMB8Nf6j5EO5

 

However, only the ID and token section is needed in the command. Server owners configuring a global webhook must use the entire link.

1300063659304947833/KxfSH7NFWd65HGfHSv9yBoLNj6rC1ISjU0zAjh0zoCBqCQUWipCDtTGYdMB8Nf6j5EO5

 

Commands:

Player Commands

• /raidhelp

Personal Webhook:

• /myraid <webhook_id/token>: Register a personal webhook for individual alerts.
• /myraid remove: Remove your registered personal webhook.

 

Clan Webhook:

• /clanraid <webhook_id/token>: Clan owners can register a webhook for shared alerts among clan members.
• /clanraid remove: Clan owners can remove the registered clan webhook.

 

Default Configuration:

• On installation, a default configuration file is created in oxide/config, where you can adjust settings for notifications, Discord integration, and more.

 

{
  "General": {
    "Enable debug logging (true/false)": true,
    "Send alerts on entity damaged instead of destroyed": false
  },
  "In-Game Notifications": {
    "Authorized players notify mode (0=UI, 1=Chat, 2=Both)": 0,
    "Clan members notify mode (0=UI, 1=Chat, 2=Both)": 0,
    "Authorized players UI type (0=StandardUI, 1=CustomUI1, 2=CustomUI2)": 0,
    "Clan members UI type (0=StandardUI, 1=CustomUI1, 2=CustomUI2)": 0,
    "In-game notification cooldown [seconds]": 1,
    "UI auto-hide time [seconds]": 15.0,
    "UI icon item shortname": "explosive.timed"
  },
  "Discord": {
    "Use Discord Webhooks (true/false)": true,
    "Ignore Discord alerts for Raidable Bases (true/false)": true,
    "Discord Global RaidAlert Webhook URL": "",
    "Use Discord Embed for Notifications": true,
    "Enable Discord notification cooldown (true/false)": true,
    "Discord notification cooldown [seconds]": 30,
    "Enable global message cooldown for each grid location (true/false)": false,
    "Global message cooldown for each grid location [seconds]": 180
  },
  "Chat Settings": {
    "Use Prefix (true/false)": true,
    "Prefix": "<color=#ff3b30>[RaidAlerts]</color> ",
    "Chat Icon SteamID (0 = none)": 76561198888888888,
    "Chat Channel (0 default)": 0
  }
}

 

Configuration Options:

• cooldownGame: Frequency of in-game notifications to prevent spamming (in seconds).
• destroyUi: Duration of in-game notifications on-screen (in seconds).
• imageNotify: Icon for in-game notifications (e.g., "explosive.timed").
• discordWebhookUrl: Global webhook URL for sending alerts to Discord.
• useEmbed: true for embedded alerts with rich visuals; false for plain text alerts.
• personalWebhooks: Stores individual player webhook URLs for personal base alerts.
• clanWebhooks: Stores clan webhook URLs for shared alerts.

 

 

 

 

 

Plugins By Duff

https://discord.gg/2KBPH7hXb7