# RoadBradleyLimiter

Control the number of Road Bradley APCs active during the end-game of a wipe. This plugin allows server owners to limit the number of Bradley Vehicles spawned by the vanilla Road Bradley event, or completely disable the vanilla event and trigger controlled events manually.

Features

* 🚙 Limit Road Bradleys — Set a maximum number of Road Bradleys allowed on the map.
* 🛑 Block Vanilla Event — Optionally disable the vanilla Road Bradley event entirely.
* 🎮 Manual Events — Admins can start and stop a Road Bradley event on demand.
* 📢 Event Announcements — Optionally announce manually triggered events to all online players.
* ⏱️ Automatic Cleanup — Manually spawned Bradleys are automatically removed after a configurable duration.
* 🗺️ Random Road Spawning — Bradleys are spawned at random points along the map's road network.
* 🔐 Permission Support — Give trusted players access to the manual event commands.
* 🔄 Automatic Tracking — The plugin tracks spawned Bradleys and removes them cleanly when the event ends or the plugin unloads.

Configuration

The configuration file is located at:

oxide/config/RoadBradleyLimiter.json

{
  "Block Vanilla Road Bradley Event": false,
  "Enable Bradley Count Limiter": true,
  "Max Number Of Bradleys": 2,
  "Announce Manual Event": true,
  "Stop Manual Event After (seconds)": 3600
}

Configuration Options

| Setting | Description | Default |
| ----------------------------------- | ---------------------------------------------------------------------- | ------: |
| Block Vanilla Road Bradley Event | Completely disables the vanilla Road Bradley event. | false |
| Enable Bradley Count Limiter | Enables the custom maximum Bradley count. | true |
| Max Number Of Bradleys | Maximum number of Bradleys spawned by the event. | 2 |
| Announce Manual Event | Shows an event notification to online players when manually started. | true |
| Stop Manual Event After (seconds) | How long manually spawned Bradleys remain active before being removed. | 3600 |

Commands

Start Road Bradley Event

/roadbradleyevent

Starts a Road Bradley event and spawns the configured number of Bradleys at random road locations.

Stop Road Bradley Event

/roadbradleyeventstop

Stops the manually triggered event and removes all Bradleys spawned by the plugin.

Console/RCON commands are also available:

api.roadbradleyevent
api.roadbradleyeventstop

Permissions

Players must have the following permission to use the chat commands:

roadbradleylimiter.use

Admins can use the commands without the permission.

How It Works

The plugin patches the game's Road Bradley system to control the desired number of Bradleys spawned during the Road Bradley event.

When the limiter is enabled, the vanilla GetDesiredNumber value is replaced with your configured maximum. This makes it particularly useful for end-of-wipe servers where you want to keep Road Bradley activity under control rather than allowing the normal map-based count.

You can also disable the vanilla event completely and use the plugin's manual event commands for more direct control.

Example

For a late-wipe server where you only want 2 Road Bradleys active:

{
  "Block Vanilla Road Bradley Event": false,
  "Enable Bradley Count Limiter": true,
  "Max Number Of Bradleys": 2,
  "Announce Manual Event": true,
  "Stop Manual Event After (seconds)": 3600
}

For full manual control, set:

"Block Vanilla Road Bradley Event": true

Then start events using:

/roadbradleyevent

Notes

The plugin uses the map's road network to select random spawn locations for manually triggered Road Bradley events. Spawned Bradleys are tracked by the plugin and cleaned up when the event is stopped or the configured duration expires.