# RigRespawn

RigRespawn gives server owners control over how frequently Oil Rig puzzles reset and how far players must be from the rig before a reset can occur.

The plugin automatically detects Oil Rigs when the server starts, applies your configured reset settings, and restores the original vanilla settings when the plugin is unloaded.

Features

* 🛢️ Custom Oil Rig Reset Timer

* Configure how often Oil Rig puzzles reset.
* Default: 600 seconds (10 minutes).

* 📏 Player Distance Requirement

* Prevents an Oil Rig reset while players are within the configured detection distance.
* Default: 150 metres from the crate spawn point.

* 👥 Population Scaling

* Optional support for Rust's scaleWithServerPopulation behaviour.
* Can be enabled or disabled independently.

* 🔍 Automatic Oil Rig Detection

* Automatically scans the loaded map for Oil Rig monuments.
* No monument positions or coordinates need to be configured manually.

* ♻️ Automatic Restoration

* Original Oil Rig settings are stored when the plugin loads.
* When the plugin is unloaded, the original settings are restored.

Configuration

The configuration file is generated automatically in:

oxide/config/RigRespawn.json

Example:

{
  "Oil Rig Reset Timer (seconds)": 600,
  "Player Min Distance To Block Reset": 150.0,
  "Scale Reset Timer With Server Population": false
}

Options

| Setting | Default | Description |
| ------------------------------------------ | ------: | --------------------------------------------------------------------------------- |
| Oil Rig Reset Timer (seconds) | 600 | Time between Oil Rig puzzle resets in seconds. |
| Player Min Distance To Block Reset | 150 | Minimum distance players must be from the reset area before the puzzle can reset. |
| Scale Reset Timer With Server Population | false | Enables Rust's server-population-based reset scaling. |

The plugin's default reset timer is 600 seconds, compared with the longer vanilla value referenced in the source comments.

How It Works

When the server finishes initializing, RigRespawn searches the loaded monuments for Oil Rigs and locates their PuzzleReset components.

For each detected rig, it saves the existing settings and replaces them with your configured values.

When the plugin is unloaded, every modified Oil Rig is returned to the settings it had before RigRespawn was loaded.

Installation

1. Download RigRespawn.cs.
2. Place it into:

oxide/plugins/

3. Reload the plugin or restart your server:

oxide.reload RigRespawn

4. Configure:

oxide/config/RigRespawn.json

5. Reload the plugin after making configuration changes.

Permissions

No permissions are required.

RigRespawn operates automatically on server initialization.