Project details

Project: BumperCars
dev language: c# oxide
Plugin language: en
Author: @RustFlash

BumperCars adds a fairground-style bumper‑car arena to Rust using the sedantest vehicle. Players buy a personal bumper car from an NPC dealer, pay with a configurable item (e.g., reskinned Scrap), and ram opponents to deal damage. Only the owner can drive their car. A compact HUD shows speed (km/h) and vehicle health while driving. If your car is destroyed while you’re inside, you die. Everything is configurable.

NPC Dealer + Shop UI (proximity‑based)
An invulnerable “Bumper Car Dealer” NPC spawns at your configured position. When players enter the sale radius, a shop UI opens automatically with price/status and Buy/Cancel actions. Moving away closes it.

Configurable payment item / skin
Define the payment by shortname, optional skin ID, display name, and amount (default: 100 “GoldenScrap” using scrap + SkinID filter). Only items matching the skin are accepted.

Ownership & native locking
Spawned cars (100 HP) are locked to the buyer. The vehicle and all seats are flagged Locked and set to the owner’s OwnerID. Only the owner can mount.

Speed & Health HUD
While the owner is mounted, a HUD (updated ~10×/sec) shows SPEED (km/h) and HEALTH, with color cues. Admins can test a dummy HUD. Players can close the HUD manually.

Physics‑based collisions
Every second (configurable), the plugin checks nearby owner‑driven cars. On impact, each car takes damage equal to the other car’s current speed (km/h) if both were moving above a minimum speed. Cars that hit 0 HP are destroyed; the mounted driver dies.

Per‑player limits & persistence
Limit how many bumper cars a player can own (default 1). Ownership and vehicle lists persist. Destroyed cars are cleaned up. Stats command shows current count and health.

Simple admin setup
One chat command sets NPC position, spawn area, teleports to the dealer, and shows payment info. Console helpers allow TP and config reloads.

Player

• /bumpercar – Buy a bumper car (same checks as the UI: permission, range, funds, limit).
• /bumperhelp – Quick help + price and rules.
• /bumperstats – See how many cars you own and their health.
• /closespeedui – Close the speed HUD (any player).

Admin (chat)

• /bumpersetup – Setup menu. Subcommands:
  • npc – Set NPC position to your current location and (re)spawn it.
  • car – Set the car spawn position to your current location.
  • tp – Teleport to the dealer.
  • info – Print current payment item config.
• /testspeedui – Show a test HUD (requires bumpercars.admin).

Console (admin)

• bumper.tp – Teleport to dealer.
• bumper.setnpc – Set NPC to your position and (re)spawn.
• bumper.reload – Reload configuration from file.
  (UI buttons use the internal console cmds bumpercar.buy / bumpercar.cancel.)

1. bumpercars.use – Required to buy/own a bumper car.
2. bumpercars.admin – Required for setup and test tools.

Beispiel (uMod/Oxide):
oxide.grant group default bumpercars.use
oxide.grant user <steamid> bumpercars.admin

All options are hot‑read via bumper.reload (or plugin reload). Defaults shown below. Set your NPC and spawn positions via /bumpersetup.

{
  "NPC Position (x, y, z)": { "x": 0.0, "y": 0.0, "z": 0.0 },
  "Car Spawn Position (x, y, z)": { "x": 0.0, "y": 0.0, "z": 0.0 },

  "Payment Item": {
    "Item Name": "GoldenScrap",
    "Item Shortname": "scrap",
    "Skin ID": 0,
    "Amount Required": 100
  },

  "Sale Radius to NPC": 3.0,
  "Max Vehicles per Player": 1,

  "Collision Check Interval": 1.0,
  "Collision Distance": 5.0,
  "Minimum Speed for Collision": 5.0
}

Notes / Behavior that matters

• Vehicles spawn at the configured Car Spawn Position; if unset, they spawn ~3m in front of the buyer. Health is 100.
• The dealer uses bandit_shopkeeper.prefab, has 1000 HP, and is flagged invulnerable.
• Death on destruction applies when the player’s mounted bumper car is destroyed (you don’t get killed later if you already dismounted).

load, run, enjoy