CarCommander

CarCommander 0.2.76

Features:
Custom vehicle control and settings - Including reverse and handbrake
Take passengers with you - 4 players total
Individual entry and exit points - Walk to the door of the seat you want to sit in
Vehicle inventory - That persists through restarts meaning you won't lose any items you have in the trunk
Vehicle auto-spawner. Designate a spawn file and a maximum amount of cars to have on the map at any given time
Friends and Clans support - To manage your passengers if you so choose
Health and Fuel UI - Status bars depicting how much health and fuel you have
Use ignition keys - Prevent others from stealing your ride
Hotwire vehicles - Steal other players rides
Lock the trunk with a key/code lock - Prevent unwanted looting
Collision damage - Watch out for obstacles


Permissions
carcommander.use - Required to drive these vehicles
carcommander.canspawn - Allows players to use the chat command to spawn cars (/spawncar)
carcommander.canbuild - Allows players to use the chat command to build cars (/buildcar)
carcommander.admin - Required to manually spawn cars in via chat or console command (/admincar)
carcommander.ignorecooldown - Players with this permission will not be affected by chat command spawn cooldowns

Chat Commands
/spawncar - Spawns a car on your position. This command uses the spawn cooldown system and all cars spawned via this command are saved. (Requires permission ' carcommander.canspawn ')

/buildcar - Allow players to build cars for a cost defined in the config (Requires permission ' carcommand.canbuild ')

/admincar - Spawns a car on your position. This command does not use the cooldown system and by default these cars are not saved. You can opt to save these cars by adding the argument 'save' after the command. (Requires permission ' carcommander.admin ')

/clearcars - Remove all cars spawned via this plugin

/copykey - Allows the key holder to make a copy of the ignition key (if applicable)

/hotwire - Allows player to attempt to hot wire a vehicle (if applicable)
* Once a vehicle had been hot wired it will never need a key to start

/flipcar - Allows players to flip upside down cars (if enabled in the config)

Console Commands
spawncar <playerId> - Spawn a car in front of the player with the specified ID
spawncar <x> <y> <z> <opt:save> <opt:rotation> - Spawn a car at the co-ordinates provided, with option to save the car and set its rotation
clearcars - Remove all saved cars

*Note: Cars spawned via the admin chat or console command are not saved through restarts. If you would like to save these vehicles then add "save" to the end of the command
ex. "/admincar save" - Chat
ex. "spawncar 7420........ save" - Console player spawn
ex. "spawncar 100 0 100 save" - Console position spawn


Config Options
Button Configuration - You can set the various controls in this section. Available button types to use here are: JUMP, DUCK, SPRINT, USE, FIRE_PRIMARY, FIRE_SECONDARY, RELOAD, FIRE_THIRD

Fuel Options - Toggle the requirement of fuel to run the car. If you choose to require fuel you can access the fuel tank from outside of the vehicle by pressing Mouse3 (default).
Fuel consumption rate is the amount of seconds the vehicle can drive on 1 litre of the specified fuel type

Inventory Options - Various options regarding the vehicle inventory. This can be completely disabled if you so choose.

Passenger Options - Allows you to toggle Friends/Clans support for passengers of the vehicle, or disable the system entirely

Spawnable Options - Allows you to auto-spawn these vehicles around the map using spawnpoints from a designated spawn file. This will allow players to go searching for the vehicle which they can then take home. This also allows you to manage how many vehicles are in the world.

Security Options - Various options regarding vehicle security. Create ignition keys, allow hotwiring etc

Collision Options - Enable collision damage to vehicles, adjustable with a damage multiplier

Movement Settings
"Anti Roll - Front horizontal force": The amount of force applied to the front of the vehicle horizontally to prevent roll overs
"Anti Roll - Rear horizontal force": The amount of force applied to the rear of the vehicle horizontally to prevent roll overs
"Anti Roll - Vertical force": The amount of force applied to the vehicle vertically to prevent roll overs
"Engine - Acceleration torque": The amount of torque applied to the wheels when accelerating
"Engine - Brake torque": The amount of torque applied to the brakes when braking
"Engine - Maximum speed": The maximum speed the vehicle can reach
"Engine - Reverse torque": The amount of reversed torque applied to the wheels when reversing
"Steering - Automatically counter steer": Enabling this will counter steer the car when sliding. The counter steer only applies when the handbrake is NOT pressed meaning you will need to hold the handbrake for longer to continue sliding
"Steering - Max angle": The maximum angle of steering
"Steering - Max angle at speed": The maximum angle of steering when the car is at speed
"Suspension - Damper": Dampens the suspension velocity. A larger value makes the suspension spring force move slower.
"Suspension - Distance": Maximum extension distance of wheel suspension
"Suspension - Force": Spring force attempts to reach the target position. A larger value makes the suspension reach the target position faster.
"Suspension - Target position (min 0, max 1)": The suspension’s rest distance. 1 = fully extended suspension, and 0 = fully compressed suspension
"Use custom handling options": Setting this option to false completely disables any custom handling options on the car and the car will handle exactly as the default car

Other Info
Friends/Clans support of passengers only applies when a player is driving the vehicle. Players can steal vehicles from other players if there is no one driving it

Vehicles spawned via the chat command will despawn when the plugin is unloaded. Vehicles spawned through the auto-spawner will persist through restarts

Fuel consumption is halved when the vehicle is idling. So if you have it set to 10 seconds per litre that is 10 seconds of acceleration or 20 seconds of idling

Config
C#:
{
  "Movement Settings": {
    "Use custom handling options": false,
    "Engine - Acceleration torque": 600.0,
    "Engine - Brake  torque": 800.0,
    "Engine - Reverse  torque": 500.0,
    "Engine - Maximum speed": 90.0,
    "Steering - Max angle": 60.0,
    "Steering - Max angle at speed": 20.0,
    "Steering - Automatically counter steer": false,
    "Suspension - Force": 40000.0,
    "Suspension - Damper": 2000.0,
    "Suspension - Target position (min 0, max 1)": 0.4,
    "Suspension - Distance": 0.2,
    "Anti Roll - Front horizontal force": 3500.0,
    "Anti Roll - Rear horizontal force": 3500.0,
    "Anti Roll - Vertical force": 500.0
  },
  "Button Configuration": {
    "Open inventory": "RELOAD",
    "Accelerate": "FORWARD",
    "Brake / Reverse": "BACKWARD",
    "Turn Left": "LEFT",
    "Turn Right": "RIGHT",
    "Hand Brake": "SPRINT",
    "Open fuel tank": "FIRE_THIRD",
    "Toggle lights": "RELOAD"
  },
  "Build Options": {
    "Allow users to build a car": true,
    "Use cooldown timers": true,
    "Build Costs": [
      {
        "Item Shortname": "metal.refined",
        "Amount": 500
      },
      {
        "Item Shortname": "techparts",
        "Amount": 100
      }
    ]
  },
  "Passenger Options": {
    "Allow passengers": true,
    "Require passenger to be a friend (FriendsAPI)": true,
    "Require passenger to be a clan mate (Clans)": true
  },
  "Inventory Options": {
    "Enable inventory system": true,
    "Drop inventory on death": true,
    "Inventory size (max 36)": 36
  },
  "Spawnable Options": {
    "Enable automatic vehicle spawning": true,
    "Use RandomSpawns for spawn locations": false,
    "Spawnfile name": "car1",
    "Maximum spawned vehicles at any time": 5,
    "Time between autospawns (seconds)": 30,
    "Cooldown time for player spawned vehicles via chat command (seconds)": 30
  },
  "Fuel Options": {
    "Requires fuel": true,
    "Fuel type (item shortname)": "lowgradefuel",
    "Fuel consumption rate (seconds per litre)": 10,
    "Spawn vehicles with fuel": true,
    "Amount of fuel to give spawned vehicles (minimum)": 10,
    "Amount of fuel to give spawned vehicles (maximum)": 50
  },
 "Death Options": {
    "Enable explosion damage on death": true,
    "Damage radius": 6.0,
    "Damage Amount": 75.0
  },
  "Repair Options": {
    "Repair system enabled": true,
    "Shortname of item required to repair": "scrap",
    "Amount of item required to repair": 10,
    "Amount of damage repaired per hit": 30,
    "Allow players to flip cars that are on their roof": true
  },
  "Active Item Options": {
    "Driver - Disable all held items": true,
    "Driver - List of disallowed held items (item shortnames)": [],
    "Passenger - Disable all held items": false,
    "Passenger - List of disallowed held items (item shortnames)": [
      "explosive.timed",
      "rocket.launcher",
      "surveycharge",
      "explosive.satchel"
    ]
  },
  "Security Options": {
    "Enable ignition systems": true,
    "Ignition options": {
      "Allow players to copy a ignition key": true,
      "Give the first player to enter the vehicle a key": true,
      "Chance of getting a key on entrance (1 in X)": 1
    },
    "Hotwire options": {
      "Allow players to hotwire vehicles": true,
      "Deal shock damage on failed hotwire attempts": true,
      "Amount of time it takes per hotwire attempt (seconds)": 5,
      "Chance of successfully hotwiring a vehicle (1 in X chance)": 5
    },
    "Trunk lock options": {
      "Allow locks to be placed on the trunk": true,
      "Only allow locks to be placed if the player has the ignition key": true
    }
  },
  "Collision Options": {
    "Enable collision damage system": true,
    "Collision damage multiplier": 1.0
  },
  "Decay Options": {
    "Enable decay system": true,
    "Amount of decay per decay tick (percentage of maximum health)": 5.0,
    "Time between decay ticks (seconds)": 3600
  },
  "UI Options": {
    "Health settings": {
      "Display to player": true,
      "Position - X minimum": 0.69,
      "Position - X maximum": 0.83,
      "Position - Y minimum": 0.1,
      "Position - Y maximum": 0.135,
      "Background color (hex)": "#F2F2F2",
      "Background alpha": 0.05,
      "Status color (hex)": "#ce422b",
      "Status alpha": 0.6
    },
    "Fuel settings": {
      "Display to player": true,
      "Position - X minimum": 0.69,
      "Position - X maximum": 0.83,
      "Position - Y minimum": 0.06,
      "Position - Y maximum": 0.096,
      "Background color (hex)": "#F2F2F2",
      "Background alpha": 0.05,
      "Status color (hex)": "#ce422b",
      "Status alpha": 1.0
    }
  },
  "Version": {
    "Major": 0,
    "Minor": 2,
    "Patch": 35
  }
}
  • Like
Reactions: BigWheelServers

Information

Author
k1lly0u
First release
Last update
Rating
4.70 star(s) 23 ratings

Latest Release v0.2.76

Released
Sep 7, 2023 at 3:49 AM
Rating
0.00 star(s) 0 ratings


More resources from k1lly0u

  • AirbourneSpawn
    AirbourneSpawn
    Give players the option to spawn from a various aircraft and parachute to the island
  • FiringRange
    FiringRange
    Create COD style firing range time trial's for players to compete in
  • PreferredEnvironment
    PreferredEnvironment
    Allows players to customize their environment settings
  • TrainHeist
    TrainHeist
    A event where a train with scientists drives around the above or below rail ring
  • UberTool - Admin's new Friend
    UberTool - Admin's new Friend
    The ultimative build'n'place solution without any borders or other known limits

CarCommander by k1lly0u
© chaoscode.io Sep 23, 2017

Latest reviews

Excellent Plugin
very nice plugin .. easy to use and my players love it
Setup Instructions are no where to be found. I tried emailing and no replies. When you fix the problem I'll change the stars.
Great plugin ! Brought us so many features to vehicles that should of been there in the first place.
A+++! Spoke with Dev about adding feature. Feature was added in no time! Great plugin. Well maintained. Worth every penny!
Used CarCommanderLite and wanted more! Great plugin! Worth the mony
nice work , great plugin
Looked at it , bought it, loved it!
Everyone loves the plugin on my server.