SuperKitten's Wishlist
-
Flying Cargo Ship Event
By The_Kiiiing in Plugins
The Flying Cargo Ship introduces a new gameplay experience, with a cargo ship soaring through the skies, guarded by anti-air turrets. Players must disable these defenses by confronting NPCs at the control center, where they can also find the Air Card, granting access to the ship's lower deck.
Control Center
The Control Center spawns at a random monument and is guarded by NPCs. There is a button inside to disable the turrets on the flying cargo ship. An Air Card can also be found there, granting you access to the lower deck of the cargo ship.
Anit-Air Turret
The Flying Cargo Ship is equipped with Anti-Air Turrets. The turrets need to be disabled before approaching the ship.
Commands
Commands can be executed from the chat, server console or the in-game F1 console
fcargo start <optional player name or steam id> - Start the event (optionally set the event owner) fcargo stop - Stop the event fcargo spawnpoints - Show all control center spawn points on the map (useful for debugging) Required permission:
flyingcargoship.admin
Hooks
void OnFlyingCargoStart() - Called when the event starts void OnFlyingCargoCompleted(ulong steamId) - Called when the event has been fully looted void OnFlyinCargoEnd() - Called when the event is over
Configuration
{ "Schedule event": true, "Time between events (minutes)": 60, "Event duration (minutes)": 40, "Time before ship leaves after all crates have been looted (seconds)": 300, "Time before radiation when ship is leaving (seconds)": 30, "Double NPC count on ship": false, "Control center destroy time (seconds)": 300, "Control center NPC count": 8, "Use Loottable plugin for loot (requires Loottable)": true, "Ship loot configuration": { "IMPORTANT NOTICE": "The maximum total crate count is 21. If the crate count in the config is higher, excess crates will be ignored, starting at the lowest tier", "Locked crate count (total crate count shold be less than or equal to 21)": 4, "Elite crate count (total crate count shold be less than or equal to 21)": 4, "Military crate count (total crate count shold be less than or equal to 21)": 6, "Normal crate count (total crate count shold be less than or equal to 21)": 7, "Locked crate loot table": { "Enabled": true, "Item list": [ { "Short name": "scrap", "Min amount": 10, "Max amount": 100, "Chance (1 = 100%)": 1.0, "Skin id": 0 }, // Removed for legibility ] }, "Elite crate loot table": { "Enabled": false, "Item list": [] }, "Military crate loot table": { "Enabled": false, "Item list": [] }, "Normal crate loot table": { "Enabled": false, "Item list": [] }, "NPC loot table": { "Enabled": true, "Item list": [ // Removed for legibility ] } }, "Control center NPC loot table": { "Enabled": true, "Item list": [ // Removed for legibility ] }, "Control center NPC configuration": { "Npc name": "Air Scientist", "Health": 200.0, "Enable radio chatter": true, "Sense range (m)": 50.0, "Vision cone (degrees)": 135.0, "Damage scale (1 = 100%)": 1.0, "Memory duration (seconds)": 30.0, "Roam range (m)": 20.0, "Chase range (m)": 40.0, "Remove corpse on death and drop bag": true, "Kit (requires Kits plugin)": "", "Clothing items": [ { "shortName": "hazmatsuittwitch", "amount": 1, "skinId": 0 } ], "Belt items": [ { "shortName": "rifle.lr300", "amount": 1, "skinId": 0 }, { "shortName": "grenade.f1", "amount": 10, "skinId": 0 } ] }, "Cargo ship NPC configuration (Top)": { "Npc name": "Air Scientist", "Health": 250.0, "Enable radio chatter": true, "Sense range (m)": 100.0, "Vision cone (degrees)": 135.0, "Damage scale (1 = 100%)": 1.0, "Memory duration (seconds)": 30.0, "Roam range (m)": 1.0, "Chase range (m)": 1.0, "Remove corpse on death and drop bag": true, "Kit (requires Kits plugin)": "", "Clothing items": [ { "shortName": "hazmatsuittwitch", "amount": 1, "skinId": 0 } ], "Belt items": [ { "shortName": "rifle.lr300", "amount": 1, "skinId": 0 } ] }, "Cargo ship NPC configuration (Normal)": { "Npc name": "Air Scientist", "Health": 200.0, "Enable radio chatter": true, "Sense range (m)": 40.0, "Vision cone (degrees)": 135.0, "Damage scale (1 = 100%)": 1.0, "Memory duration (seconds)": 30.0, "Roam range (m)": 20.0, "Chase range (m)": 40.0, "Remove corpse on death and drop bag": true, "Kit (requires Kits plugin)": "", "Clothing items": [ { "shortName": "hazmatsuittwitch", "amount": 1, "skinId": 0 } ], "Belt items": [ { "shortName": "smg.mp5", "amount": 1, "skinId": 0 }, { "shortName": "grenade.f1", "amount": 10, "skinId": 0 } ] }, "Cargo ship NPC configuration (Inside)": { "Npc name": "Air Scientist", "Health": 250.0, "Enable radio chatter": true, "Sense range (m)": 20.0, "Vision cone (degrees)": 135.0, "Damage scale (1 = 100%)": 1.0, "Memory duration (seconds)": 30.0, "Roam range (m)": 10.0, "Chase range (m)": 20.0, "Remove corpse on death and drop bag": true, "Kit (requires Kits plugin)": "", "Clothing items": [ { "shortName": "hazmatsuittwitch", "amount": 1, "skinId": 0 } ], "Belt items": [ { "shortName": "shotgun.spas12", "amount": 1, "skinId": 0 }, { "shortName": "grenade.f1", "amount": 10, "skinId": 0 } ] } }
- #cargo
- #cargo ship
-
(and 5 more)
Tagged with:
-
Christmas
By The_Kiiiing in Plugins
Get your server ready for Christmas! This plugin includes Chrismas Trees with loot that spawn on the map, custom junk pile decorations, Snowman NPCs, a custom Advent Calendar and much more.
New: Customizable Advent Calendar
With the new update, you can configure a custom reward for every day. To enable custom advent calendar rewards, set the config option "Enable custom advent calendar" to true.
Features
Christmas trees with presents Customizable NPC clothing Customizable junk pile decorations Snowman NPCs spawn across the map Custom advent calendar Configurable Snowman NPCs
Christmas Trees:
Christmas trees randomly spawn across the map, they also spawn presents and snowman NPCs around them. They are by default 4x as big as usual christmas trees and have a configurable despawn time.
Snowman NPCs:
Snowmans spawn across the map. As soon as a player approaches them, they turn into an NPC and start shooting the player with a snowball gun. The loot of these NPCs is fully configurable
Junk Pile Decorations:
Every junk pile can be customized with decorations. Out of the box the plugin comes with a default configuration for each junk pile.
To edit the decorations of a junk pile, use the command /jp <type> where type is a letter from a to j each representing a different junk pile. A junk pile will spawn at your current position. To add objects to the junk pile just hit them with a hammer and use /jp save when you are done.
Custom NPC clothing:
Clothing can be configured individually for each NPC. Some NPCs also come with a default configuration. Note that the custom clothing might also impact other NPC plugins. Therefore it is not recommended to configure custom clothing for scientistnpc_heavy (Heavy Scientist).
Required Dependencies:
NPC Spawn: https://drive.google.com/drive/folders/1-18L-mG7yiGxR-PQYvd11VvXC2RQ4ZCu
Entity Scale Manager: https://umod.org/plugins/entity-scale-manager
Permissions:
christmas.edit - Required to edit junk pile desorations christmas.spawn - Required to spawn christmas trees and snowmans
Commands:
jp - Edit junkpile decorations (see Junkpile Decorations for more details) christmas.tree - Spawn a chistmas tree at the position you are looking at christmas.snowman - Spawn a snowman at the position you are looking at
Configuration:
{ "Snowman config": { "Enable Snowman NPCs": true, "Snowman population": 200, "Snowman NPC spawn type (0 = when snowman is damaged, 1 = when player is near snowman (performance intensive))": 1, "Minimum distance between player and snowman before NPC spawns": 6.0, "Snowman NPC configuration": { "Name": "Snowman", "Health": 150.0, "Enable radio": false, "Roam range": 100.0, "Chase range": 50.0, "Sense range": 50.0, "Damage multiplier": 1.0, "Memory duration": 60.0, "Kit (requires Kits plugin)": "", "Clothing items": // Removed because too long }, "Snowman Loot": // Also too long }, "Christmas Tree config": { "Spawn christmas trees": true, "Christmas tree population": 40, "Amount of presents per tree": { "Min": 2, "Max": 5 }, "Tree despawn time (minutes)": 30, "Tree size (1 - 10)": 4.0, "Minmum distance between trees": 50.0, "Spawn Snowman NPCs around trees (Only works if Snowman NPCs are enabled)": true }, "Enable junk pile decorations": true, "Advent calendar config": { "Enable custom advent calendar": true, "Daily rewards": { "1": { "shortName": "scrap", "amount": 100, "skinId": 0 }, "2": { "shortName": "pistol.eoka", "amount": 1, "skinId": 0 }, "3": { "shortName": "woodtea.advanced", "amount": 1, "skinId": 0 } // And so on ... }, "NPC clothing config": { "Enable custom NPC clothing": true, "Custom NPC Clothing": // Very long } }
- #christmas
- #npc
-
(and 5 more)
Tagged with:
-
Halloween
By The_Kiiiing in Plugins
Get your server ready for Halloween! This plugin adds several options to make your server more spooky, including jumpscares when looting a crate, customizable NPC clothing and graveyards with zombies that spawn at night.
Features:
Graveyards with loot guarded by zombies Play spooky sound effects at night Jumpscares when looting a crate Custom NPC clothing Junk pile decorations
New with version 1.4.0: Pumpkin Launcher & Zombie Grenade
Pumpkin rockets are only visual and do not affect rocket damage. In order to fire pumpkin rockets, players need the permission
halloween.pumpkinlauncher
The zombie grenade is a regular smoke grenade that spawns zombies inside the smoke circle when deployed. The smoke duration and zombie count can be adjusted in the config file. To obtain a zombie grenade, use the command halloween.give grenade <optional amount> <optional player> with permission halloween.give . The skin id of the zombie grenade is 3578690997
New with version 1.3.0: Random jumpscares
An NPC will randomly appear behind a player and make noises to get the players attention. When the player turns around, a configurable sound is played. The NPC will follow the player until it gets killed or destroyed by a timer.
Video: https://imgur.com/a/1IsYXKV
Command to manually scare players:
jumpscare <playerNameOrSteamId?> Permission:
halloween.scare - Required to use the jumpscare command
Graveyards:
The plugin comes with one graveyard built-in, you can also create custom grave yards. Graveyards spawn at night and are guarded by zombies. Inside you can find coffins with loot. They will burn down as soon as the sun rises.
To create a custom graveyard you first have to build one. Any deployable in the game can be added to a graveyard with some serving a special purpose:
Snowman: Placing a snowman in the graveyard will create a zombie spawn point at that position Coffin: Every coffin will be filled with loot when the graveyard spawns. The loot can be changed in the config To save a graveyard, go to the center of your graveyard and type /gy new . Now hit every object you want to include in your graveyard with a hammer. When you are done use /gy save <name> to save the graveyard. To spawn the graveyard at night you have to add the name to the config field "Grave yard configurations to spawn".
Junkpiles:
Every junk pile can be customized with decorations. Out of the box the plugin comes with a default configuration for each junk pile.
To edit the decorations of a junk pile, use the command /jp <type> where type is a letter from a to j each representing a different junk pile. A junk pile will spawn at your current position. To add objects to the junk pile just hit them with a hammer and use /jp save when you are done.
Custom jumpscare sounds:
There are 2 default sounds for jumpscares: _scream and _laugh, you can also record custom sounds. To record a custom sound using the in-game voice chat, type /hrec to start the recording and /hrec again to stop the recording.
You can check you current recording by using the command /hrec test. A ghost will spawn next to you and play the sound you just recorded.
To save your recording use /hrec save <name>. Now you can add the name of the recording to the config field "Jumpscare sounds".
Permissions:
halloween.edit - Required to edit junk piles and graveyards halloween.record - Reqired for recording new sounds
Configuration:
{ "Enable lightnings at night": true, "Enable fog at night": true, "Enable junk pile decorations": true, "Max decorations per junk pile": 2, "Max total junk pile decorations (set lower to reduce performance impact)": 2000, "Enable grave yards": true, "Enable fire when grave yards despawn (impacts performance)": false, "Show graveyards on the map (requires https://codefling.com/plugins/marker-api)": true, "Map marker settings": { "Name": "A Graveyard", "Radius": 0.2, "Color (hex format)": "#FFFF00" }, "Spawn graveyards during this time": { "start": 19, "end": 7 }, "Grave yard zombie health": 120.0, "Grave yard population at night": 20, "Allow grave yards on roads": true, "Grave yard despawn time (seconds)": 40.0, "Minimum distance between grave yards": 50.0, "Grave yard configurations to spawn": [ "_default" ], "Grave yard loot table": // Removed for readability "Grave yard zombie configuration": { "Npc name": "Zombie", "Health": 150.0, "Attack range multiplier": 1.0, "Sense range (m)": 50.0, "Vision cone (degrees)": 135.0, "Damage scale (1 = 100%)": 1.0, "Memory duration (seconds)": 60.0, "Roam range (m)": 30.0, "Chase range (m)": 50.0, "Remove corpse on death and drop bag": false, "Kit (requires Kits plugin)": "", "Clothing items": // Removed for readability }, "Enable sound effects at night": true, "Minimum time between sound effects (per player, in minutes)": 5.0, "List of sound effects": [ "assets/bundled/prefabs/fx/player/beartrap_scream.prefab", "assets/bundled/prefabs/fx/player/howl.prefab" ], "Custom NPC Clothing": { "stables_shopkeeper": [ { "Item shortname": "pumpkin", "Skin id": 0 }, { "Item shortname": "gloweyes", "Skin id": 0 } ] // Removed for readability }, "Custom NPC clothing ignored NPC skins": [ 11162132011012 ], "Loot jumpscare configuration": { "Enabled": true, "Jumpscare NPC name": "Ghost", "Jumpscare chance (%)": 5.0, "Minimum time between jumpscares (per player, in minutes)": 30, "Jumpscare sounds - played when the player is looking at the npc": [ "_scream" ] }, "Random jumpscare configuration": { "Enabled": true, "Jumpscare NPC name": "Ghost", "Jumpscare chance (%)": 5.0, "Minimum time between jumpscares (per player, in minutes)": 30, "Jumpscare sounds - played when the player is looking at the npc": [ "_laugh", "_scream" ], "Attention sound effects - played when the player is not looking at the npc": [ "assets/prefabs/deployable/reactive target/effects/snd_knockdown.prefab", "assets/prefabs/clothes/halloween.scarecrow/effects/soul_release_effect.prefab", "assets/bundled/prefabs/fx/item_break.prefab", "assets/prefabs/building/door.hinged/effects/door-wood-knock.prefab", "assets/prefabs/weapons/cleaver big/effects/hit.prefab", "assets/prefabs/weapons/sword big/effects/hit.prefab", "assets/bundled/prefabs/fx/player/gutshot_scream.prefab" ] }, "Recording command name": "hrec", "Grave yard command name": "gy", "Junk pile decoration command name": "jp", "Jumpscare command name": "jumpscare" }
- #halloween
- #zombie
-
(and 8 more)
Tagged with:
-
Dynamic Monuments
DynamicMonuments is a groundbreaking plugin for Rust servers that breathes new life into your maps!
Say goodbye to tedious manual map editing or relying on RustEdit.
With just a few clicks, your server will be transformed, featuring 18 unique monuments that blend seamlessly into any environment.
Key Features:
Dynamic Spawning:
- Monuments can spawn randomly during wipes or with each server restart (optional)
- Customize spawn frequency and zones through the plugin's configuration
- A variety of monument complexities, ranging from cozy hideouts to sprawling fortresses
18 Unique Monuments:
- Water Monuments
- Coastal Monuments
- River Monuments
- Roadside Monuments
- Modifications for Standard Monuments: (Metro entrances, power line towers, substations, quarries, and more).
Personalization:
- Give players personal monuments
Versatility:
- Compatible with both custom and procedural maps.
- Automatically adapts to terrain, water, and roads.
- No RustEdit required! Everything is managed through the plugin's configuration.
Giving a monument to a player
9 out of 18 monuments can be given to players for personal placement.
The dynamic monument is represented as a flare with a unique skin, which can be given to players in any way, such as through an in-game store.
To spawn the monument, the player must hold the flare and find a suitable location, receiving instructions in the chat and notifications.
Once placed, the monument is locked to the player, and only they can loot it.
Chat commands (admin only)
/killmonument - destroys the DynamicMonument you're looking at /replacecrate NewCratePresetName - replaces the crate you're looking at on the location with NewCratePresetName /spawnmonument PresetName - spawns a monument in a random position /spawnmonumentmypos PresetName - spawns the monument in your position /killallmonuments - destroys all DynamicMonuments on the server /respawnmonuments - forcibly launches automatic respawn of DynamicMonuments /givemonument PresetName - give the monument to yourself /addprefabspawnpoint PresetName — adds a crate or static NPC spawn point to a monument at your current position (only for Static Npc and crates) /removemonumententity command — removes entity spawn point you're looking at. (only for StaticNpc/crates/Entities for respawn) Console commands (RCON only)
spawnmonument PresetName - spawns a monument in a random position killallmonuments - destroys all DynamicMonuments on the server respawnmonuments - forcibly launches automatic respawn of DynamicMonuments givemonument PresetName userID - give the DynamicMonument to the player Plugin Config
en – example of plugin configuration in English ru – example of plugin configuration in Russian
Check out the rest of my work: Adem's Codefling Library
You can reach out to me in Discord: Adem's Discord Profile
Join the Mad Mappers Discord!
-
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