Jump to content

12 Screenshots

  • 71.9k
  • 7.4k
  • 617.66 kB
  • Update details
    v3.13.3
    Released
    Download size 617.66 kB
    Total versions 106
    Typical update pace About every 2 days
    Freshness Updated 6 days ago

About 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

  1. 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.
  2. 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.
  3. 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.
  4. Players walk through the portal into the entrance room. Enemies cannot hurt players standing in the entrance, and players cannot shoot from it.
  5. 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.
  6. 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

  1. Put DungeonEvents.cs in oxide/plugins. The configuration, the tier loot folders and Default_Loot.json are created on first load.
  2. Give players access: oxide.grant group default dungeonevents.buy and oxide.grant group default dungeonevents.enter.
  3. 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
  • Like 7
  • Sad 1
  • Love 4

Martian
Martian's Collection
Explore more files from this creator.

User Feedback

About Us

Codefling is the largest marketplace for plugins, maps, tools, and more, making it easy for customers to discover new content and for creators to monetize their work.

Downloads
3.3m
Total downloads
Customers
12.4k
Customers served
Files Sold
175.9k
Total sales
Payments
3.8m
Processed total
×
×
  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.