This plugin supports the Slack plugin or the Discord plugin and provides a notification system to either a player or a slack team when a player connects or disconnects from a server and when a player attacks another player's base.

Features

• When a player disconnects or connects, the message will always be sent to a channel.
• When a player who's online has their base attacked, a message will be sent to the chat window in-game.
• When a player who's sleeping in the server but offline has their base attacked a message will be sent to a channel.

Setup

To use this plugin the file Slack.cs must also be loaded from your server's plugin directory. Do this by dropping the Slack.cs file into the plugin directory, review that plugins notes for setup information.

Repeat the steps with Discord.cs. These two steps are optional if you only want server notifications, but if you want to makeuse of Slack or Discord functionality then these two plugins will need to be loaded.

Next drop RustNotifications.cs into the servers plugin directory, if the server is running it should automatically recognize and build the plugin and create the default configuration file. If the server isn't running, the config file will be created the next time the server is started.

Configuration

{
  "DiscordConfig": {
    "Active": false,
    "DoLinkSteamProfile": true,
    "DoNotifyWhenBaseAttacked": true,
    "DoNotifyWhenPlayerConnects": true,
    "DoNotifyWhenPlayerDisconnects": true,
    "NotificationCooldownInSeconds": 60,
    "ThresholdPercentageHealthRemaining" : 100
  },
  "ServerConfig": {
    "Active": true,
    "DoNotifyWhenBaseAttacked": true,
    "NotificationCooldownInSeconds": 60,
    "ThresholdPercentageHealthRemaining" : 100
  },
  "SlackConfig": {
    "Active": false,
    "DoLinkSteamProfile": true,
    "DoNotifyWhenBaseAttacked": true,
    "DoNotifyWhenPlayerConnects": true,
    "DoNotifyWhenPlayerDisconnects": true,
    "NotificationCooldownInSeconds": 60,
    "ThresholdPercentageHealthRemaining" : 100
  }
}

• Active: Switch to turn slack notifications on/off.

• DoLinkSteamProfile: Switch to turn off link to steam profile on notifications (NOTE, this only works for Slack notifications right now).

• DoNotifyWhenBaseAttacked: Switch to turn notifications for base attacks on/off.

• BaseAttackedMessageTemplate: Template message to display on notifications for base attack. {Attacker} and {Defender} will be replaced with the Steam Display Names of the attacker and defender respectively. NOTE If the defender is online the message will send to them through the ingame chat command. If the player is offline it will go to the slack channel.

• DoNotifyWhenPlayerConnects: Switch to turn notifications for player connections on/off.

• PlayerConnectedMessageTemplate: Template message to display on player connections.

• DoNotifyWhenPlayerDisconnects: Switch to turn notifications for player disconnections on/off.

• PlayerDisconnectedMessageTemplate: Template message to display on player disconnections.

• NotificationCooldownInSeconds: Time to wait between base attacked notifications. This is on a per player basis. Meaning if two players have their bases attacked inside the cooldown period, they will both receive messages.

• ThresholdPercentageHealthRemaining: Threshold to only send notifications when the hit entity's pecentage health remaining is less than this value. Defaults to 100. E.G. If it's set to 50, only hit entities with 50% or less health remaining will trigger this alert.

ServerConfig is more limited right now as there already plugins out there to notify the server when a player connects/disconnects.

Localization

• BaseAttackedMessageTemplate: Template message to display on notifications for base attack. {Attacker} and {Defender} will be replaced with the Steam Display Names of the attacker and defender respectively. If the defender is online the message will send to them through the in-game chat command. If the player is offline it will go to the slack channel.

• PlayerConnectedMessageTemplate: Template message to display on player connections.

• PlayerDisconnectedMessageTemplate: Template message to display on player disconnections.

TODO

• Notify on structure destroyed.
• Notify on sleeping player attacked/looted.
• Ideally there would be some sort of in-game item, such as an alarm system where you'd attach this to structures and this would cause the notifications to go out instead of having it turned on for everything.