Search the Community

The Offline Raid Protection plugin is a comprehensive solution designed to protect players' structures and vehicles while they are offline. It offers a range of customisable protection levels based on real-time or the length of time a player has been offline, and integrates with the Clans plugin and the in-game teams feature to determine protection status based on the online status of all clan or team members and authorised players. Key Features Configurable Protection Levels: Set protection levels based on real time or the amount of time since a player went offline. For example, a building can have 100% protection one hour after a player goes offline, and 50% protection after two hours. This feature is highly configurable. Clan/Team Integration: The plugin integrates with the Clans plugin and the in-game teams feature. The protection status of a structure or vehicle is determined by the online status of all clan or team members and authorised players. Penalty System: An optional penalty system is implemented to prevent abuse of the protection feature. For example, if a player leaves a clan or team, a penalty can be applied to all members and protection can be disabled for a configurable period of time. Game Tip Messages: The plugin displays game tip messages to players when they hit a protected structure or vehicle. The message includes the percentage of protection and is colour coded according to the level of protection. It supports all the languages available in Rust. Commands: Players with permission can use commands to check the protection status of other players, change the offline time of other players, and change the penalty status. Cache System: The plugin uses a caching system to optimise performance and keep the impact on the server to a bare minimum. Configuration: The plugin includes a configuration file that allows you to customise the behaviour of the plugin. Commands All commands can be configured. /orp or /ao <steam id or full name> — Check a player's offline protection status. You can type the command without a name when looking at a player's structure. /raidprot — Display offline raid protection information. /orp.fill.onlinetimes — Fill all players offline times. (Chat & Console command) /orp.test.offline <steam id or full name> <hours> — Change a player's offline time. /orp.test.online <steam id or full name> — Change a player's offline time to the current time. /orp.test.penalty <steam id or full name> <hours> — Change the duration of a player's penalty. A negative value or zero would disable the penalty. /orp.update.permission — Update the permissions status (offlineraidprotection.protect) for all players. orp.update.prefabs <true> - Updates the 'Prefabs to protect' list in the configuration. Overwrites the list with the 'true' argument. (Console command) orp.dump.prefabs - Clears the 'Prefabs to protect' list in the configuration. (Console command) Permissions All permissions can be configured. offlineraidprotection.protect — Allows a player to be protected from raids when offline. offlineraidprotection.check — Allows a player to check the offline protection status of other players. offlineraidprotection.admin — Allows a player to use all admin commands of the plugin. To grant a permission, use carbon/oxide.grant <user or group> <steamname or ID> <permission>. To revoke a permission, use carbon/oxide.revoke <user or group> <steamname or ID> <permission>. Configuration The configuration is to a large extent self-explanatory. Raid Protection Options Only mitigate damage caused by players: Choose whether or not to only mitigate damage caused directly by players. Protect players that are online: Choose whether or not to protect the bases of the players who are online. Works when "Scale of damage depending on the current hour of the real day" is configured. Scale of damage depending on the current hour of the real day: Defines the protection levels based on the current hour of the real day. The key is the hour of the day (0-23), and the value is the protection scale (0 — 340282300000000000000000000000000000000). Example: "0": 0.0, "1": 0.0, "2": 0.0, "3": 0.0 This means that the protection level is 100% from midnight to 3am. Scale of damage depending on the offline time in hours: Defines the protection levels based on the time since the player went offline. The key is the number of hours since the player went offline, and the value is the protection scale (0 — 340282300000000000000000000000000000000). The value of the hours can also be a decimal number. Example: "12": 0.25, "24": 0.5, "48": 1.0, "96": 2.0 This means that 12 hours after the player goes offline, the protection level will be 75%. After 24 hours it will be 50% and after 48 hours it will be 0%. After 96 hours, the damage is increased by 200%. Cooldown in minutes: During this time, damage levels will remain vanilla. Raids are possible. Scale of damage between the cooldown and the first configured time: During this time, the level of damage between the cooldown and the first configured time can be set to a specific value, such as 0.0. Online time to qualify for offline raid protection in minutes: Time to qualify for offline raid protection after a player connects Protect all prefabs: Choose whether to protect all prefabs or only specific ones. This will protect anything in the TC range. Protect AI (animals, NPCs, Bradley and attack helicopters etc.) if 'Protect all Prefabs' is enabled: Choose whether or not to protect AI entities if "Protect all Prefabs" is enabled. May cause high hook times if set to true. Protect vehicles: Choose whether to protect vehicles or not. Vehicle authorisation always has priority. If you want to exclude certain vehicles from protection, add them to the blacklist. Protect twigs: Choose whether to protect twigs or not. Prefabs to protect: List of prefabs that will be protected. Make sure you remove the prefabs you don't want to protect, some of them are pointless. Prefabs blacklist: List of prefabs that will not be protected. Prefabs in the blacklist will always have priority to be unprotected. Timezone Options The fallback timezone is UTC if you leave it blank in the configuration, or if your configured timezone doesn't exist. The timezone identifiers are different for Windows and Linux. You can check the appendices to find your preferred timezone. Conclusion: The Offline Raid Protection plugin provides a comprehensive solution for protecting players' structures and vehicles when they are offline. This plugin is essential for any Rust server owner who wants to provide a fair and enjoyable gaming experience for their players. Acknowledgments Special thanks to @Kulltero for his valuable feedback and suggestions during the development of this plugin. Windows_Timezones.txt Linux_Timezones.txt Prefabs.txt

Features: Setting up safe and raid times 6 variations of GUI display for players Ability to configure blocked activities during safe time Ability to set the time for the day of the week (Used by default), and for a specific date Flexible and intuitive plugin settings Real-time UI(Has 6 variations) with date, time and raid/safe time info. A menu where players can find out the safe and raid times for any given day Convenient in-game menu for plugin settings You can set safe days after wipe How to open setup RTM UI Default command for open setup RTM UI: /rtm Configuration: { "Command for open Raid Time Managment UI": "rtm", "Timezone(Difference between UTC and your time)": 60, "Time format for UI(True - 24H format, False - 12H format)": false, "Display UI": true, "Enable Alerts": true, "Allow players to close the UI": true, "[RaidableBases] Allow raiding RB bases in SafeTime": true, "[TruePVE] Safe Time RuleSet": "default", "[TruePVE] Raid Time RuleSet": "default", "[ZoneManager] The plugin will work on entities in the zones": "DISABLED", "[ZoneManager] Zone ID List": [], "UI Position": "UPPER_LEFT", "NPP amount": 0, "Block only offline raids": true, "Add safe days after wipe": 1, "Commands to be executed when raid time starts": [], "Commands to be executed when safe time starts": [], "Forbidden actions during the blocking of the raid": { "Default Raid By Player": true, "Damage Own Buildings": false, "Raid By Patrol Helicopter": true, "Raid By MLRS": true, "Using Ladders In Building Block": true, "Damage By Fire": true, "Build Ceiling In Building Block": true, "Build Turrets In 2x Building Block Radius": true, "Break down twig buildings": false }, "List of prefabs that can always be damaged": [], "Manage raids by day of the week (Used by default)": { "Monday": [ { "Start Raid Block(Hours)": 18, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ], "Tuesday": [ { "Start Raid Block(Hours)": 14, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ], "Wednesday": [ { "Start Raid Block(Hours)": 18, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ], "Thursday": [ { "Start Raid Block(Hours)": 18, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ], "Friday": [ { "Start Raid Block(Hours)": 18, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ], "Saturday": [ { "Start Raid Block(Hours)": 10, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ], "Sunday": [ { "Start Raid Block(Hours)": 8, "Start Raid Block(Minutes)": 0, "Stop Raid Block(Hours)": 22, "Stop Raid Block(Minutes)": 0 } ] }, "Raid management for specific days(Takes precedence over raid management by day of the week)": {} } Explanation of some options: "Default Raid by Player" : players will be able to use items for the raid Lang: { "UI_ALERT": "ALERT", "UI_TURRETBLOCK": "You cannot place turrets in double TC radius during safe time", "UI_LADDERBLOCK": "You may not place ladders in a Building Block during safe times.", "UI_CEILINGBLOCK": "You cannot place ceilings in the Building Block during safe times.", "UI_CANDAMAGE": "You cannot damage other people's buildings during safe times", "UI_CANDAMAGEOWN": "You cannot damage own buildings during safe times", "UI_START_RAID_TIME": "Raid time has begun! All restrictions removed", "UI_STOP_RAID_TIME": "The raid time is over. Restrictions are in effect!", "CM_CLOSE_HUD": "You closed the RTM HUD, to open it again use the /rtm hud command", "UI_RAIDTIMESCHEDULE": "RAID TIME SCHEDULE", "UI_SAFE_TIME": "Safe Time", "UI_RAID_TIME": "Raid Time", "UI_Monday": "Monday", "UI_Tuesday": "Tuesday", "UI_Wednesday": "Wednesday", "UI_Friday": "Friday", "UI_Saturday": "Saturday", "UI_Sunday": "Sunday", "UI_AM": "AM", "UI_PM": "PM", "UI_January": "January", "UI_February": "February", "UI_March": "March", "UI_April": "April", "UI_May": "May", "UI_June": "June", "UI_July": "July", "UI_August": "August", "UI_September": "September", "UI_October": "October", "UI_November": "November", "UI_December": "December", "UI_Thursday": "Thursday" }