Description

RUST Plugin Test Server
TEST MY PLUGINS THERE!

connect play.thepitereq.ovh:28050

Meteor Event plugin allows you to create custom meteor shower events on your server.
You can set up timed events that initiate a meteor shower, containing unlimited possible entities and the option to activate big rocks that require explosives to destroy.
The resources from meteors can be multiplied and modified.
Additionally, you can create custom global events with fully customized gathering sources.

• Set up custom timed events.
• Create an infinite number of meteor presets.
• Supports two types of meteors: normal and large meteors that require explosives.
• Configure various aspects such as meteor scale, yield, explosive damage, radiation, item output, and more.
• Run custom events, per-player events, and random player events.
• Number of meteors adjustable based on the online player count.
• Fully customize drops for any RUST entity and ambient events, and choose which tools are used to gather meteors.
• Players can call their own meteor showers, and you can configure random meteors to strike players while destroying regular rocks around the map.
• Features a highly configurable calling command.
• Configurable Discord webhook shower announcements
• Customizable falling angles for events.
• Set multiple different timed events.

• CarbonAliases (Required, if your server runs on Oxide)
• ServerRewards (Optional event purchase currency)
• Economics (Optional event purchase currency)
• ShoppyStock (Optional event purchase currency)
• BankSystem (Optional event purchase currency)

Chat command and console commands are the same, but console command is without forward slash.

• /ms – Opens the Meteor Event Control UI.
• msadmin run <profileName> <amount> – Starts a custom meteor shower of profile <profileName> with <amount> meteors. (Console Command)
• msadmin direct <profileName> [amount] [playerId] – Spawns [amount] meteors of profile <profileName> above [playerId]’s head. (Console Command)
• msadmin kill – Kills all meteors around the map. (Console Command)

• meteorevent.admin – Allows you to use admin features
• meteorevent.use – Allows use of the /ms command, if permission required. (Configurable)
• meteorevent.purchase.{profile.Key} – Allows to purchase & call certain meteor events. (Configurable)

• Used Economy Plugin
  0 – None
  1 – Economics
  2 – ServerRewards
  3 – BankSystem
  4 – ShoppyStock
• Explosive Config
  The key value – shortname of the damage entity, it’s not an item shortname, it’s an 3D model that’s visible in-game. For explosive ammo use ammo.rifle.explosive.

Config Walkthrough

Global Meteor Config
Configuration part for any type and any spawned meteor.

Meteor Prefabs
This is a full list of available meteors that can fall from the sky. Here is a default list of them:

•  barrel – The Big Barrel Event Prefab. It’s a very big barrel with a fully custom gather method that contains 2000 Scrap and 10,000 Metal by default.
•  falling_star – The ambient event that runs sometimes in the sky but never falls onto the ground. All it does is spawn falling stars in the sky, so you can have a cool effects at night.
•  metal_ore – Regular metal ore meteor prefab.
•  stone_ore – Regular stone ore meteor prefab.
•  sulfur_ore – Regular sulfur ore meteor prefab.
•  toilet – Funny meteor that was made during plugin development. It also contains a fully custom gather that contains HQM and Metal.

Meteor Profiles
This part of the config is what’s visible when you open the /ms command. If you want to make a working meteor event, you need to add a new section here. By default, there are 4 profiles:

•  barrel – Runs Big Barrel Event that contains “barrel” prefabs.
•  default – Runs regular Meteor Event that contains “metal_ore”, “stone_ore” and “sulfur_ore” prefabs.
•  falling_stars – Runs Falling Stars Event that contains “falling_star” prefabs.
•  toilets – Runs Falling Stars Event that contains “toilet” prefabs.

IMPORTANT! 
The keys in `Meteor Profiles And Spawn Weights (profile: spawn weight)` must be equal to the keys in the `Meteor Prefabs` section, or the plugin won’t work correctly!
The Angle in the Falling Angle Config represents how fast and in which direction the meteors are falling. X and Z are diagonal values, and Y is a vertical value. Making values higher will make meteors fall faster, and the opposite.

Timed Events
Random timed events for your server. You don’t need to put all Meteor Profiles here, just those that you want to make automatic.

Enable Random Direct Falling Meteors On Mining Regular Ones and Random Direct Falling Meteor Options
This option will mean that if a player breaks a regular meteor on the map, there will be a chance to call a direct meteor on him. The default config contains an annotation to the “default” meteor profile, but this event takes 30 seconds by default, so the meteor will fall in the next 30 seconds, not instantaneously.

• void OnMeteorShowerStart(int meteorAmount, string profile, bool isDirect, BasePlayer directPlayer)
• void OnFallingMeteorSpawned(string meteorPrefabKey, SphereEntity parentEntity, BaseEntity meteorEntity)
• void OnMeteorLanded(BaseEntity meteorEntity, string meteorPrefabKey)
• void OnMeteorsKilled()

View the example configuration by clicking here!