RandomOilCraters

# Random Oil Craters

Bring back one of Rust's classic world events!

Random Oil Craters automatically scans your map for suitable spawn locations and dynamically creates oil craters just like the old Rust events. The plugin carefully avoids invalid terrain, monuments, roads, buildings, rivers, and other unsuitable locations to ensure natural-looking spawns.

Craters will continuously respawn over time to maintain the configured number of active events on your server.

Features

• Automatically scans the map for valid crater locations

• Maintains a configurable number of active oil craters

• Prevents craters from spawning too close together

• Avoids monuments, roads, rivers, lakes, buildings, cliffs, rocks, and other invalid terrain

• Optional explosion and fire effects when a crater appears

• Optional Scientist NPC guarding each crater

• Configurable NPC health

• Automatic crater despawn timer

• Automatically replaces expired craters with new random locations

• Optional Pump Jack compatibility fix for servers without resource manager plugins

Configuration

| Setting | Description |
|---------|-------------|
| NumberOfCraters | Maximum number of active oil craters to maintain. |
| MinDistanceBetweenCraters | Minimum distance between spawned craters to prevent clustering. |
| CraterDespawnTimerOut | Time (in seconds) before a crater despawns. |
| SpawnNPCAtCrater | Spawn a Scientist NPC to guard each crater. |
| NPCHealth | Health of the spawned Scientist NPC. |
| CheckerDelay | How often (in seconds) the plugin checks whether new craters should be spawned. |
| CraterExplodesOnSpawn | Creates an explosion and burning oil fire when the crater appears. |
| FlameBurnTimer | Duration (in seconds) the fire burns after spawning. |
| FixPumpJacks | Converts spawned Pump Jacks to static deposits so they work without a resource manager plugin. |

---

Chat Command

/showcraters

Admin Only

Temporarily highlights all currently active oil craters using debug spheres for 10 seconds, making them easy to locate while testing or configuring your server.

---

Intelligent Spawn System

Unlike simply placing craters at random, the plugin performs extensive validation before selecting a location.

It checks for:

• Flat terrain

• Safe distance between craters

• No monuments

• No roads or railways

• No rivers or lakes

• No cliffs or large rock formations

• No player buildings

• No junk piles

• No existing mining quarries

• No active players occupying the area

---

Scientist Guards

Optionally spawn a Scientist NPC at every crater.

The NPC:

• Uses configurable health

• Patrols around the crater

• Engages nearby players

• Automatically despawns when the crater disappears

Classic Rust Gameplay

Random Oil Craters recreates the excitement of Rust's original random oil crater events, encouraging exploration and creating dynamic PvE hotspots across the map.

Whether you're running a vanilla-style server or a heavily modded experience, the plugin keeps the world feeling active with fresh loot opportunities appearing throughout each wipe.