Vehicle Velocity Camera

📸 Vehicle Velocity Camera - Speed Radar for RUST

Turn a Instant Camera into a working police speed radar. Point, shoot, and the photo itself becomes hard evidence:
a unique vehicle VIN, the measured speed, the vehicle type, the driver and a timestamp - all printed directly onto the in‑game photo item your players can hold, trade and present.

The perfect tool for Roleplay servers with a Police / Law Enforcement faction. Speed traps, traffic stops, fines, and court‑ready evidence - finally a real mechanic behind it.

🚓 Why your server needs this

On a serious RP server, "slow down!" means nothing without proof. This plugin gives your police force an actual, immersive tool:

• An officer aims the radar camera at a moving car, boat, heli or sub and takes a photo.
• The photo turns into a physical evidence item showing the exact speed and a unique vehicle ID (VIN).
• That photo can be handed to a judge, pinned to a wanted board, or used to justify a fine - driven entirely by real gameplay, not honor system.

It creates emergent roleplay: speed limits, highway patrol, chase scenes, traffic court, insurance scams… all backed by tamper‑proof, server‑generated data.

✨ Features

• Instant‑photo speed measurement - speed is captured the moment the shutter fires, so it's always the real velocity.
• Evidence printed on the photo item - VIN, speed, vehicle type, driver and timestamp are written straight onto the photo (item.text). Players can hold and share it.
• Persistent VIN system - every vehicle gets a stable, unique license/VIN code that survives relogs and restarts, so the same car is always identifiable.
• Works on every vehicle - Modular Cars, Minicopters, Scrap & Attack Helis, RHIBs, Rowboats, Sedans, Trains, Snowmobiles, Submarines, Motorbikes, Horses, Tugboats and more.
• Driver & owner detection - logs who was driving and the vehicle owner ID.
• Skin‑locked radar device - only a camera carrying your configured SkinID acts as a radar. Hand it out as official "police equipment" while normal cameras stay normal.
• Console give command - distribute radars to officers from console or RCON, by name or SteamID, in any quantity.
• Cooldown protection - prevents spam; while the camera is on cooldown the player is told and no measurement happens - readings only ever come from a real photo.
• km/h or mph, fully configurable output, optional server logging and a clean per‑player "last reading" history.
• Permission‑gated - only authorized players (your police group) can measure.

🎮 In‑Game Commands

| /vin | Player (perm) | Look at a vehicle to instantly read its VIN, speed, type & owner - no photo needed. |
| /vinlast | Player (perm) | Show your last captured measurement. |
| /vinwipe | Admin | Clear all stored VINs and photo events. |

🖥️ Console / RCON Command

Gives the player a radar camera using the configured SkinID. Example:

---

🔐 Permissions

| Permission | Grants |
|---|---|
| zmbtecvehicleveloicitycamera.use | Allows measuring speed / using the radar and /vin commands. |

Grant it to your police group:

---

⚙️ Configuration

Key options

• CameraSkinID - the skin that turns an Instant Camera into a radar. Set to 0 to allow any camera. Default 3754497344.
• SpeedUnit - "kmh" or "mph".
• VinPrefix - branding prefix for generated VINs (e.g. RST-1A2B-3C4D).
• PhotoCooldown - seconds between measurements per player.
• PhotoTextFormat - what gets printed on the photo. Tokens: {vin} {speed} {unit} {name} {driver} {owner} {time} (\n = new line).
• ChatOutput / LogOutput - toggle chat feedback and server‑log records.
• Works with Karuza Vehicles

---

🌍 Localization

All player‑facing text is registered through the Oxide lang system (English by default) - fully translatable to any language from the lang files.

---

📦 Installation

• Drop zmbtecVehicleVeloicityCamera.cs into your oxide/plugins/ folder.
• The config & data files generate automatically.
• Set your radar CameraSkinID, grant the permission to your police group, and hand out radars with giveradar.
• Done - start writing tickets.