CableCars

CableCars

!CableCars banner

Admin-built aerial cable car lines for Rust servers.

CableCars lets an admin build working cable car lines anywhere on the map. A line runs between two end stations, with optional middle stations and lattice towers. Players walk up to a car in a station, press E, pay the fare, and ride.

Features

• Two line modes
• detach - a continuous loop with any number of cars. Supports middle stations.
• jigback - a reversible line with 2 cars that shuttle back and forth.
• Stations and towers - station halls, lattice towers, a control room with an operator NPC, and decorations (recyclers, sofas, repair bench, research table, workbench, refinery, arcade machine, ceiling lights).
• Track dressing - cable pieces along the track, Christmas lights, tesla coil hanger arms, spark effects.
• Fares - pay with any item (default scrap), Economics, or ServerRewards. Optional refund if the rider leaves before departure.
• Day passes - optional timed pass that gives free rides.
• Operating hours - optional open and close times by game hour. Lights can run at night only.
• Station info panel - shows the destination, the fare, and a countdown to the next car.
• Map markers - pink markers at every station with the line name and fare.
• Auto tower placement - places towers from the terrain, with clearance checks over rocks and cliffs.
• Monument anchoring - anchors a line to a monument so it rebuilds in the right place on a new map.
• Protection - build blocking around stations, towers and track. Riders cannot take or deal damage. Stations can be safe zones.
• Car radio - a boombox in every car.
• Station sign - a picture sign on the back wall of end stations, loaded from an image URL.
• Admin panel - an in-game UI with Build, Tuning, Stations and Help tabs.
• Smooth movement - frame-driven movement and batched entity spawning.
• Hooks and API for other plugins.

Installation

1. Copy CableCars.cs into oxide/plugins/.
2. The plugin creates oxide/config/CableCars.json and oxide/data/CableCars.json on first load.
3. Grant the admin permission:

oxide.grant group admin cablecars.admin

Permissions

Quick start: build a line

1. /cablecar create <name> - start a new line.
2. Stand where station A's deck should be and type /cablecar station.
3. Walk the route. Add towers with /cablecar tower [height], or skip this step and use /cablecar autotowers [spacing] later.
4. Stand at the far end and type /cablecar station again for station B.
5. /cablecar preview - check the route. Use /cablecar fixclearance if the preview shows low sections.
6. /cablecar build - spawn the line.

Player commands

Admin commands

/cablecar with no arguments opens the admin panel. /cablecar help lists every command in chat.

Build

Towers

Manage

Tune

Each of these prints its own usage and current values when typed without arguments.

Configuration

The config file is oxide/config/CableCars.json. It is split into sections:

Key defaults:

Developer hooks

// Return a string (shown to the player) or any non-null value to block boarding.
object CanCableCarBoard(BasePlayer player, string line)

void OnCableCarBoarded(BasePlayer player, string line, string station, int paid)
void OnCableCarDeparted(BasePlayer player, string line, string station)
void OnCableCarArrived(BasePlayer player, string line, string station)
void OnCableCarExited(BasePlayer player, string line, string station)

API

Call with CableCars.Call(...):

bool         API_IsRiding(BasePlayer player)
string       API_GetRiderLine(BasePlayer player)
List<string> API_GetLines()
bool         API_IsCableCarEntity(BaseEntity entity)

Localization

All player messages are in the Oxide lang file (oxide/lang/en/CableCars.json) and can be translated.