CratesEventReborn 4.4.0

Description

CratesEventReborn is a revised and modernized version of the original CratesEvent plugin, which was developed by FuZZED. Since the original developer is no longer active and no longer offers support, the plugin has been completely revised and updated by me to adapt it to current requirements. The plugin allows server administrators to start an exciting event where locked chests are spawned at random monuments to stimulate player activity. My players loved it, so I developed it from scratch. The new event I created has the advantage that it is now attractive for both PvP and PvE servers. When set to PvE, NPC's are now generated in addition to the crates. In PvP the players fight each other for the crates.

Features:

- Compatibility with modern Rust versions: Completely reworked to work with the latest Oxide API and new monuments.

- Random Monuments: Crates are spawned at random monuments such as Launch Site, Dome, Train Yard, Water Treatment, Radtown or Junkyard.

- Configurable Monuments: Each monument can be individually enabled or disabled.

- Predefined crate positions: Optimized and precise spawn points.

- Broadcasts: Players are informed by server messages when an event starts.

- Automatic cleanup function: When starting a new event or unloading the plugin, all active crates are removed to avoid problems.

- Easy to use: Control via chat and console commands.

from v.3.0.0

- PvE Mode (NEW): Optional PvE mode where NPCs guard the crates, making the event more challenging for players.

- Customizable NPC settings (NEW) Configure health, patrol distance, attack range, movement speed, damage and more.

- Customizable NPC Appearance (NEW): Full NPC attire that matches the event.

Commands:

Chat command:

`/flashcratesevent` - Starts a Crate event. Only players with the appropriate permissions can execute this command.

`stopcratesevent` - Stops an ongoing event and removes all event items and NPCs.

Console command:

`flashcratesevent` - Starts the event directly from the server console, ideal for admins.

`stopcratesevent` - Stops an ongoing event and removes all event items and NPCs.

Permissions:

`crateseventreborn.admin` - This authorization is required to start the event. Only users with this authorization can execute the commands.

Configuration:
 

{

  "ModePvE": false,

  "Use Notify RustFlash Plugin": false,

  "NPCs per Crate": 2,

  "NPC Health": 350.0,

  "NPC Patrol Distance": 20.0,

  "NPC Aggression Distance": 35.0,

  "NPC Movement Speed": 3.0,

  "NPC Damage Scale": 1.0,

  "NPC Attack Range Multiplier": 1.0,

  "NPC Vision Cone": 135.0,

  "NPC Memory Duration": 10.0,

  "NPC Weapons": [

    "rifle.ak",

    "rifle.lr300",

    "rifle.bolt",

    "shotgun.pump"

  ],

  "Enabled Monuments": {

    "Launch Site": true,

    "Dome": true,

    "Train Yard": true,

    "Water Treatment": true,

    "Radtown": true,

    "Junkyard": true

  }

}

Configuration Options:

* **ModePvE** - Enable/disable NPC guards (true/false)

* **Use Notify RustFlash Plugin** - Use the Notify plugin for notifications instead of the default chat messages (requires the Notify plugin)

* **NPCs per Crate** - Number of NPCs spawned around each crate

* **NPC Health** - Health points of each NPC

* **NPC Patrol Distance** - Maximum distance NPCs will patrol from their crate

* **NPC Aggression Distance** - Distance at which NPCs will detect and engage players

* **NPC Movement Speed** - Movement speed of NPCs (default player is ~5.5)

* **NPC Damage Scale** - Damage multiplier for NPC attacks

* **NPC Attack Range Multiplier** - Multiplier for NPC attack range

* **NPC Vision Cone** - Angle of NPC vision cone in degrees

* **NPC Memory Duration** - How long NPCs remember players after losing sight

* **NPC Weapons** - Array of weapon shortnames NPCs can use

* **Enabled Monuments** - Enable/disable individual monuments (Launch Site, Dome, Train Yard, Water Treatment, Radtown, Junkyard)

Dependencies:

**MonumentFinder** plugin:

Needed to find monuments on the map and calculate precise transformation points for crate spawns. CratesEventReborn does not work without this plugin.

**NpcSpawn** plugin *(NEW v.3.0.0)*:

Required for spawning and controlling NPC guards. Install this plugin for the NPC feature to work.

**Notify** plugin *(optional)*:

If installed and enabled via `"Use Notify RustFlash Plugin"`, event notifications are sent through the Notify plugin instead of the default chat messages.

Improvements compared to the original:

* Code optimization: Old, outdated methods have been replaced with modern Rust and Oxide functions.

* Bug fixes: Bugs from the original plugin have been fixed to ensure stability and compatibility.

* Expanded monument support: Additional spawn points and more flexible customization options for crates.

* NPC Guards: Added the ability to spawn NPCs that guard the crates, making events more challenging.

* PvE Mode: Added a PvE-oriented mode with AI defenders.

* Customizable NPC behavior: Fine-tune the difficulty by adjusting NPC settings.

* Improved communication: Informative and customizable broadcasts for events.

* Security updates: Ensures crates and NPCs are properly removed to conserve resources.

**load, run, enjoy**