Vinni_TV_'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 } ] } -
Dungeon Events
Dungeon Events adds fully procedural dungeon raids to your Rust server, creating high-replayability PvE content with unique layouts every time.
Each dungeon is dynamically generated with randomized rooms, corridors, NPCs, bosses, auto turrets, loot crates, and portal access. Whether you want automated world events or private player-purchased dungeon runs, this plugin gives you full control over difficulty, rewards, access, and cleanup.
Perfect for servers that want challenging, customizable, and rewarding endgame-style PvE content.
Main Features
Procedural Dungeon Generation - Every dungeon is generated dynamically, so each run feels different. Multiple Difficulty Tiers - Create fully customizable tiers such as Easy, Hard, Nightmare, or anything you want. Custom NPCs & Bosses - Configure health, damage, gear, custom names, movement, attack distance, and loot. Auto Turrets - Add dangerous turret encounters with configurable health, weapons, and behavior. Custom Loot System - Configure loot boxes, NPC loot, and boss loot with custom chances, amounts, names, and skins. Buyable Private Dungeons - Let players purchase their own dungeon using Economics, ServerRewards, or a custom item like scrap. Access Control - Lock dungeons to the buyer or first player, with optional support for teams and friends. Auto Spawn & Manual Spawn - Spawn dungeons automatically, by admin command, player purchase, or console/RCON. Smart Spawn Checks - Avoid bad locations, terrain issues, safe zones, rocks, monuments, and plugin-controlled areas. Automatic Cleanup - Remove dungeons when inactive, expired, or fully cleared. Reward Integrations - Supports Economics, ServerRewards, and SkillTree XP rewards. Live Dungeon UI & Map Markers - Show remaining time, entity counts, and map markers for active dungeons.
Commands
Admin
/createdungeon <tierName> /removeinactivedungeons /removealldungeons /forceremovealldungeons /de.removenearest /de.reloadconfig /de.toggle Players
/buydungeon /buydungeon <tierName> /removedungeon Console
buydungeon <tierName> <playerID> spawnrandomdungeon spawnfixeddungeon <tierName> spawnfixeddungeon <tierName> <playerID>
Permissions
dungeonevents.admin dungeonevents.buy dungeonevents.enter
Hooks
void OnDungeonSpawn(ulong OwnerID, Vector3 Position, string Grid, string TierName) void OnDungeonDespawn(ulong OwnerID, Vector3 Position, string Grid, string TierName) void OnDungeonWin(ulong playerID, string tierName)
Supported Integrations
Economics ServerRewards Friends Notify NightVision ZoneManager Duelist RaidableBases AbandonedBases RestoreUponDeath SkillTree
Languages
EN PT-BR DE ES RU If you want a powerful, replayable PvE dungeon system with deep customization and strong plugin integration, Dungeon Events is built to deliver exactly that.
Plugin config, where you can change tiers, loot items, turret settings, dependencies, spawn logic, auto-removal conditions, economy integration, and more.
-
The Red Button
Just a small plugin with a button to troll your players with A fun game . with some punishments on button press
punishments is set to random with a weight value (higher the number the more change of spawn . 0 means don't spawn)
just a fun way to troll your players
Get your Payback Plugin's at:
Payback 1
Payback 2
if Using Payback be sure to turn on payback use in config.
Permissions
TheRedButton.use (player with this permission can use the commands)
TheRedButton.admin (player with this permission can use the UI)
Chat Commands
/button - Spawns button in player INV
/buttonui - opens the UI // can be bound . ex. bind "p" chat.say /buttonui
/buttonconfig - opens config UI // change weights and customcommands without plugin reload
/spawnbutton - spawns button where you look and facing towards you (only works for IsAdmin tag) ex .auth 1 and 2
/clearallbuttons - deletes all buttons on server (admin only)
Placeholders
{playername} {playerid} {playerlocation} {timeremaining} //Lang file only {cooldowntotal} //Lang file only
Config
{ "1. The Button Settings": { "1. Sign Picture URL": "www.noobhub.co.za/dont.png", "2. Cooldown Time on Button Press": 5, "3. Broadcast Button Action to Server": true, "4. Broadcast Font Size [18 default]": 18, "5. Send Discord embeds on punishments": false, "6. Discord WebHook URL": "https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks", "7. Use Payback Plugin Punishments": true, "8. Timed C4 (false will be instant explosion": true, "9. Use Random location for swim location": true }, "2. Punishment Weights": { "Slap": 2, "Mlrs": 0, "Swim": 2, "Fall": 0, "C4": 1, "Bear": 0, "Scientist": 0, "Scarecrow": 0, "Radiation": 0, "Landmine": 1, "Cactus": 2, "Scrapheli": 2, "PVELord": 2, "Shredder": 2, "Guntrap": 1, "Fireball": 2, "ExplosiveDiarrhea": 2, "PayBack:Rocketman": 2, "Payback:Shark": 2, "Payback:Shocker": 0, "Payback:Naked": 0, "Payback:Chicken": 2, "Payback2:Train": 2, "Payback2:F15": 2, "BombVest:Boom": 0 }, "3. Custom Commands": { "CustomCommand1": { "CCname (DONT CHANGE THIS)": "customcommand1", "Command": "giverank {playerid}", "Message": "Just got a Rank", "Weight": 0 }, "CustomCommand2": { "CCname (DONT CHANGE THIS)": "customcommand2", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand3": { "CCname (DONT CHANGE THIS)": "customcommand3", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand4": { "CCname (DONT CHANGE THIS)": "customcommand4", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand5": { "CCname (DONT CHANGE THIS)": "customcommand5", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand6": { "CCname (DONT CHANGE THIS)": "customcommand6", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand7": { "CCname (DONT CHANGE THIS)": "customcommand7", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand8": { "CCname (DONT CHANGE THIS)": "customcommand8", "Command": "", "Message": "", "Weight": 0 }, "CustomCommand9": { "CCname (DONT CHANGE THIS)": "customcommand9", "Command": "", "Message": "", "Weight": 0 }, "CustomCommandA": { "CCname (DONT CHANGE THIS)": "customcommandA", "Command": "", "Message": "", "Weight": 0 } }, "4. Button Press Settings": { "Prefix": "Server", "Message": "{playername} Pressed The </color><color=red>RED</color><color=green> Button and" } } The numbers assigned to punishment is the weight value. the higher the number the higher chance of spawn . Rule of thumb 1-10 . 0 will cancel that punishment
With CustomCommands if weight is 0 , it will not be loaded.
LangFile
{ "FallMessage": "Fell From 50meters High", "SwimMessage": "Went for a Swim and found 3 sharks", "ScarecrowMessage": "Found that Tinder only has Scarecrows", "ScrapheliMessage": "Helicopters are Heavy . ACME style Murder", "CactusMessage": "Found a Cactus and poke his way to heaven", "C4Message": "Made a new Friend , C4", "BearMessage": "Noticed that YogiBear is no fun in 3's", "ScientistMessage": "Playing with A Scientist that loves him", "LandmineMessage": "Needs to dance or DIE!!!!", "RadiationMessage": "Bit a Nuclear Rod", "SlapMessage": "Got Slapped so hard, his kids felt it", "MlrsMessage": "could not hold on to that rocket", "ChickensMessage": "got a Winner,Winner and is now chicken dinner", "ButtonCooldownMessage": "The Button is on a cooldown for you . {timeremaining} remaining from {cooldowntotal} Min's", "Payback:RocketManMessage": "and found himself singing Rocketman from Elton John", "Payback:SharkMessage": "will never order Sushi again", "Payback:NakedMessage": "lost all his stuff", "Payback:ShockerMessage": "had a shocking experience", "PVELordMessageLargeOil": "Became a PVE SweatLORD on Large Oil", "PVELordMessageSmallOil": "Became a PVE SweatLORD on Small Oil", "PVELordMessageCargo": "Became a PVE SweatLORD on Cargo", "ShredderMessage": "Found his long lost CRUSH , The CarShredder!", "DiarrheaMessage": "and will never eat Taco's again !!", "GuntrapMessage": "and got stuck in a TRAP !!", "FireBallMessage": "should never play with Matches!!!" }
Punishments
c4 locked to player slap player with -90 health fall TP player up in air swim TP player way out in ocean bear spawns 3 bears scarecrow spawns 3 scarecrows radiation makes plyer burn :d landmine spawns landmine under player cactus kills player with a cactus scrapheli drops heli on player scarecrow spawns 3 scarecrows // requires Better Scarecrows to work ( https://umod.org/plugins/better-scarecrows ) mlrs drops 3 rockers on player pvelord send player to ether Cargo or Oilrigs chickens do i even need to state the obvious carshredder tp players into car shredder guntap spawns 6 guntraps around player fireball Do i need to explain fire:D explosivediarrhea Poop till you drop CustomCommand 1 what ever you want (consolecommand)
Future Plans
ability to pickup button more punishments and ability to choice your own Video preview
The button in action . Provided by Enardo . Much love brother🧙
SHADOWFRAX Review
- #red button
- #button
-
(and 2 more)
Tagged with:
-
XBuildingSkinMenu
XBuildingSkinMenu - building block skins menu for your server.
- Optimization of the interface for different monitor resolutions.
- Storing player data in - oxide/data/XDataSystem/XBuildingSkinMenu
- There is a lang ru/en/uk/es.
- Sound effects when interacting with the menu.
- Possibility to allow only the owner of the cupboard to paint the building blocks of the house.
- Possibility to paint building blocks only when authorized in the cupboard.
- Possibility to paint building blocks with a hit of a hammer.
[ Each player can turn on/off in the main menu for convenience. ]
- Possibility to paint building blocks when upgraded.
- Possibility to use effects when painting.
- Possibility to paint each house separately.
[ You can paint an unlimited number of houses at the same time. ]
- Plugin support - BGrade and IQGradeRemove.
- Chat messages about the started/completed of painting the house.
[ The number of painted building blocks. ]
- Chat messages about the started/completed of painting items/constructions inside the house.
[ The number of painted items/constructions. ]
- Chat messages: the house is already being painted - items/constructions in the house are already being painted.
- To paint the containers, the color chosen by the player through the Spray can is used.
- UI button for easy transition from the XBuildingSkinMenu menu to the XSkinMenu menu. [ And vice versa. ]
- Possibility to choose color in UI.
- Automatic replenishment of the configuration with new skins of building blocks.
- Permissions for each skin.
- Automatically reset selected skins from a player, if revoke away their permission.
Permissions
xbuildingskinmenu.use - access to plugin functionality. [ Skins menu, hammer, building. ] xbuildingskinmenu.painting - access to paint the entire house through the cupboard. xbuildingskinmenu.simpleblock - access to paint high Walls/Gates. [ Hammer hit only. ] xbuildingskinmenu.entity - access to painting items/constructions inside the house. [ Requires XSkinMenu plugin version 1.1.14 and above. ] xbuildingskinmenu.default - default permission for skins. Commands
/bskin - open the building block skins menu. API
ulong GetBuildingSkin(BasePlayer player, string grade) - returns the skin of the building block selected by the player. ulong GetBuildingSkin(BasePlayer player, BuildingGrade.Enum grade) - returns the skin of the building block selected by the player. ulong GetBuildingSkin(BasePlayer player, BuildingBlock block) - returns the skin of the building block selected by the player. Config
{ "General setting": { "Automatically add actual skins of building blocks to the configuration": true, "Only the owner of the cupboard can start painting the house": false, "Use effects when painting home": true, "Use effects when painting items/constructions in the house": true, "Use effects when painting building blocks by hitting a hammer": false, "Enable painting of items/constructions in the house using player skins from the XSkinMenu plugin": false, "Skins for buildings": { "Wood": { "0": { "ImageURL": "", "Permission": "" } }, "Stone": { "0": { "ImageURL": "", "Permission": "" }, "10220": { "ImageURL": "", "Permission": "xbuildingskinmenu.default" }, "10223": { "ImageURL": "", "Permission": "xbuildingskinmenu.default" }, "10225": { "ImageURL": "", "Permission": "xbuildingskinmenu.default" } }, "Metal": { "0": { "ImageURL": "", "Permission": "" }, "10221": { "ImageURL": "", "Permission": "xbuildingskinmenu.default" } }, "TopTier": { "0": { "ImageURL": "", "Permission": "" } } }, "Default skins for new players": { "Wood": 0, "Stone": 0, "Metal": 0, "TopTier": 0 } }, "GUI setting": { "Close the menu by tapping on an empty area of the screen": false, "Material_background_0": "assets/icons/greyout.mat", "Color_background_0": "0 0 0 0", "Color_background_1": "0.517 0.521 0.509 0.95", "Color_background_2": "0.217 0.221 0.209 0.95", "Skin background color": "0.517 0.521 0.509 0.5", "Background color of the selected skin": "0.53 0.77 0.35 0.8", "Close button (icon) color": "1 1 1 0.75", "Color of buttons in cupboard": "0.35 0.45 0.25 1", "Button text color in cupboard": "0.75 0.95 0.41 1", "Hammer button color - On": "0.35 0.45 0.25 1", "Hammer button text color - On": "0.75 0.95 0.41 1", "Hammer button color - Off": "0.65 0.29 0.24 1", "Hammer button text color - Off": "0.92 0.79 0.76 1", "AnchorMin - button 1": "0.5 0", "AnchorMax - button 1": "0.5 0", "OffsetMin - button 1": "395 621.5", "OffsetMax - button 1": "572.5 641.5", "AnchorMin - button 2": "0.5 0", "AnchorMax - button 2": "0.5 0", "OffsetMin - button 2": "395 646.5", "OffsetMax - button 2": "572.5 666.5" } } -
Crafts
Crafting system that allows you to create items, cars, vehicles, recyclers, etc!
Commands
craft open interface crafts.setwb [categories: cat1 cat2 ...] set new custom workbench
Permissions
You can set permission in config, for example:
"Permission (ex: crafts.use)": "crafts.use", crafts.setworkbench - allows you to use the "crafts.setwb" command (set custom workbenches)
Craft Types
Command Vehicle Item Recycler ModularCar
How to install a custom workbench
1. Spawn the workbench (for example, in RustEdit or a plugin) 2. In the game, go to him and use the command "crafts.setwb" and specify the necessary categories. Example: /crafts.setwb Misc 3. Go to config (oxide/config/Crafts.json) and configure this workbench (use SafeZone, workbench level, etc.)
VIDEO
FAQ
Q: Where can I see an example of a config?
A: Config
