Jedchado's Wishlist

The ultimate base protection plugin that allows players to pay a resource in exchange for configurable protection for their base or tugboat. This plugin has been rewritten from the ground up for performance, quality, and integrating community suggested features.
 
Features

 
There are many different ways you can configure this plugin to fit the needs of your server. Many features can be modified or disabled entirely through the plugin configuration file. These include:
Both online and/or offline base protection Trade currency for protection or provide it for free Players can turn on/off protection Permission based protection tiers Configure what gets protected and who it is protected from Set limits on how long protection lasts Indicator(s) for displaying base protection Option for allowing raiders to bypass protection if they can drain the protection balance with damage Options for making protection more expensive for larger bases/clans and cheaper for small groups. UI that blends in seamlessly with vanilla Rust. Disclaimer
This plugin will be updated at the owners discretion. Before purchasing any plugin, I recommend checking the date of the last update and refer to support tickets to see if there might be any issues with the latest Rust game version. If a game update breaks this plugin, please open a support ticket (if it doesn't already exist) and direct message me on Discord (link found below).
How to Use
Configure the plugin and load it Once loaded, assign yourself (or your group) one of the protection level permissions. Place a new tool cupboard, or find one that YOU have previously placed. Open the tool cupboard inventory, at the top you should see two tabs: "Upkeep" and "Protection". Select the protection tab to view the raid protection info. On this screen, you will be able to spend the configured currency in order to purchase hours of protection. By default, this currency is scrap. Use the buttons on the right to add some hours of protection, you should see that status change to show the time you are protected. Your base will now be protected for the amount of time specified. Notes
You can use the Clear button to withdraw all balance, and stop protection The Pause/Resume button can be used to start/stop protection without changing the balance. The Info button will reveal a panel which displays additional information on protection. The +Max button will deposit the maximum amount of time that you can afford  
Quick Start Presets
There is a lot of documentation for this plugin because there is a lot you can do with it! However, it doesn't have to be complicated. If you have a simple use case in mind, you can use one of these preset configurations to get what you need or use as a starting point without having to figure it out yourself!
Important: You will want to assign your default permission group the raidprotection.level.1 permission for any of these configurations.
 Always Free Provides free raid protection for all players with the level 1 permission Protection for tugboat bases Recommended for PvE or light PvP servers Offline Only Same as the default config, but only offers offline protection Has a limit of 48 hours of protection for level 1 Includes a level 2 permission with unlimited hours of protection (VIP) Protection for tugboat bases Recommended for PvP servers Hardcore Offline only protection Two protection levels, one with a 48 hour limit and one with no limit Additional costs that scale with number of owners and building size Raiders can damage a structure and cause it to "bleed" protection balance to attempt to disable the protection with enough damage Significant delay for activating protection No protection for tugboat bases Recommended for hardcore PvP servers Upgrading Versions
When a new version is released, you may need delete your config and lang files and reload them to accommodate the new changes. You do NOT need to delete the data file, unless specifically instructed. As long as you do not delete the data file, then all of your protection balances will persist, even between versions. Not all updates will require this process, but if it does, you will be notified with a message like this:
To resolve this, simply delete the config and lang files and reload the plugin. You will need to manually update these files to align with what you want.
As of v3.4.0 you no longer need to delete your config files when upgrading from a previous version. However, you still should check the config after the update is installed to verify no unintended changes have occurred.
Protection Levels

Protection levels are how you assign a particular set of rules to a player. These protection levels are added in the configuration file, and are then assigned to an auto-generated permission.
Each protection level needs a unique Rank property, this rank determines the order of precedence when a player is assigned multiple protection levels. In this event, a player's protection level will always be the highest ranked protection level they are granted.
Protection levels are managed in the configuration file, here is some information on some of the properties:
Cost per damage protected  - This amount will be deducted from the protection balance for each point of damage that was protected. So if this value is set to 1 and someone attempts to deal 100 damage to a protected structure, and that structure has 100% protection, then 100 balance will be deducted. If in that same example it was only 50% protection, then only 50 balance would be deducted. Entity resistances are taken into account as well (twig will take more damage than metal, ect). Hourly base cost - This is a fixed cost that is charged per hour of protection. Hourly cost per authorized player - This amount will be charged for each owner every hour. Can be used to charge players more if they have a larger clan. Hourly cost per floor - This amount will be charged for each floor every hour. Can be used to charge players more for protecting a larger base. Max protection time - The max number of hours protection can be applied for. If set to null, then there will be no limit. Offline protection percent - The percent of protection a structure will receive when all the owners are offline. A value of 0 will be unprotected, and a value of 100 will be fully protected. Online protection percent - The percent of protection a structure will receive when at least one owner is online. A value of 0 will be unprotected, and a value of 100 will be fully protected. Rank - A number value indicating the order of importance when a player is assigned multiple protection ranks. Higher values indicate a greater importance. For example, if a player is assigned both protection rank 1 and protection rank 2, then tool cupboards they place will be of protection rank 2 instead of 1.  These ranks must be unique DO NOT create protection levels with the same rank. This value needs to be 1 or higher, it cannot be 0. Delay after taking damage - The number of seconds before protection may begin after a structure has taken unprotected damage. It is recommended to set this to a higher amount on PvP servers. Delay for offline protection - The number of seconds before offline protection kicks in after the last owner has gone offline. It is recommended to set this to a higher amount on PvP servers. Damage resets timer when owner is offline - If this is set to true, then if a raid has already started on a structure that has offline only protection, but the protection hasn't kicked in yet (due to a delay timer) then the attackers can continue to raid indefinitely as long as they continue to do damage while the owner(s) are offline. If this is set to false, then the attackers will only have a certain amount of time to continue their raid if the owner(s) are offline. Allow tugboat protection - If this is set to true, then players with this protection level may receive protection for tugboat bases. For these tugboat bases the protection panel can be accessed in the fuel inventory of the boat. The founder of a tugboat base is whomever is the FIRST player to authorize on a tugboat. Founder Limit - The number of tool cupboards that a player can be a Founder of and receive raid protection. If a player exceeds this limit, then future tool cupboards will not receive protection until enough previously placed ones have been destroyed in order to be within the limit. If a player places a tool cupboard, and they have exceeded the limit, once they are no longer exceeding the limit they can "activate" that tool cupboard in the info panel to have it gain raid protection. If this value is set to null then there is no limit.  
Founders and Owners

When a tool cupboard is placed, the player who places it is permanently labeled as the "Founder" of that tool cupboard and building privilege. The protection level of that building privilege is derived soley from the founder's protection level, and therefore won't change unless the founder's protection level changes.
Whenever a player is authorized on a tool cupboard, they will be permanently branded as an "Owner" of that tool cupboard. Owners are all the players, including the founder, who have EVER been authorized on the tool cupboard. This means that players will still be listed as an owner even if they deauthorize themselves. Owners are important because they affect how Online/Offline protection will be triggered. A base will only be granted offline protection if ALL the owners are offline, otherwise online protection (if available) will be granted if at least one owner is online.
For tugboat bases, the founder is whomever is the first player to authorize themselves on the tugboat.
 
Permissions
raidprotection.admin raidprotection.level.x - these permissions are autogenerated based on your protection level settings in the config, they will show up in the server console when the plugin is loaded (unless you have Enable Console Messages set to false) raidprotection.ignore - raid protection will not count any player with this permission towards being an owner. They will not show up in the owner list and will not count toward team member count for offline protection. They also will not receive protection on bases they build even if they have a protection level assigned. This is useful for admin groups so that you don't have to remember to deauth on tool cupboards. However, if this permission is ever revoked, that player will be retroactively counted as an owner on ALL tool cupboards they are currently authed on.  
Commands
Player Commands
These commands require no permissions and can be used by any player.
/pro - displays the raid protection information panel, requires authorization on the tool cupboard in the current area. /lev - displays a screen that tells the player their personal assigned protection level and explains the benefits that comes with it. Admin Commands
These commands require the raidprotection.admin permission to use.
/tc - displays a screen with all the available admin commands /tc help - same as /tc Use the above commands to see a full command list in game.  
Configuration
The default config file: 
Here is an explanation for some of the fields:
Enable Logging - Set to true to keep logs of tool cupboards protection activity. Logs will be saved to the oxide/logs/RaidProtection folder.  It is recommended only to enable this only for debugging purposes, as it will take a significant amount of storage space if you have a larger server. Enable Ledger - Set to true to keep track of protection balance changes for tool cupboard. These ledger files are stored in oxide/data/RaidProtection/Ledgers. It is recommended to keep this enabled, as it will help you roll back balances if a player has an issue. This does not take up as much storage space as logging does as it only keeps track of balances. Enable Console Messages - Set to false to disable the info messages upon plugin reload. Commands - You can change the prefix for the commands this plugin uses here. Chat Message Icon ID - A steam id for the portrait of chat messages. Protection Tabs Offset - This value will adjust the vertical placement of the Protection Tabs in the tool cupboard menu. Positive values will move it up, negative values will move it down. Useful for making it so those tabs don't conflict with other UI plugins that use that area. Image Settings - Links for the images the plugin uses. Indicator Settings - Settings for the indicator that (by default) appears in the top right when you attack a protected structure. You can change its size and position or disable it. Plugin Integration - Set any of these to true if you want this plugin to take advantage of the features of another supported plugin. Custom Status Framework Settings (Ignore if you do not have Custom Status Framework integration enabled) Popup Attack Indicator - If set to true, a status will briefly appear when a player attacks a protected structure. Persistent Status For Owners - If set to true, a status will appear while a player is in a protected area that they are an owner for. Slight performance cost when enabled. Persistent Status For Non Owners - If set to true, a status will appear while a player is in a protected area that they are NOT an owner for. Slight performance cost when enabled. Popup Status When Hammer Equipped - If set to true, a status indicating the protection level of the area they are in will appear while they are holding a hammer. This will appear regardless of if you are an owner of that area or not. Protection Settings Admin owners removed when deauthorized - Normally, you cannot remove an owner even if they deauthorize. But if this setting is enabled, it allows admins to remove themselves as owners when they deauthorize from a tool cupboard. They can also achieve this with commands. Allow balance withdraw - If set to true, then players will see a "Clear" button in the tool cupboard panel that allows them to withdraw any protection balance. Allow max deposit - If set to true, there will be a "+Max" button that will purchase the maximum number of protection hours a player can afford. Award remaining balance when cupboard is destroyed - If set to true, whomever destroys a tool cupboard will be awarded whatever amount was in the protection balance. Currency item - The item that will be used as currency for protection, this will only be overridden if you are using Server Rewards or Economics for your currency. If you want it to be a custom item that has a skin, you can put # followed by the skin id after the item name. For example "scrap#12345" would only accept scrap items with the skin 12345. Protected entities - If any of these are set to true, then that type of entity will be covered under Raid Protection. If you are using other protection plugins like TruePvE, then you will want to configure these to not overlap with what other plugins are protecting. Protected from - If these are set to true, then damage from that type of source will be protected. By default Authed Players is set to false, which means that players will be able to damage their own structures, but enemy players cannot. Protection levels - See the section about protection levels for information. Protect twig - If set to true, then twig building blocks will receive raid protection. If set to false, then twig building blocks will not receive raid protection, even if placed by an owner of the base. Ledgers
As of Raid Protection v3.2.0, you can optionally configure ledgers to be enabled. When enabled, the plugin will keep logs protection balance changes for all tool cupboards. These logs will be saved to oxide/data/RaidProtection/Ledgers. There is a ledger file for each tool cupboard, and it's filename will make the entity ID of that tool cupboard. You can use the /tc id command to see what the ID of a tool cupboard is (see commands section). The benefit of ledgers is that each balance change has a specific GUID identifier attached to it that can be used to restore a tool cupboard's balance to that exact state in the event that a player has an issue. An example of a ledger file might look like this:
Ledger file for tool cupboard with ID 2250729
[ "05/26/2023 16:17:56,ad87f16e-52eb-4689-887f-ecc53cd3ff13,0,Withdraw", "05/26/2023 16:18:20,108e54c0-98c4-46df-9eb3-e17192c37bb3,0,CollectionStopped", "05/26/2023 16:18:23,a2f03162-200c-47ce-948e-b0c703435e51,0,CollectionStarted", "05/26/2023 16:18:28,5c83390e-bbd2-4049-8ec9-8f2951746159,0,Withdraw", "05/26/2023 16:19:29,cd892a3f-249b-4cad-8949-abf904656288,20,Added", "05/26/2023 16:19:31,6e710dfc-23c2-4375-8c4f-07017d4d44c6,40,Added", "05/26/2023 16:19:31,bc51f8c7-3f3a-4abc-8fd2-8bb4c47fe454,60,Added", "05/26/2023 16:20:25,f08cfa34-a623-4de3-9027-7c3acb3e3ec3,60,CollectionStarted", "05/26/2023 16:20:52,a849be59-899c-4779-bba6-2f5f1b0ffb8d,59.93055,CollectionStopped" ] The format of each row goes as follows, from left to right separated by commands.
Date and Time of balance activity GUID identifier, used by the /tc restore command to roll back a balance The protection balance of the tool cupboard at that given time A brief descriptive reason as to what changed about that balance For example, using the ledger file listed above, if we wanted to rollback the tool cupboard to before the collection started (the last "Added" one), we could run the following command.
/tc restore 2250729 bc51f8c7-3f3a-4abc-8fd2-8bb4c47fe454 Running this command will set the balance of the tool cupboard with ID 2250729 back to its balance of 60.
As of v3.2.3 you can also mass restore all tool cupboards to a specific time or date.
For example, using the ledger file listed above, if we wanted to rollback the tool cupboard to the time 16:19:00. We could run the following command.
 
/tc ledger rollback 16:19 This will rollback ALL TOOL CUPBOARDS to the first ledger entry that comes BEFORE the given time.  In this case that entry would be GUID=5c83390e-bbd2-4049-8ec9-8f2951746159 at time 16:18:28 because that is the latest entry before 16:19:00. Thus the balance will be 0.
Rollbacks can also accept a date in addition to a time. For example, if you wanted to rollback to noon the following day you could run the following command.
 
/tc ledger rollback "5/25/2023 12:00" Notice that there is no ledger entry for this tool cupboard that goes back that far. In this case, the balance of the cupboard will be set to ZERO. Please note that if you include a date and time the value MUST be enclosed in quotes (see the example above).
Tugboat Bases
As of v3.3.0, Raid Protection can optionally be allowed for tugboat bases. This is configurable per protection level. Tugboat bases can utilize all the features of a normal tool cupboard base. You can access the protection panel for tugboat bases in the fuel inventory in the drivers seat. For tugboat bases, the founder of the base is considered to be the FIRST player to authorize on the tugboat.
Plugin Integration
Clans
This plugin provides built-in support for Clans. If a player is in a Clan, it will automatically treat all clan members as owners. This of course means that the owners will not be removed even when a member is kicked from a clan.
True PVE
This plugin is compatible with True PVE as long as both plugins are configured in a non-conflicting way. For example, if you use True PVE to provide protection to players, then in your Raid Protection config file under the Protected entities section you should set Authed Players and Unauthed Players both to false to avoid hook conflict errors. If you do see hook conflicts, see the section of this documentation about how to resolve hook conflict errors.
Zone Manager
This plugin is compatible with ZoneManager without any extra configuration. ZoneManager will take priority if the zone has the "undestr" flag.
Custom Status Framework
If you have CustomStatusFramework installed and want to take advantage of the status indicators (that appear in the bottom right) in your Raid Protection config file under the Plugin Integration section set Custom Status Framework to true.
Simple Status
Simple Status is a plugin that is still being developed, and will be an alternative, more performance friendly option to Custom Status Framework. This plugin is not yet available, but as of v3.4.0, configuration options have been added to support this plugin when it releases.
Preview of indicators:

 
Economics and Server Rewards
If you wish to use economics balance or server rewards points as a currency instead of an item, you can set ONE of these to true in the plugin integration section of the config. It is important to set ONLY ONE of these to true, or else both will be disabled and you will get a warning in the console.
Protection panel with Economics:

NoDecay
This plugin is compatible with NoDecay without any extra configuration.
Notify
If you want to use Notify as your source of indicators you can enable the flag for it in the Raid Protection config.
Abandoned Bases
If you enable Abandoned Bases in the integration config, then bases that are labeled as Abandoned will not receive raid protection.
Raidable Bases
Bases spawned by Raidable Bases will be ignored by Raid Protection. They should not show up in ledgers and players cannot add balance to them.
Skill Tree
If Skill Tree is enabled in the integration config then it will prevent players with the lockpicking skill from picking locks in raid protected areas.
Other Plugins
Should be compatible with most other plugins given they don't use the onEntityTakeDamage hook. If they do use this hook, it just means you have to change your configuration settings, see the hook conflicts section for more info.
Images
If you experience any issues with the default images provided by this plugin I recommend hosting them yourself. The urls can be changed in the config. Here is a zip file containing all the images.
icons.zip
Carbon
As of 8/19/2023 I can confirm that this plugin is compatible with Carbon. Please open a support ticket if you experience any Carbon related issues.
Hook Conflicts
If you're getting messages in the server console that looks similar to this:
OnEntityTakeDamage resulted in a conflict between the following plugins: NoDecay - True (Boolean), RaidProtection (False (Boolean)) That means that another plugin is conflicting with Raid Protection. In most cases this is an easy fix, and it just means that you need to update your Raid Protection config file to not protect the same entities that another plugin is already protecting. So for example, if you have a plugin already that makes it so player's cannot attack each other, then there is no need for Raid Protection to do that job, and therefore in the Protected entities section of the config you should set Authed players and Unauthed players to false to avoid conflicts.
Previous Versions
You may have seen the free version of this plugin available on uMod. That version (2.X.X) will stay available for free on umod, but is no longer supported.
If you are upgrading from the free version, you must first delete the config/lang/data files before installing v3.0.0 and above. If you do not delete these files, you will likely run into issues, as despite having the same name, the plugin has been completely rewritten, and therefore is completely incompatible with the free version.
 
Developer API
/* * Returns 0 if entity unprotected and 100 if entity fully protected */ private float GetProtectionPercent(BaseEntity entity) /* * Returns a list of the owners of the structure associated with the given entity */ private List<BasePlayer> GetOwners(BaseEntity entity) /* * Returns the player who is the founder of the structure associated with the given entity. Can be null. */ private BasePlayer GetFounder(BaseEntity entity) /* * Returns the protection balance of the structure associated with the given entity */ private float GetProtectionBalance(BaseEntity entity) /* * Returns the hours of protection remaining of the structure associated with the given entity */ private float GetProtectionHours(BaseEntity entity) Discord
If you want to report a bug, require support, have a suggestion or want to be notified when I release an update you can join my plugin development discord with this link:
Plugin Development Discord Link

Donate
Writing and maintaining these plugins takes a tremendous amount of work. Donating is one way to give some positive feedback which helps me continue making them!
Buy me a coffee here!
 
FAQ
Please check out this section before opening a support ticket, it may save us both some time!
Q: I don't see the status indicators in the bottom right.
A: The status indicators come from another plugin called CustomStatusFramework, you must install it and enable it in the config file to get the indicators.
Q: I have protection time, but I am able to damage my own structure.
By default "Authed players" are able to damage their own structures. You can change this in the config file.
Q: The add hours buttons aren't showing for me in the tool cupboard panel.
A: The hours buttons will not show if the protection has 0 cost.
Q: I have a max protection time set, but it says "protected for forever"
A: If the protection cost is 0, then there cannot be a max protection time.
Q: I deauthorized myself from the tool cupboard, but I am still listed as an owner.
A: Owners are not removed after deauthorization. Only admins can remove owners.
Q: How are overlapping tool cupboards handled?
A: If a player has a base with overlapping tool cupboards, then each cupboard will need its own protection. Which entities are protected depend upon which tool cupboard governs that entity.
Q: Can player's exploit offline only protection by deauthorizing?
A:Deauthorizing will not help players looking to exploit offline only protection because they will still be considered an Owner even if they deauthorize.
Q: Can a player exploit offline only protection by never authorizing?
A: If a player is never authorized on a cupboard, then they will not count toward being online, and therefore offline protection can occur. However, players cannot add or manage protection balance unless they are authorized, and therefore the protection balance will run out, especially if a max protection time is set.
Q: I have protection for horses on, but now the horses never poop
A: If horses don't lose health, they will never eat and therefore never poop, this is a side effect of protection for horses.
Q: Why does protection say "pending" in the bottom right?
A: Pending either means that you have offline only protection or your structure has recently taken damage and therefore protection is delayed. See the tool cupboard protection panel for more info.
Q: I'm seeing conflict warnings in my console between Raid Protection and True PvE
A: Please refer to the sections of documentation for TruePvE and Hook Conflicts
Q: I'm seeing Image failed to download! Error: HTTP/1.1 429 Too Many Requests
A: Refer to the Images section of the documentation.
 
 

Rocket Strike - the ultimate event that allows you to create missile strikes anywhere on the map, in any quantity, any radius and with all possible settings. A unique feature is the creation of nuclear charges that create radiation zones after the explosion.
 

The following types of rockets are supported: regular, fire, high-speed, MLRS.
The configuration file allows you to manage all aspects of the event:
- projectile type for a missile strike
- random projectiles
- explosion radius
- number of missiles in launch
- nuclear charge
- nuclear charge strength
- radius and duration of the radiation zone
- event frequency
- markers on map
- marker on map after explosion (different color)
- sound siren
- notifications in chat (for all or for nearby players)
- damage multipliers
- loot after explosion
 
Permissions
Requires: rocketstrike.rs  
Chat commands
/rs call (/rs - alias) - takes your position as the center point for launching rockets and using the "Default" preset
/rs onme takes your position as the center point for launching rockets and using the "OnMe" preset
/rs start - event start (the rocket strike will not start immediately, it will be scheduled according to the configuration settings)
/rs stop - stops the event if it was started and scheduled


Configuration
 
Event settings
"EventSettings": {    "autoStart": false, // automatically schedule an event to run after the plugin is installed    "startAtRandomTime": true,     "randomTimeRangeFrom": 120, // minutes    "randomTimeRangeUpTo": 180, // minutes    "repeatTimeInterval": 45, // minutes    "rocketsLaunchPreset": "Default", // selected launch preset    "randomRocketsLaunchPresets": false  }
Presets
1 preset in the example below:

 
"LaunchPresets": { "Default": { "soundAlarm": true, // play sound alarm on launch start "soundAlarmDuration": 11, // seconds "chatNotifications": true, // notify players "chatNotificationsForNeardbyPlayersOnly": false, // notify only nearby players "showMapMarker": true, // show markers on the map (both: red and orange) "mapMarkerLootingStageDuration": 10, // duration in minutes for the orange marker "noDamage": false, // turns damage off "dropLoot": true, // allows to control loot drop "dropLootMultiplier": 1.0, // multiplier for the loot amount dropped by each projectile "maxRadius": 350, // rocket launch zone max radius "minRadius": 250, // rocket launch zone min radius "maxRocketsAmount": 12, // max 12 rockets in one launch "minRocketsAmount": 7, // min 7 rockets in one launch "maxDuration": 120, // seconds "minDuration": 60, // seconds "damageMultiplier": 1.0, // global damage multiplier that affects each projectile "projectiles": [ "NuclearMLRSRocket" // projectile type ] } }
Projectiles configuration
1 projectile in the example below:
 
"Projectiles": { "NuclearMLRSRocket": { // name used in a launch presset "damageMultiplier": 3.0, // projectile damage multiplier for each damage type "explosionRadius": 45, // meters "minExplosionRadius": 25, // meters, minimum radius "gravityModifier": 0, // affects projectile velocity "velocity": 35, // projectile velocity "nuclearCharge": true, // if “true” a nuclear charge will be added to the projectile "nuclearZoneRadius": 50, // meters, radiation zone radius after the explosion "nuclearZoneRadiationAmount": 55, // radiation damage in the zone per second "nuclearZoneDuration": 5, // minutes "prefab": "ammo.rocket.mlrs", // game object used for this projectile "additionalDamageTypes": [ // additional damage type { "type": "Radiation", // types list is available in the plugin file "damage": 1000 } ], "itemOnLootDropSpot": "assets/content/structures/excavator/prefabs/diesel_collectable.prefab", // spawns this item on each explosion spot "dropLootList": [ // list of loot to spawn { "item": "metal.fragments", "min": 500, "max": 1000 }, { "item": "sulfur", "min": 300, "max": 1000 }, { "item": "lowgradefuel", "min": 250, "max": 500 }, { "item": "charcoal", "min": 500, "max": 1000 }, { "item": "explosives", "min": 3, "max": 12 } ] }}  

Experience the terror of a nuclear explosion with stunning visual and audio effects. A nuclear missile is launched in to the sky, it will explode near each player, simulating a personal nuke event. This catastrophic blast is accompanied by bright flashes, fireballs, dynamic fog, and radiation. After the nuke explodes, the radioactive fallout will infect 90% of the population, triggering an apocalyptic scenario and unleashing a widespread zombie outbreak!

Christmas Update
 

 
How It Works:
Nuclear Missile Launch
A nuclear missile is launched and explodes near each player
Event Warnings:
Initial Warning: Players receive an early alert about an approaching nuclear missile via a UI or Chat message warning, providing a brief window to prepare for the imminent threat. 
Second Warning: A final countdown and alert are issued just before the explosion, ensuring players are ready for the impact. These can be customized to show as a UI warning or a chat message.
Optional alarm sounds are used to enhance the urgency and realism.
Nuclear Blast and Audio Effects:
A bright flash simulates the explosion, followed by multiple explosion sound effects and fireballs representing the blast’s impact!
Fully customizable via the config file!
Radiation:
 Players not equipped with a hazmat suit will suffer from radiation poisoning. 
Hazmat suits and arctic suits offer protection against radiation.
Fully customizable via the config file!
Fog Effect:
Post-explosion, a fog effect is applied to simulate nuclear fallout. This fog gradually clears over time.
Zombie Spawning:
The explosion triggers the spawning of zombies around players, representing the fallout’s effect. Zombies appear randomly nearby and remain for a specified duration.
Post-Nuke Message:
After the explosion and initial chaos, players receive a message about the ongoing zombie threat.
Jet Care Package:
A care package will by dropped of by a jet plane at each players position. Medical supplies are set in as default. You can edit/add your own loot in the config file
 
Event Triggers:
Automatic Launch: The event can be set to trigger automatically at specified intervals.
Manual Command: Authorized players can start the event using the /nuke command.
Auto Cleanup System:
Automatic Cleanup: After the event concludes, the plugin automatically handles the removal of zombies, fog, and other temporary effects. This ensures a smooth transition back to the normal game state without manual intervention.
Key Features:
Warnings: Tailor messages and timing for initial and final alerts, with options for UI or chat notifications.
Nuke Effects: Customize visual effects, including flash intensity, fireball count, and fog density.
Radiation Protection: Configure protective clothing options and radiation settings 
Zombies: Adjust spawn radius, quantity, and active duration for zombies.
Custom Care Package: Add your own loot to spawn in the care package
AutoLaunch: Set intervals for automatic event triggers.
Auto Cleanup: Automatically clears zombies, fog, radiation and other effects 
Permissions: nukeevent.use  (Admin Only)
Command: /nuke  (Admin Only)
Console command: launchnuke  (Admin Only)
https://www.youtube.com/watch?v=lsO5ngpW-KM
Update 1.0.4: Added Jet to drop off care package. Event has been sped up in the YouTube video for testing !
https://www.youtube.com/watch?v=4CtOPzB4Cwo&t=21s
 
{ "AutoLaunch": { "EnableAutoLaunch": true, "Interval": 7200.0 }, "Countdown": { "Interval": 1.0 }, "EventSettings": { "EnableAlarmSound": true, "EnableFireballs": true, "EnableUIWarnings": true, "EnableFlashEffect": true }, "NukeSettings": { "EnableNuclearMissile": true, "NukeEffect": { "BrightDuration": 3.0, "FadeDuration": 1.5, "FadeSteps": 10, "FireballCount": 5, "FireballRadius": 75.0, "FogDuration": 300.0,//Sync with end event duration for full effect "NukeSoundDelay": 0.0, "NukeSoundPaths": [ "assets/prefabs/tools/c4/effects/c4_explosion.prefab", "assets/prefabs/weapons/satchelcharge/effects/satchel-charge-explosion.prefab", "assets/prefabs/weapons/rocketlauncher/effects/rocket_explosion.prefab", "assets/bundled/prefabs/fx/weapons/landmine/landmine_explosion.prefab", "assets/prefabs/tools/c4/effects/c4_explosion.prefab" ] } }, "RadiationSettings": { "ContinuousRadiation": false, //When enabled radiation will continuously affect players without protective clothing until the event ends "EnableRadiation": true, "RadiationDamage": 1.0, "RadiationEffect": 200.0, "RadiationLevel": 200.0 }, "RadiationProtection": { "EnableProtectiveClothing": true, "PoisonSleepingPlayers": false, "ProtectiveClothing": [ "hazmatsuit", "hazmatsuit.arcticsuit" ] }, "CarePackageSettings": { "EnableCustomLoot": true, "EnableRandomizedLoot": false, "MinItems": 1, "MaxItems": 3, "SupplyDrop": { "CustomLoot": [ { "Amount": 1, "ShortName": "hazmatsuit", "SkinID": 0 }, { "Amount": 5, "ShortName": "antiradpills", "SkinID": 0 }, { "Amount": 10, "ShortName": "bandage", "SkinID": 0 }, { "Amount": 2, "ShortName": "largemedkit", "SkinID": 0 } ] } }, "ChristmasSettings": { "EnablePresentDrop": true, "PresentDropPerZombie": 3, "EnableSupplyDropPresents": true, "PresentDropPerSupplyDrop": 2, "ZombieNpcLoadout": { "EnableCustomLoadout": true, "Attire": [ { "ItemShortName": "attire.snowman.helmet", "SkinID": 0 }, { "ItemShortName": "metal.plate.torso", "SkinID": 2833391256 }, { "ItemShortName": "hoodie", "SkinID": 2899815283 }, { "ItemShortName": "pants", "SkinID": 2899814576 }, { "ItemShortName": "roadsign.gloves", "SkinID": 2867945048 }, { "ItemShortName": "shoes.boots", "SkinID": 2490448596 } ], "Weapon": "rifle.ak", "WeaponSkinID": 0, "Ammo": "ammo.rifle", "AmmoAmount": 10000 } }, "ZombieCustomLootSettings": { "EnableCustomLoot": false, "EnableRandomizedLoot": false, "MinItems": 1, "MaxItems": 3, "CustomLoot": [ { "Amount": 1, "ShortName": "hazmatsuit", "SkinID": 0 }, { "Amount": 1, "ShortName": "supply.signal", "SkinID": 0 }, { "Amount": 1, "ShortName": "rifle.ak", "SkinID": 0 }, { "Amount": 5, "ShortName": "bandage", "SkinID": 0 } ] }, "ZombieSpawnPerPlayerSettings": { "SpawnCount": 10, "SpawnRadius": 125.0 }, "ZombieGlobalSpawnSettings": { "SpawnGlobalZombies": false,//Zombies will spawn randomly across the map rather than near each player "GlobalZombieCount": 200 //Add more zombies at your own risk }, "WarningMessageSettings": { "Warnings": { "InitialWarningDuration": 6.0, "FirstWarningMessage": "Warning: A nuclear missile has been launched! It is rapidly approaching the island. Take Cover!" }, "SecondWarning": { "SecondWarningDuration": 10.0, "SecondWarningMessage": "Nuke incoming! Brace for impact!" }, "SecondWarningDelay": 10.0, "PostNuke": { "Message": "The nuclear blast has unleashed a chilling menace! 90% of the population has been infected, transforming into deadly Snowmen. Stay alert and fight for survival!", "MessageDuration": 5.0 }, "PostRemovalMessage": "The infection is now under control. All infected snowmen have melted away.\nA care package has been dropped at your position!", "PostRemovalMessageDuration": 5.0 }, "EndEventSettings": { "EventDuration": 300.0 } }
 

BattleMessages - Transform Your Patrol Heli Fights with Custom Alerts!
BattleMessages brings your in-game battles to life with fully customizable, dynamic messages triggered by your interactions with the fearsome Patrol Helicopter. Every intense moment—from the first daring shot to the final takedown—is announced to the whole server in style, making every encounter feel epic. Whether you’re chasing down the heli or becoming its latest victim, BattleMessages amplifies the tension and excitement with immersive alerts.
What Makes BattleMessages Special?
Dynamic Messaging:
Each event triggers a different message, keeping the action unpredictable and engaging.
Whether you’re the one shooting the heli first, or watching it turn players into smoldering heaps, the plugin makes sure your server knows who’s making moves.

Customizable Content:
Don’t like the default messages? No problem. You can fully customize all messages in the plugin’s configuration files.
Switch languages (English and French included), or rewrite messages entirely to match your server’s vibe and humor.
Craft the perfect narrative for your in-game world!

Player Recognition:
Every time a player interacts with the heli, their name is featured in the broadcasted messages, adding personal stakes to every encounter.
Get your players hooked by making every victory or defeat part of the community story.
Easy Customization – Your Server, Your Style
With BattleMessages, you have complete control over how the plugin communicates. Changing the messages is as easy as editing a language file.
Go into the oxide/lang/ folder and customize the json files to your liking—change the text, the color codes, or even the language! Whether you want serious, humorous, or downright chaotic alerts, it’s all up to you.

A very interesting auto event for your server. Down with the boring old radioactive house.

Features:
Construction
- You can make any building
- The building position is level, the house will not hang in the air or spawn in the same place
Bots
- Bots turn on lights and laser sights at night, and cut them out in the morning
- It is possible to dress the NPC as you want it, as well as give them all random weapons
- You can also adjust the loot and health level of the NPC
Radiation
- It is possible to turn on radiation in the event area
Map
- It is possible to display the event on maps
Other possibilities
- There is sending notifications to the discord
- You can change any message in the lang file
- You can multiply the loot by the day of the wipe, the loot will get higher every day the wipe
- Detailed setting of everything.
- UI notifications
 

The plugin was tested for a month and a half, many problems were fixed. But if something is found, I will fix it! I am also ready to accept your suggestions, Any!
 
Sorry, but the video is in Russian

Commands:
/cl start /stop - Start / stop the event ahead of schedule (For administrators) /cl.items add - add loot to the box with prizes, then be sure to adjust the odds in the config (From your inventory) /cl.items reset Replace all old loot in the box with a new one (From your inventory) /cl.botitems add "NAME" - add the loot that will be in the bot, then you must definitely adjust the odds in the config (From your inventory) /cl.botitems reset "NAME" - completely change the old loot in the bot to the new one  
Config:
{ "Setting up and stopping an event": { "The minimum number of players to start an event": 0, "Time before the start of the event (Minimum in seconds)": 3000, "Time before the start of the event (Maximum in seconds)": 7200, "Time until the event is deleted if no one opens the box (Seconds)": 900, "The time until the event is deleted after the box is unlocked": 300, "Create a PVP zone within the radius of the event? (Requires TruePVE)": false, "Do you use a dome ?": false, "Transparency of the dome (the smaller the number, the more transparent it is. The values should be no more than 5)": 3 }, "Configuring notifications": { "Discord WebHook (If you do not need discord notifications, leave the field blank)": "", "Enable UI Notifications?": true, "Auto hide UI notifications?": true, "How long after the show will it hide? (sec)": 15.0, "UI window background color": "0.8 0.28 0.2 0.8", "UI Close Button Color": "0.6784314 0.254902 0.1843137 0.8" }, "Setting up radiation in the event area": { "Turn on radiation?": true, "Number of radiation particles": 20, "Radius of the affected area (No more than the radius of detection of players)": 20 }, "Event display on maps": { "Mark the event on the G card (Requires FREE https://umod.org/plugins/marker-manager)": true, "Text for map G": "Cobalt lab", "Marker color (without #)": "f3ecad", "Outline color (without #)": "ff3535" }, "Setting up buildings for the event (Copypaste) and NPCs": { "Spawn buildings. (If more than 1 then random is selected)": [ { "Setting the height of the building (Required in the setting if you want to place your building)": 0, "The names of the file in the folder `/oxide/data/copypaste` with your building": "HouseCobalt", "Copter spawn chance (if present in a building)": 50, "NPCs setting": [ { "Minimum": 3, "Maximum": 7, "Will they spawn as help after hacking locked crate?": true, "Number of NPCs (Help)": 3, "NPCs setting": { "Name": "Cobalt Defense", "Health": 230.0, "Roam Range": 35.0, "Chase Range": 10.0, "Attack Range Multiplier": 3.0, "Sense Range": 50.0, "Target Memory Duration [sec.]": 40.0, "Scale damage": 2.0, "Aim Cone Scale": 1.0, "Detect the target only in the NPC's viewing vision cone? [true/false]": false, "Vision Cone": 135.0, "Speed": 8.0, "Disable radio effects? [true/false]": false, "Is this a stationary NPC? [true/false]": false, "Remove a corpse after death? (it is recommended to use the true value to improve performance) [true/false]": false, "Wear items": [ { "ShortName": "roadsign.kilt", "SkinID (0 - default)": 1121447954 }, { "ShortName": "burlap.shirt", "SkinID (0 - default)": 2076298726 }, { "ShortName": "shoes.boots", "SkinID (0 - default)": 0 }, { "ShortName": "roadsign.gloves", "SkinID (0 - default)": 0 }, { "ShortName": "burlap.trousers", "SkinID (0 - default)": 2076292007 }, { "ShortName": "metal.facemask", "SkinID (0 - default)": 835028125 } ], "Belt items": [ { "ShortName": "rifle.lr300", "Amount": 1, "SkinID (0 - default)": 1837473292, "Mods": [ "weapon.mod.flashlight" ] }, { "ShortName": "pistol.semiauto", "Amount": 1, "SkinID (0 - default)": 1557105240, "Mods": [] }, { "ShortName": "syringe.medical", "Amount": 10, "SkinID (0 - default)": 0, "Mods": [] }, { "ShortName": "grenade.smoke", "Amount": 3, "SkinID (0 - default)": 0, "Mods": [] } ], "Kit": "" }, "Which loot table should the plugin use? (0 - default; 1 - own; 2 - AlphaLoot;": 1, "Own loot table (if the loot table type is 1)": { "Minimum numbers of items": 1, "Maximum numbers of items": 1, "Use minimum and maximum values? [true/false]": true, "List of items": [ { "ShortName": "scrap", "Minimum": 5, "Maximum": 10, "Chance [0.0-100.0]": 50.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "supply.signal", "Minimum": 1, "Maximum": 1, "Chance [0.0-100.0]": 20.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "syringe.medical", "Minimum": 1, "Maximum": 2, "Chance [0.0-100.0]": 70.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false } ] } }, { "Minimum": 1, "Maximum": 3, "Will they spawn as help after hacking locked crate?": false, "Number of NPCs (Help)": 0, "NPCs setting": { "Name": "Cobalt Guard", "Health": 150.0, "Roam Range": 30.0, "Chase Range": 90.0, "Attack Range Multiplier": 2.0, "Sense Range": 50.0, "Target Memory Duration [sec.]": 30.0, "Scale damage": 1.0, "Aim Cone Scale": 1.0, "Detect the target only in the NPC's viewing vision cone? [true/false]": false, "Vision Cone": 135.0, "Speed": 7.0, "Disable radio effects? [true/false]": true, "Is this a stationary NPC? [true/false]": false, "Remove a corpse after death? (it is recommended to use the true value to improve performance) [true/false]": false, "Wear items": [ { "ShortName": "roadsign.kilt", "SkinID (0 - default)": 1121447954 }, { "ShortName": "burlap.shirt", "SkinID (0 - default)": 2076298726 }, { "ShortName": "shoes.boots", "SkinID (0 - default)": 0 }, { "ShortName": "roadsign.gloves", "SkinID (0 - default)": 0 }, { "ShortName": "burlap.trousers", "SkinID (0 - default)": 2076292007 }, { "ShortName": "metal.facemask", "SkinID (0 - default)": 835028125 } ], "Belt items": [ { "ShortName": "rifle.lr300", "Amount": 1, "SkinID (0 - default)": 1837473292, "Mods": [ "weapon.mod.flashlight" ] }, { "ShortName": "pistol.semiauto", "Amount": 1, "SkinID (0 - default)": 1557105240, "Mods": [] }, { "ShortName": "syringe.medical", "Amount": 10, "SkinID (0 - default)": 0, "Mods": [] }, { "ShortName": "grenade.f1", "Amount": 3, "SkinID (0 - default)": 0, "Mods": [] } ], "Kit": "" }, "Which loot table should the plugin use? (0 - default; 1 - own; 2 - AlphaLoot;": 1, "Own loot table (if the loot table type is 1)": { "Minimum numbers of items": 1, "Maximum numbers of items": 1, "Use minimum and maximum values? [true/false]": true, "List of items": [ { "ShortName": "scrap", "Minimum": 5, "Maximum": 10, "Chance [0.0-100.0]": 50.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "supply.signal", "Minimum": 1, "Maximum": 1, "Chance [0.0-100.0]": 20.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "syringe.medical", "Minimum": 1, "Maximum": 2, "Chance [0.0-100.0]": 70.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false } ] } } ] } ] }, "Customizing the box": { "Time to unlock the Crates [sec.]": 900.0, "Which loot table should the plugin use? (0 - default; 1 - own; 2 - AlphaLoot; 3 - EcoLootUI;": 0, "Own loot table (if the loot table type is 1)": { "Minimum numbers of items": 0, "Maximum numbers of items": 0, "Use minimum and maximum values? [true/false]": false, "List of items": [ { "ShortName": "pistol.python", "Minimum": 1, "Maximum": 1, "Chance [0.0-100.0]": 60.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "multiplegrenadelauncher", "Minimum": 1, "Maximum": 1, "Chance [0.0-100.0]": 15.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "sulfur", "Minimum": 500, "Maximum": 800, "Chance [0.0-100.0]": 40.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false }, { "ShortName": "wall.external.high.ice", "Minimum": 1, "Maximum": 5, "Chance [0.0-100.0]": 75.0, "Is this a blueprint? [true/false]": false, "SkinID (0 - default)": 0, "Name (empty - default)": "", "Multiply the amount of the item by the number of days since the beginning of the wipe (on the 3rd day, the loot will be 3 times more)": false } ] }, "Turn on the alarm when breaking into a locked box ?": true }, "Reward in the form of a team to the player who 1 opened the cargo": { "List of commands that are executed in the console (%STEAMID% - the player who looted the box)": [], "Messages that the player will receive (Here you can write about what the player received)": "" }, "Setting up the selection of positions for spawn (For experienced users)": { "Allow spawn on the roads ?": true, "Allow spawn on rivers ?": true, "Radius of monument detection": 40.0, "Detection radius of the tool cupboard (Building Block)": 90.0 } }