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
Step through a portal into a generated dungeon, fight NPCs, bosses, animals and auto turrets, and loot the rewards you configure.
Dungeon Events adds repeatable PvE dungeons to Rust. A portal opens on the map, on a timer or when a player buys one, and leads into a dungeon the plugin builds on the spot. Inside, players fight through rooms of armed NPCs, bosses, animals and auto turrets, then loot boxes and corpses filled from your own loot tables.
The plugin generates every layout itself. You do not build bases, prepare CopyPaste files or install NpcSpawn: choose a tier, and the plugin places the portal, builds the rooms and corridors and spawns the defenders. Every new dungeon gets a new layout.
Six tiers are included, from Easy to Impossible. Each tier has its own size, construction style, enemies, loot files, price, limits and rewards, and you can edit them, remove them or add your own.
A dungeon belongs to the first player who enters it, or to the player who bought it. By default only the owner, their Rust teammates and their friends can follow them in, so a group can run it together without strangers walking in behind them.
How a dungeon works
A dungeon is requested by the automatic timer, by a player through /buydungeon, or by an admin command. Requests wait in a queue and are built one at a time. The plugin picks a portal location away from blocked terrain, nearby entities, other portals, ZoneManager zones, Duelist arenas and Raidable Bases or Abandoned Bases events, or uses one of the portal locations you saved. It builds the dungeon in batches, 700 m up by default, then spawns the NPCs, bosses, animals, turrets and loot boxes. A map marker and a chat announcement show the tier and grid. Players walk through the portal into the entrance room. Enemies cannot hurt players standing in the entrance, and players cannot shoot from it. The dungeon is cleared when every NPC, boss and animal is dead and every loot box and turret is destroyed. The red wall lamps turn green, the remaining doors are removed, clear rewards are paid and a 5-minute removal countdown starts, with reminders in chat. Once the countdown ends and no players remain inside, the dungeon and its portal are removed. Uncleared dungeons expire too: 30 minutes after spawning if nobody entered, or 30 minutes after the first player entered. While inside, players see a HUD with the time left and the number of NPCs, loot boxes and turrets still standing.
Included tiers
Tier Construction Rooms Room size Buy cost NPCs Bosses Animals Turrets Loot boxes Easy Classic 1 5 300 scrap 7 1 4 5 5 Normal Legacy 2 5 500 scrap 14 2 6 10 10 Medium Brick 3 5 700 scrap 21 5 8 15 15 Hard Classic 4 5 1,000 scrap 26 5 8 20 25 Nightmare Armored 5 5 1,500 scrap 31 10 8 25 30 Impossible Armored 6 6 2,000 scrap 5 30 12 20 25 Default enemies
Tier NPC NPC health NPC damage NPC weapon Boss health Boss weapon Turret health Turret weapon Easy Wild Scavenger 100 0.5x Revolver 1,000 AK-47 with flashlight 300 Revolver Normal Battle Forager 150 0.8x Custom SMG 1,500 M249 400 Revolver Medium Crimson Raider 200 1.1x Semi-Automatic Rifle 2,000 M249 600 AK-47 Hard Elite Outlaw 250 1.3x AK-47 3,000 M249 800 AK-47 Nightmare Nightmare Hunter 300 1.5x M249 5,000 M249 1,000 AK-47 Impossible Impossible Hunter 300 1.5x M249 5,000 M249 1,500 AK-47 Bosses deal 1.5x damage on every tier. NPCs and bosses wear skinned clothing sets.
Every tier can also require a permission, unlock a set number of minutes after a wipe, enable or disable automatic spawning and purchases separately, and cap how many of its dungeons are active at once (2 automatic and 2 purchased by default).
Dungeon construction
Each tier picks one of 14 construction options: Wood, Legacy, Gingerbread, Stone, Adobe, Brick, Brutalist, Metal, Container, Armored, Jungle, Crypt, Space and Classic. Container dungeons take any of 16 colours, and garage doors take a skin ID.
Classic dungeons use a separate generator. Walls and floors are made of rock formations, and wall torches replace the red lamps.
Rooms per dungeon from 1 to 6 and room size from 5 to 10. Dungeon height: up to 700 m above ground, at terrain level, or underground. Underground dungeons skip footprints that overlap water. Red wall lamps with configurable spacing, switching to green when the dungeon is cleared. Optional doors and frames for the entrance room and for the inner rooms, each of which can close again when no players remain inside. Time of day per tier: players inside see the hour you set, midnight by default, or the server time. Dungeon walls and floors cannot be damaged. Garage doors can only be damaged by players. Enemies
NPCs and bosses
Name, health, damage scale, clothing with skins, and belt items with amounts, skins and weapon attachments. Bosses have their own settings and their own loot file. NPCs stay within 30 m of their spawn point, and after 2 seconds of shooting they step sideways. Both values can be changed, and the sidestep can be disabled. When the last player inside dies or leaves, surviving NPCs and animals return to their spawn points. Animals
14 species: boar, wolf, stag, chicken, panther, tiger, crocodile, bear, bull, cow, female and male calf, sheep and lamb. Each tier sets their damage, movement speed, sense range and maximum distance from spawn, and each species has its own toggle, spawn weight and health. Animal corpses disappear after a second, so they cannot be harvested.
Auto turrets
Health and weapon per tier.
Loot
Every tier has three loot files in oxide/data/DungeonEvents/<Tier>:
File Used for lootbox.json Loot boxes npc_loot.json NPC corpses boss_loot.json Boss corpses Each entry has a shortname, inclusion chance, minimum and maximum amount, custom name, skin ID, item text and armor insert slots. Each tier limits the number of items per loot box, per NPC and per boss. An empty loot file falls back to Default_Loot.json, which is created with 28 entries on first load. The loot box prefab and skin are set per tier. The default is a skinned wooden box. Rewards
All rewards are optional and set per tier.
Source Economics ServerRewards SkillTree XP NPC kill 300 300 Boss kill 300 300 Animal kill 300 300 Turret destroyed 200 200 Loot box destroyed 100 100 Dungeon cleared 500 500 500 Clear rewards go to the dungeon owner, or to the players inside when the owner is offline. SkillTree XP can be shared with the owner's team, either split between them or paid in full to each player.
Purchases
/buydungeon opens a menu with every tier the player can buy and its price. /buydungeon <tier> buys one directly.
Pay with an item (scrap by default, or any item by shortname with an optional skin ID, so a custom currency item works), Economics balance or ServerRewards points. A player can own one dungeon at a time. With the ownership lock on, it is reserved for them and their allies. After clearing a dungeon, the owner waits 10 minutes before buying that tier again. Each tier can set its own cooldown. Global limits of 6 active purchased dungeons and 6 active automatic dungeons, on top of the per-tier limits. Players with dungeonevents.free buy without paying, and players with dungeonevents.bypasscooldown ignore the cooldown. Admins can switch purchases off and on in-game with /de.toggle. The purchase announcement can be shown to everyone or only to the buyer. Automatic events and portals
Automatic spawning is off by default. When enabled, a dungeon is spawned every 120 seconds (configurable) while the global and per-tier limits allow it.
Custom portal locations. Stand where you want a portal and save the spot with /de.addautospawn or /de.addbuyspawn. Automatic and purchased dungeons keep separate lists, and each can fall back to a random location when all saved spots are taken. Map markers. Name, colour and radius per tier, with separate toggles for automatic and purchased dungeons. Portal spacing. Portals stay at least 50 m apart. Portal protection bubble. A 10 m area around each portal, with an optional visible sphere. The owner and allies can build and deploy inside it while others cannot, damage between them and players outside is blocked both ways, and their vehicles inside it are protected. Rules inside a dungeon
Players who die are taken outside the portal, and their corpse and dropped backpack are moved to the portal exit. Players who die inside do not drop their active item, and their backpack is not dropped (configurable). Both rules step aside when RestoreUponDeath is loaded. Players cannot build, deploy or pick up entities. A configurable list of chat and console commands is blocked (/remove, /tpa and remove.toggle by default). Raid-block plugins that use CanRaidBlock do not block players inside a dungeon. Underground dungeons do not trigger the "inside terrain" anti-hack check. Server workload
Building, entity spawning, cleanup and portal location searches all run in batches. Each step has its own batch size and delay between batches, and automatic spawning waits 15 seconds after a cleanup finishes before it starts the next dungeon.
Installation
Put DungeonEvents.cs in oxide/plugins. The configuration, the tier loot folders and Default_Loot.json are created on first load. Give players access: oxide.grant group default dungeonevents.buy and oxide.grant group default dungeonevents.enter. Review oxide/config/DungeonEvents.json, mainly the payment method, the tiers, automatic spawning and the dungeon height, then run /de.reloadconfig. Warning
Lock dungeon for first player is enabled by default. While it is on, players need dungeonevents.enter to go through a dungeon portal.
Integrations
None are required. Dungeon generation, NPCs, the purchase menu and item payments are built in.
Plugin Use Economics Purchase currency and rewards ServerRewards Purchase currency and rewards SkillTree XP for clearing a dungeon Friends Lets friends of the owner enter Notify Shows messages through Notify instead of the built-in toasts NightVision Sets the player's time of day (noon by default) when they leave a dungeon ZoneManager Portals never spawn inside its zones Duelist Portals never spawn inside its arenas Raidable Bases Portals never spawn inside its event areas Abandoned Bases Portals never spawn inside its event areas RestoreUponDeath The item and backpack drop rules step aside Backpacks Backpacks cannot be dropped inside a dungeon Developer hooks
void OnDungeonSpawn(ulong ownerId, Vector3 portalPosition, string grid, string tierName) // ownerId is 0 when the dungeon has no owner void OnDungeonWin(ulong winnerId, string mapName) void OnDungeonDespawn(ulong ownerId, Vector3 portalPosition, string grid, string tierName) Permissions
Permission Description dungeonevents.buy Open the purchase menu and buy dungeons dungeonevents.enter Enter dungeons while Lock dungeon for first player is enabled dungeonevents.free Buy dungeons without paying dungeonevents.bypasscooldown Ignore the purchase cooldown dungeonevents.admin Buy and enter any dungeon, access every tier, and count as an ally in every portal bubble dungeonevents.<tier> Access a tier that has Require Permission enabled, for example dungeonevents.hard Commands
Every command name can be changed in the configuration.
Players (chat)
Command Description /buydungeon Open the purchase menu /buydungeon <tier> Buy a dungeon of that tier /removedungeon Remove the dungeon you own Admins (chat)
Command Description /createdungeon <tier> Spawn a dungeon of that tier without paying /dungeons List active dungeons /de.removenearest Remove the dungeon whose portal or structure is within 10 m /removeinactivedungeons Remove dungeons that already meet their removal conditions /removealldungeons Remove every active dungeon /forceremovealldungeons Remove every entity the plugin created /de.addautospawn Save your position as a portal location for automatic dungeons /de.addbuyspawn Save your position as a portal location for purchased dungeons /de.removespawn <auto|buy> [radius] Remove the nearest saved portal location (5 m radius by default) /de.listspawns List saved portal locations /de.toggle Turn purchases on or off /de.reloadconfig Reload the configuration Admin chat commands are available to server admins.
Console and RCON
Command Description buydungeon <tier> <steamID> Buy a dungeon for a player, charging that player spawnrandomdungeon Spawn a dungeon of the automatic tier with the fewest active dungeons spawnfixeddungeon <tier> [steamID] Spawn a dungeon of that tier, locked to the player when a SteamID is given dungeons List active dungeons de.reloadconfig Reload the configuration Players can also run buydungeon from their own console, for example from a key bind, but only admins can buy for someone else.
Languages
Messages are included in English, Brazilian Portuguese, German, Spanish and Russian, and every message can be edited in the language files.
Data files
Path Contents oxide/config/DungeonEvents.json Main configuration and tiers oxide/data/DungeonEvents/Default_Loot.json Fallback loot table oxide/data/DungeonEvents/<Tier>/lootbox.json Loot box loot for the tier oxide/data/DungeonEvents/<Tier>/npc_loot.json NPC loot for the tier oxide/data/DungeonEvents/<Tier>/boss_loot.json Boss loot for the tier -
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
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
A crafting system for items, cars, vehicles, recyclers and more.
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: lets you 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
⚙️ Web Config Editor
Manage the Crafts settings in our web config editor. You change the config in a browser form instead of editing files on the server by hand.
P.S. The web config editor is open to members of the "Crafts" group in our Discord server. Join at https://discord.gg/mevent and ask for the group.
FAQ
Q: Where can I see an example of a config?
A: Config