Tikomatura's Wishlist
-
Meteor Event
By ThePitereq in Plugins
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.
/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)
Configuration Hints
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) - When meteor event is starting. void OnFallingMeteorSpawned(string meteorPrefabKey, SphereEntity parentEntity, BaseEntity meteorEntity) - When falling meteor has been spawned. void OnMeteorLanded(BaseEntity meteorEntity, string meteorPrefabKey) - When meteor lands on the ground. void OnMeteorsKilled() - When all meteors are removed. void OnFallingMeteorsKilled() - Ran when last still falling meteor is destroyed.
{ "Commands": [ "ms", "meteor" ], "Command Require Permission": false, "Enable Logs": true, "Enable Plugin Hooks": false, "Global Meteor Config": { "Destroy Meteors Underwater": false, "Destroy Trees On Impact Radius (0 to disable)": 25.0, "Max Meteors On Map At One Time": 80, "Falling Meteor Ground Check Radius (increase might be required if meteors are falling slowly)": 25.0, "Kill Meteors On Roads": true, "Kill Meteors On Rail Tracks": true, "Kill Meteors On Monuments": false, "Fix For Meteor MeshCollider Message (console spam fix only, might have performance impact if enabled)": false, "Meteor Spread On Map (higher = smaller impact radius)": 2.5, "Explosive Ammo Max Shoot Distance": 50.0 }, "Meteor Prefabs": { "barrel": { "Meteor Prefab Path": "assets/bundled/prefabs/radtown/loot_barrel_1.prefab", "Max Meteor Flight Time (0, to not destroy)": 0.0, "Meteor Lifetime (0, to not destroy)": 1800.0, "Minimum Scale": 12.0, "Maximum Scale": 12.0, "Yield Multiplier": 2.0, "Scale Yield By Size": true, "Meteor Radiation Chance (0-100)": 100.0, "Meteor Radiation Amount": 12.5, "Scale Radiation With Size": true, "Run Atmosphere Enter Sound": true, "Enable Meteor Flame": true, "Enable Meteor Smoke": true, "Falling - Randomize Meteor X Rotation": false, "Falling - Randomize Meteor Y Rotation": true, "Falling - Randomize Meteor Z Rotation": false, "Landed - Randomize Meteor X Rotation": false, "Landed - Randomize Meteor Y Rotation": true, "Landed - Randomize Meteor Z Rotation": false, "Landed Entity Offset": { "x": 0.0, "y": 0.0, "z": 0.0 }, "Required Tool To Destroy - Whitelist (shortnames)": [], "Required Tool To Destroy - Blacklist (shortnames)": [], "Fully Custom Gather System Tools": { "Items Per Meteor": [ { "Shortname": "scrap", "Skin ID": 0, "Amount": 2000, "Display Name": "", "Only On Last Hit": false }, { "Shortname": "metal.fragments", "Skin ID": 0, "Amount": 10000, "Display Name": "", "Only On Last Hit": false } ], "Fully Custom Gather System Tools (key value is tool shortname)": { "hammer.salvaged": { "Require Exact Skin ID": false, "Tool Skin ID": 0, "Tool Damage Dealt Percentage": 3.0 } } }, "Additional Output Per Hit": [], "Big Meteor Config": { "Chance (0-100)": 0.0, "Minimum Scale": 5.0, "Maximum Scale": 7.0, "Output Per Hit": [], "Call OnDispenserGather hook": true, "Explosive Config (key value is explosive prefab shortname, see website for more info)": {}, "Crate Inside Chance (0-100)": 0.0, "Crates Spawned Inside (prefab names: spawn weight)": {} }, "Marker Config": { "Marker Type (None/Normal/Explosion)": "Normal", "Marker Alpha (normal only)": 0.75, "Marker Color #1 (normal only)": "#E0D5C30", "Marker Color #2 (normal only)": "#6E665A", "Marker Radius (normal only)": 0.15, "Map Marker Text (normal only, disabled if empty)": "Space Barrel" } }, "falling_star": { "Meteor Prefab Path": "assets/bundled/prefabs/modding/cinematic/cinelights/cinelight_point_cool.prefab", "Max Meteor Flight Time (0, to not destroy)": 1.5, "Meteor Lifetime (0, to not destroy)": 30.0, "Minimum Scale": 2.0, "Maximum Scale": 5.0, "Yield Multiplier": 2.0, "Scale Yield By Size": true, "Meteor Radiation Chance (0-100)": 0.0, "Meteor Radiation Amount": 0.0, "Scale Radiation With Size": true, "Run Atmosphere Enter Sound": false, "Enable Meteor Flame": false, "Enable Meteor Smoke": false, "Falling - Randomize Meteor X Rotation": true, "Falling - Randomize Meteor Y Rotation": true, "Falling - Randomize Meteor Z Rotation": true, "Landed - Randomize Meteor X Rotation": false, "Landed - Randomize Meteor Y Rotation": true, "Landed - Randomize Meteor Z Rotation": false, "Landed Entity Offset": { "x": 0.0, "y": 0.0, "z": 0.0 }, "Required Tool To Destroy - Whitelist (shortnames)": [], "Required Tool To Destroy - Blacklist (shortnames)": [], "Fully Custom Gather System Tools": { "Items Per Meteor": [], "Fully Custom Gather System Tools (key value is tool shortname)": {} }, "Additional Output Per Hit": [], "Big Meteor Config": { "Chance (0-100)": 0.0, "Minimum Scale": 5.0, "Maximum Scale": 7.0, "Output Per Hit": [], "Call OnDispenserGather hook": true, "Explosive Config (key value is explosive prefab shortname, see website for more info)": {}, "Crate Inside Chance (0-100)": 0.0, "Crates Spawned Inside (prefab names: spawn weight)": {} }, "Marker Config": { "Marker Type (None/Normal/Explosion)": "Explosion", "Marker Alpha (normal only)": 0.75, "Marker Color #1 (normal only)": "#E01300", "Marker Color #2 (normal only)": "#7D0B00", "Marker Radius (normal only)": 0.4, "Map Marker Text (normal only, disabled if empty)": "" } }, "metal_ore": { "Meteor Prefab Path": "assets/bundled/prefabs/autospawn/resource/ores/metal-ore.prefab", "Max Meteor Flight Time (0, to not destroy)": 0.0, "Meteor Lifetime (0, to not destroy)": 1800.0, "Minimum Scale": 0.5, "Maximum Scale": 2.0, "Yield Multiplier": 2.0, "Scale Yield By Size": true, "Meteor Radiation Chance (0-100)": 0.0, "Meteor Radiation Amount": 0.0, "Scale Radiation With Size": true, "Run Atmosphere Enter Sound": true, "Enable Meteor Flame": true, "Enable Meteor Smoke": true, "Falling - Randomize Meteor X Rotation": true, "Falling - Randomize Meteor Y Rotation": true, "Falling - Randomize Meteor Z Rotation": true, "Landed - Randomize Meteor X Rotation": false, "Landed - Randomize Meteor Y Rotation": true, "Landed - Randomize Meteor Z Rotation": false, "Landed Entity Offset": { "x": 0.0, "y": 0.0, "z": 0.0 }, "Required Tool To Destroy - Whitelist (shortnames)": [], "Required Tool To Destroy - Blacklist (shortnames)": [ "rock", "stone.pickaxe" ], "Fully Custom Gather System Tools": { "Items Per Meteor": [], "Fully Custom Gather System Tools (key value is tool shortname)": {} }, "Additional Output Per Hit": [ { "Required Gather Per Hit (0 to disable)": 20, "Shortname": "metal.ore", "Skin ID": 0, "Amount": 35, "Display Name": "", "Chance (0-100)": 35.0, "Only On Last Hit": false }, { "Required Gather Per Hit (0 to disable)": 20, "Shortname": "metal.refined", "Skin ID": 0, "Amount": 2, "Display Name": "", "Chance (0-100)": 2.0, "Only On Last Hit": false } ], "Big Meteor Config": { "Chance (0-100)": 5.0, "Minimum Scale": 5.0, "Maximum Scale": 7.0, "Output Per Hit": [ { "Shortname": "metal.ore", "Skin ID": 0, "Amount": 900, "Display Name": "", "Chance (0-100)": 100.0, "Only On Last Hit": false }, { "Shortname": "hq.metal.ore", "Skin ID": 0, "Amount": 20, "Display Name": "", "Chance (0-100)": 100.0, "Only On Last Hit": true } ], "Call OnDispenserGather hook": true, "Explosive Config (key value is explosive prefab shortname, see website for more info)": { "ammo.rifle.explosive": { "Damage Dealt": 5.0, "Resource Multiplier": 0.1 }, "explosive.timed.deployed": { "Damage Dealt": 50.0, "Resource Multiplier": 1.0 }, "rocket_basic": { "Damage Dealt": 35.0, "Resource Multiplier": 0.7 } }, "Crate Inside Chance (0-100)": 5.0, "Crates Spawned Inside (prefab names: spawn weight)": { "assets/bundled/prefabs/radtown/crate_normal.prefab": 3, "assets/bundled/prefabs/radtown/crate_normal_2.prefab": 5, "assets/prefabs/misc/supply drop/supply_drop.prefab": 1 } }, "Marker Config": { "Marker Type (None/Normal/Explosion)": "Normal", "Marker Alpha (normal only)": 0.75, "Marker Color #1 (normal only)": "#E01300", "Marker Color #2 (normal only)": "#7D0B00", "Marker Radius (normal only)": 0.15, "Map Marker Text (normal only, disabled if empty)": "" } }, "stone_ore": { "Meteor Prefab Path": "assets/bundled/prefabs/autospawn/resource/ores/stone-ore.prefab", "Max Meteor Flight Time (0, to not destroy)": 0.0, "Meteor Lifetime (0, to not destroy)": 1800.0, "Minimum Scale": 0.5, "Maximum Scale": 2.0, "Yield Multiplier": 2.0, "Scale Yield By Size": true, "Meteor Radiation Chance (0-100)": 0.0, "Meteor Radiation Amount": 0.0, "Scale Radiation With Size": true, "Run Atmosphere Enter Sound": true, "Enable Meteor Flame": true, "Enable Meteor Smoke": true, "Falling - Randomize Meteor X Rotation": true, "Falling - Randomize Meteor Y Rotation": true, "Falling - Randomize Meteor Z Rotation": true, "Landed - Randomize Meteor X Rotation": false, "Landed - Randomize Meteor Y Rotation": true, "Landed - Randomize Meteor Z Rotation": false, "Landed Entity Offset": { "x": 0.0, "y": 0.0, "z": 0.0 }, "Required Tool To Destroy - Whitelist (shortnames)": [], "Required Tool To Destroy - Blacklist (shortnames)": [ "rock", "stone.pickaxe" ], "Fully Custom Gather System Tools": { "Items Per Meteor": [], "Fully Custom Gather System Tools (key value is tool shortname)": {} }, "Additional Output Per Hit": [ { "Required Gather Per Hit (0 to disable)": 20, "Shortname": "stones", "Skin ID": 0, "Amount": 50, "Display Name": "", "Chance (0-100)": 35.0, "Only On Last Hit": false }, { "Required Gather Per Hit (0 to disable)": 20, "Shortname": "metal.refined", "Skin ID": 0, "Amount": 2, "Display Name": "", "Chance (0-100)": 2.0, "Only On Last Hit": false } ], "Big Meteor Config": { "Chance (0-100)": 5.0, "Minimum Scale": 5.0, "Maximum Scale": 7.0, "Output Per Hit": [ { "Shortname": "stones", "Skin ID": 0, "Amount": 1500, "Display Name": "", "Chance (0-100)": 100.0, "Only On Last Hit": false } ], "Call OnDispenserGather hook": true, "Explosive Config (key value is explosive prefab shortname, see website for more info)": { "ammo.rifle.explosive": { "Damage Dealt": 5.0, "Resource Multiplier": 0.1 }, "explosive.timed.deployed": { "Damage Dealt": 50.0, "Resource Multiplier": 1.0 }, "rocket_basic": { "Damage Dealt": 35.0, "Resource Multiplier": 0.7 } }, "Crate Inside Chance (0-100)": 5.0, "Crates Spawned Inside (prefab names: spawn weight)": { "assets/bundled/prefabs/radtown/crate_normal.prefab": 3, "assets/bundled/prefabs/radtown/crate_normal_2.prefab": 5, "assets/prefabs/misc/supply drop/supply_drop.prefab": 1 } }, "Marker Config": { "Marker Type (None/Normal/Explosion)": "Normal", "Marker Alpha (normal only)": 0.75, "Marker Color #1 (normal only)": "#E01300", "Marker Color #2 (normal only)": "#7D0B00", "Marker Radius (normal only)": 0.15, "Map Marker Text (normal only, disabled if empty)": "" } }, "sulfur_ore": { "Meteor Prefab Path": "assets/bundled/prefabs/autospawn/resource/ores/sulfur-ore.prefab", "Max Meteor Flight Time (0, to not destroy)": 0.0, "Meteor Lifetime (0, to not destroy)": 1800.0, "Minimum Scale": 0.5, "Maximum Scale": 2.0, "Yield Multiplier": 2.0, "Scale Yield By Size": true, "Meteor Radiation Chance (0-100)": 0.0, "Meteor Radiation Amount": 0.0, "Scale Radiation With Size": true, "Run Atmosphere Enter Sound": true, "Enable Meteor Flame": true, "Enable Meteor Smoke": true, "Falling - Randomize Meteor X Rotation": true, "Falling - Randomize Meteor Y Rotation": true, "Falling - Randomize Meteor Z Rotation": true, "Landed - Randomize Meteor X Rotation": false, "Landed - Randomize Meteor Y Rotation": true, "Landed - Randomize Meteor Z Rotation": false, "Landed Entity Offset": { "x": 0.0, "y": 0.0, "z": 0.0 }, "Required Tool To Destroy - Whitelist (shortnames)": [], "Required Tool To Destroy - Blacklist (shortnames)": [ "rock", "stone.pickaxe" ], "Fully Custom Gather System Tools": { "Items Per Meteor": [], "Fully Custom Gather System Tools (key value is tool shortname)": {} }, "Additional Output Per Hit": [ { "Required Gather Per Hit (0 to disable)": 20, "Shortname": "sulfur.ore", "Skin ID": 0, "Amount": 20, "Display Name": "", "Chance (0-100)": 35.0, "Only On Last Hit": false }, { "Required Gather Per Hit (0 to disable)": 20, "Shortname": "metal.refined", "Skin ID": 0, "Amount": 2, "Display Name": "", "Chance (0-100)": 2.0, "Only On Last Hit": false } ], "Big Meteor Config": { "Chance (0-100)": 5.0, "Minimum Scale": 5.0, "Maximum Scale": 7.0, "Output Per Hit": [ { "Shortname": "sulfur.ore", "Skin ID": 0, "Amount": 450, "Display Name": "", "Chance (0-100)": 100.0, "Only On Last Hit": false } ], "Call OnDispenserGather hook": true, "Explosive Config (key value is explosive prefab shortname, see website for more info)": { "ammo.rifle.explosive": { "Damage Dealt": 5.0, "Resource Multiplier": 0.1 }, "explosive.timed.deployed": { "Damage Dealt": 50.0, "Resource Multiplier": 1.0 }, "rocket_basic": { "Damage Dealt": 35.0, "Resource Multiplier": 0.7 } }, "Crate Inside Chance (0-100)": 5.0, "Crates Spawned Inside (prefab names: spawn weight)": { "assets/bundled/prefabs/radtown/crate_normal.prefab": 3, "assets/bundled/prefabs/radtown/crate_normal_2.prefab": 5, "assets/prefabs/misc/supply drop/supply_drop.prefab": 1 } }, "Marker Config": { "Marker Type (None/Normal/Explosion)": "Normal", "Marker Alpha (normal only)": 0.75, "Marker Color #1 (normal only)": "#E01300", "Marker Color #2 (normal only)": "#7D0B00", "Marker Radius (normal only)": 0.15, "Map Marker Text (normal only, disabled if empty)": "" } }, "toilet": { "Meteor Prefab Path": "assets/bundled/prefabs/static/toilet_b.static.prefab", "Max Meteor Flight Time (0, to not destroy)": 0.0, "Meteor Lifetime (0, to not destroy)": 1800.0, "Minimum Scale": 1.2, "Maximum Scale": 3.0, "Yield Multiplier": 2.0, "Scale Yield By Size": true, "Meteor Radiation Chance (0-100)": 100.0, "Meteor Radiation Amount": 12.5, "Scale Radiation With Size": true, "Run Atmosphere Enter Sound": true, "Enable Meteor Flame": true, "Enable Meteor Smoke": true, "Falling - Randomize Meteor X Rotation": true, "Falling - Randomize Meteor Y Rotation": true, "Falling - Randomize Meteor Z Rotation": true, "Landed - Randomize Meteor X Rotation": false, "Landed - Randomize Meteor Y Rotation": true, "Landed - Randomize Meteor Z Rotation": false, "Landed Entity Offset": { "x": 0.0, "y": 0.0, "z": 0.0 }, "Required Tool To Destroy - Whitelist (shortnames)": [], "Required Tool To Destroy - Blacklist (shortnames)": [], "Fully Custom Gather System Tools": { "Items Per Meteor": [ { "Shortname": "metal.refined", "Skin ID": 0, "Amount": 300, "Display Name": "", "Only On Last Hit": false }, { "Shortname": "metal.fragments", "Skin ID": 0, "Amount": 5000, "Display Name": "", "Only On Last Hit": false } ], "Fully Custom Gather System Tools (key value is tool shortname)": { "hammer.salvaged": { "Require Exact Skin ID": false, "Tool Skin ID": 0, "Tool Damage Dealt Percentage": 3.0 }, "paddle": { "Require Exact Skin ID": false, "Tool Skin ID": 0, "Tool Damage Dealt Percentage": 2.5 } } }, "Additional Output Per Hit": [], "Big Meteor Config": { "Chance (0-100)": 5.0, "Minimum Scale": 5.0, "Maximum Scale": 7.0, "Output Per Hit": [ { "Shortname": "metal.refined", "Skin ID": 0, "Amount": 50, "Display Name": "", "Chance (0-100)": 100.0, "Only On Last Hit": false } ], "Call OnDispenserGather hook": true, "Explosive Config (key value is explosive prefab shortname, see website for more info)": { "ammo.rifle.explosive": { "Damage Dealt": 5.0, "Resource Multiplier": 0.1 }, "explosive.timed.deployed": { "Damage Dealt": 50.0, "Resource Multiplier": 1.0 }, "rocket_basic": { "Damage Dealt": 35.0, "Resource Multiplier": 0.7 } }, "Crate Inside Chance (0-100)": 0.0, "Crates Spawned Inside (prefab names: spawn weight)": {} }, "Marker Config": { "Marker Type (None/Normal/Explosion)": "Normal", "Marker Alpha (normal only)": 0.75, "Marker Color #1 (normal only)": "#E0D5C30", "Marker Color #2 (normal only)": "#6E665A", "Marker Radius (normal only)": 0.15, "Map Marker Text (normal only, disabled if empty)": "Space Toilet" } } }, "Meteor Profiles": { "barrel": { "Randomized Impact Radius (if direct meteor)": 10.0, "Direct Meteor Falling Angle": { "x": 0.0, "y": -2.0, "z": 0.0 }, "Meteor Event Length (in seconds)": 10.0, "Incoming Shower Sound Effect Prefab (disabled if empty)": "assets/prefabs/tools/pager/effects/beep.prefab", "Send Message About Meteor Event On Chat": true, "Spawn Height": 500.0, "Falling Angle Config": [ { "Appear Weight": 1, "Angle": { "x": 0.0, "y": -0.6, "z": 0.0 }, "Falling Radius Offset": { "x": 0.0, "y": 0.0, "z": 0.0 } } ], "Meteor Profiles And Spawn Weights (profile: spawn weight)": { "barrel": 1 }, "Purchase Config": { "Allow Purchasing": false, "Used Economy Plugin (see website for reference)": 0, "Used Economy Currency (if ShoppyStock used)": "rp", "Required Permission": true, "Direct Meteor Shower (on player)": false, "Allow To Spawn Large Meteors": false, "Meteors Amount": 10, "Item Shortname Required To Purchase Meteor Shower (empty if currency)": "scrap", "Item Skin ID Required To Purchase Meteor Shower (empty if currency)": 0, "Item/Currency Amount Required To Purchase Meteor Shower": 1000, "Cooldown After Purchasing Meteor Shower (in seconds)": 3600 } }, "default": { "Randomized Impact Radius (if direct meteor)": 10.0, "Direct Meteor Falling Angle": { "x": 0.0, "y": -9.0, "z": 0.0 }, "Meteor Event Length (in seconds)": 30.0, "Incoming Shower Sound Effect Prefab (disabled if empty)": "assets/prefabs/tools/pager/effects/beep.prefab", "Send Message About Meteor Event On Chat": true, "Spawn Height": 500.0, "Falling Angle Config": [ { "Appear Weight": 1, "Angle": { "x": 3.5, "y": -4.6, "z": 0.0 }, "Falling Radius Offset": { "x": -300.0, "y": 0.0, "z": 0.0 } }, { "Appear Weight": 1, "Angle": { "x": -3.5, "y": -4.6, "z": 1.2 }, "Falling Radius Offset": { "x": 300.0, "y": 0.0, "z": -100.0 } } ], "Meteor Profiles And Spawn Weights (profile: spawn weight)": { "metal_ore": 1, "stone_ore": 1, "sulfur_ore": 1 }, "Purchase Config": { "Allow Purchasing": true, "Used Economy Plugin (see website for reference)": 0, "Used Economy Currency (if ShoppyStock used)": "rp", "Required Permission": true, "Direct Meteor Shower (on player)": true, "Allow To Spawn Large Meteors": false, "Meteors Amount": 3, "Item Shortname Required To Purchase Meteor Shower (empty if currency)": "scrap", "Item Skin ID Required To Purchase Meteor Shower (empty if currency)": 0, "Item/Currency Amount Required To Purchase Meteor Shower": 1000, "Cooldown After Purchasing Meteor Shower (in seconds)": 3600 } }, "falling_stars": { "Randomized Impact Radius (if direct meteor)": 10.0, "Direct Meteor Falling Angle": { "x": 0.0, "y": -9.0, "z": 0.0 }, "Meteor Event Length (in seconds)": 60.0, "Incoming Shower Sound Effect Prefab (disabled if empty)": "", "Send Message About Meteor Event On Chat": false, "Spawn Height": 500.0, "Falling Angle Config": [ { "Appear Weight": 1, "Angle": { "x": 45.5, "y": -4.2, "z": 12.7 }, "Falling Radius Offset": { "x": 0.0, "y": 0.0, "z": 0.0 } }, { "Appear Weight": 1, "Angle": { "x": -56.5, "y": -3.2, "z": -14.2 }, "Falling Radius Offset": { "x": 0.0, "y": 0.0, "z": 0.0 } } ], "Meteor Profiles And Spawn Weights (profile: spawn weight)": { "falling_star": 1 }, "Purchase Config": { "Allow Purchasing": false, "Used Economy Plugin (see website for reference)": 0, "Used Economy Currency (if ShoppyStock used)": "rp", "Required Permission": true, "Direct Meteor Shower (on player)": false, "Allow To Spawn Large Meteors": false, "Meteors Amount": 10, "Item Shortname Required To Purchase Meteor Shower (empty if currency)": "scrap", "Item Skin ID Required To Purchase Meteor Shower (empty if currency)": 0, "Item/Currency Amount Required To Purchase Meteor Shower": 1000, "Cooldown After Purchasing Meteor Shower (in seconds)": 3600 } }, "toilets": { "Randomized Impact Radius (if direct meteor)": 10.0, "Direct Meteor Falling Angle": { "x": 0.0, "y": -9.0, "z": 0.0 }, "Meteor Event Length (in seconds)": 60.0, "Incoming Shower Sound Effect Prefab (disabled if empty)": "assets/prefabs/tools/pager/effects/beep.prefab", "Send Message About Meteor Event On Chat": true, "Spawn Height": 500.0, "Falling Angle Config": [ { "Appear Weight": 1, "Angle": { "x": 3.5, "y": -4.6, "z": 0.0 }, "Falling Radius Offset": { "x": -300.0, "y": 0.0, "z": 0.0 } }, { "Appear Weight": 1, "Angle": { "x": -3.5, "y": -4.6, "z": 1.2 }, "Falling Radius Offset": { "x": 300.0, "y": 0.0, "z": -100.0 } } ], "Meteor Profiles And Spawn Weights (profile: spawn weight)": { "toilet": 1 }, "Purchase Config": { "Allow Purchasing": false, "Used Economy Plugin (see website for reference)": 0, "Used Economy Currency (if ShoppyStock used)": "rp", "Required Permission": true, "Direct Meteor Shower (on player)": false, "Allow To Spawn Large Meteors": false, "Meteors Amount": 10, "Item Shortname Required To Purchase Meteor Shower (empty if currency)": "scrap", "Item Skin ID Required To Purchase Meteor Shower (empty if currency)": 0, "Item/Currency Amount Required To Purchase Meteor Shower": 1000, "Cooldown After Purchasing Meteor Shower (in seconds)": 3600 } } }, "Timed Events": { "default": { "Event Every X Seconds (minimal time, in seconds)": 1200, "Event Every X Seconds (maximal time, in seconds)": 2400, "Used Meteor Config Keys (profile: spawn weight)": { "default": 10, "falling_stars": 1 }, "Direct Meteors To Players": false, "Meteor Amount Based On Player Count": true, "Meteor Count (if based on player count - per player)": 4.0, "Max Meteor Count": 40, "Chance To Start Event (0-100)": 100.0, "Commands Ran On Start": [], "Webhook Message": { "Enabled": false, "Embed": true, "Webhook": "", "Inline": true, "Color": 0, "Title": "Meteor Shower", "Message": "Meteor Shower with {0} meteors is incoming!" } }, "toilets": { "Event Every X Seconds (minimal time, in seconds)": 28800, "Event Every X Seconds (maximal time, in seconds)": 50400, "Used Meteor Config Keys (profile: spawn weight)": { "toilets": 1 }, "Direct Meteors To Players": true, "Meteor Amount Based On Player Count": false, "Meteor Count (if based on player count - per player)": 10.0, "Max Meteor Count": 10, "Chance To Start Event (0-100)": 5.0, "Commands Ran On Start": [ "say There is {meteorCount} falling toilets in the sky!" ], "Webhook Message": { "Enabled": false, "Embed": true, "Webhook": "", "Inline": true, "Color": 0, "Title": "Meteor Shower", "Message": "Meteor Shower with {0} meteors is incoming!" } } }, "Enable Random Direct Falling Meteors On Mining Regular Ones": true, "Random Direct Falling Meteor Options": [ { "Spawn Chance (0-100)": 1.0, "Meteor Profile Name (not prefab key)": "default", "Meteor Min Amount": 1, "Meteor Max Amount": 3, "Allow To Spawn Large Meteors": false }, { "Spawn Chance (0-100)": 0.0, "Meteor Profile Name (not prefab key)": "toilets", "Meteor Min Amount": 1, "Meteor Max Amount": 3, "Allow To Spawn Large Meteors": false } ] } -
Shipwreck
This plugin will allow players to visit the depths of the ocean to discover 3 new locations included in this plugin: a Sunken Cargo Ship, Submerged Ore Farm, and a Shipwrecked Barge.
In the wreckage you will find a high concentration of loot. Just be careful! The COBALT group has already arrived and is exploring the site.
They have submarines and divers already in the water!
Patrol Submarines
Subs do a LOT of damage, but they have low visibility and low accuracy. Very unreliable at Titanic depths. Subs are a serious threat if you arrive in a submarine yourself. Try to sneak up behind them and destroy them, you don't want to be the one to sink, trust me!
Cobalt NPC Divers
High accuracy, but not much armor and don't pack a huge punch. Almost harmless if you arrive in a submarine, but they are still a threat! Keep your eyes on these guys, it might just be you or them!
Killer Sharks
These sharks have smelled all the blood in the water, after being drawn to the area already by all of the disturbance. They are here, they are mad, and they are bloodthirsty and hungry!
The plugin includes 3 locations:
Shipwrecked Cargo Ship
There are three rooms in the Sunken Cargo Ship location that are opened with a keycard. The map type can be selected within the configuration file.
Sunken Barge
A great place to find some Shipping Containers, as well as Killer Sharks! The Cobalt group has been busy in this area, they must have taken this Barge down recently as well.
Submerged Ore Farm
An ore rich location with multiple farmable ore nodes, as well as some other scattered loot including fuel barrels.
Chat commands (only for administrators)
/shipwreckstart – launches the event in a random configuration /shipwreckstart <shipwreckstart> – launches the event in the <eventPresetName> configuration /shipwreckstartmyloc – launches the event in a random configuration in your location /shipwreckstartmyloc<shipwreckstart> – launches the event in the <eventPresetName> configuration in your location /shipwreckstop – stops the event /screatepath– starts recording the route for the npc/shark/sub /ssavepath <npc/shark/subPresetName> – saves route for npcs/sharks/sub /scancelpath – cancels route recording Console commands (RCON only)
shipwreckstart – launches the event in a random configuration shipwreckstart <shipwreckstart> – launches the event in the <eventPresetName> configuration shipwreckstop – stops the event Config
plugin_en – example of plugin configuration in English location_en – example of location configuration in English plugin_ru – example of plugin configuration in Russian location_ru – example of location configuration in Russian Dependencies (optional, not required)
True PVE PveMode GUI Announcements Notify DiscordMessages AlphaLoot CustomLoot Economics Server Rewards IQEconomic Hooks
void OnShipwreckStart() void OnShipwreckStop()
My Discord: adem9554
Join the Mad Mappers Discord here!
Check out more of my work here!
-
MBPromoCode
By Barry_Allenn in Plugins
🎁 MBPromoCode — Modern Promo Code System for Rust
📖 Overview
MBPromoCode is a clean and powerful promo code system for Rust servers.
It gives administrators full control over unique promo codes, rewards, activation limits, and expiration dates — all through a beautiful, user-friendly interface.
Whether you want to reward new players, promote your social media, or run limited-time events — MBPromoCode makes it effortless.
✨ Main Features
🎟️ Promo Code Management
Create unique promo codes with rewards, usage limits, and expiration dates. Automatically track activations per player. Prevent abuse with built-in validation and cooldown systems. Examples:
WELCOME → gives 1000 wood BONUS → gives 500 stone
🖥️ Simple & Modern Interface
Intuitive UI for entering and activating promo codes. Buttons for “Activate” and “Close” actions. Customizable background images via ImageLibrary.
💬 Notification System
Sends announcements to global chat when a promo code is activated. Fully customizable messages with color formatting and tags. Works in English, Russian, and Ukrainian.
🔐 Logging & Security
Every activation is logged. Expiration and usage limits are automatically checked. Safe and lightweight — no performance impact.
🌐 Media Integration
Add QR codes linking to your TikTok, Discord, or website. Great for promotional events and influencer campaigns.
⚙️ Configuration Highlights
{ "EnablePromoCodeBroadcast": true, "MessagePrefix": "<color=#0057b8>[Promo]</color>", "PromoCodes": { "WELCOME": { "Reward": "give {player} wood 1000", "Expires": "30.10.2025", "MaxUses": 50 }, "BONUS": { "Reward": "give {player} stone 500", "Expires": "01.11.2025", "MaxUses": 100 } } }
💡 Usage Workflow
The player opens the menu with /promo. They enter the code and press Activate. If the code is valid — the reward is granted. A message is displayed in global chat (optional).
🌍 Localization
English Russian Ukrainian All messages are stored in language files and can be freely customized.
💎 Perfect For
Servers running events or giveaways. Communities promoting social media engagement. Admins who want a polished promo code experience with full customization. -
Custom Magazine Capacity
By xNullPointer95 in Plugins
xMagazineCapacity
- Set a custom magazine capacity for any weapon.
- Define a default capacity
- Define a permission or not for any custom magazine capacity
Default Config
{ "Weapons": [ { "weaponName": "rifle.ak", "capacity": 45, "defaultCapacity": 30, "permission": "" }, { "weaponName": "rocket.launcher", "capacity": 3, "defaultCapacity": 1, "permission": "xmagazinecapacity.rocketlauncher3" }, { "weaponName": "rocket.launcher", "capacity": 6, "defaultCapacity": 1, "permission": "xmagazinecapacity.rocketlauncher6" } ], "RevokePermissionsOnUnload": false, "RestoreRevokedPermissionsOnLoad": true } ℹ️ Keep "permission" empty to override magazine capacity for all players. When config is changed, reload the plugin.
➡️ Add as much weapons as you want.
➡️ Multiple permissions for same weapon
If you have identical weapon names with different permissions, the capacity will be taken from the one with the highest capacity.
Example: 3 times "rocket.launcher" with different permissions: xmagazinecapacity.rl3, xmagazinecapacity.rl6, xmagazinecapacity.rl9 - If a player has all 3 permissions, the capacity will be 9, since its the one with most capacity.
➡️ RevokePermissionsOnUnload/RestoreRevokedPermissionsOnLoad
"RevokePermissionsOnUnload": When the plugin unloads, it takes back any weapon permissions it granted while plugin was running.
"RestoreRevokedPermissionsOnLoad": If you turned the "RevokePermissionsOnUnload" on, this restore option puts revoked permissions back on the same players the next time the plugin loads. (It only affects xmagazinecapacity configured permissions)
-
Skill System
By xNullPointer95 in Plugins
xSkillSystem
xSkillSystem adds an RPG-style leveling experience to your gameplay. Whether you're chopping wood, mining for ores, or battling wildlife, every action earns you XP and helps you level up specialized skills. XP Table was testet properly and it should be fine. There are gather rates impact which are configurable and also a passive HP regen for skill "Vitality" depending on its level which is also configurable. Comes with an external config editor!
» Discord «
⚠️ PLUG&PLAY PLUGIN, but configs are available to adjust it to your needs ⚠️
✅ Built in image caching/reading (ImageLibrary is NOT needed) => Automatic skill icons download and placement.
📜 Skills: Each player starts at Level 1 in every skill and levels up through regular gameplay. Here's what you can master:
Woodcutting – Chop trees. (Configurable Gather Rates depending on Level) Mining – Dig deep and extract valuable resources like stone, metal, and sulfur. (Configurable Gather Rates depending on Level) Gathering – Pick up natural items from the environment. (Configurable Gather Rates depending on Level) Slayer – Hunt animals, kill NPCs and fight players. Skinning – Skin downed animals for XP. (Configurable Gather Rates depending on Level) Building - Gain XP by building, upgrading, deploying etc. Crafting – Gain XP as you build tools, weapons, and other items. Vitality - Gain XP by using medical syringes & bandages (Configurable passive HP regen depending on Level)
🏆 Custom Level Rewards
🔥 Double XP Weekends
💡 Commands
📹 Plugin Preview (Old preview video, there is already much more):
📝 External Config Editor
ℹ️ Config
🛡️ Permissions
🌍 Language
👥 API
- #skill system
- #level system
- (and 27 more)
