Car Turrets

Allows the player to use the carturret command. Note: The player also requires module-specific permissions for that command to work.

Allows the player to deploy an auto turret to a vehicle module by clicking and dragging an auto turret item onto a vehicle module item in a car's inventory while editing the car at a lift. Note: The player also requires module-specific permissions for this to work.

Allows remotely controlling car turrets. Only necessary while the RequirePermissionToControlCarTurrets config option is set to true.

Cars owned by players with this permission will spawn with turrets automatically added to each module they have permission to, up to the limit they are allowed. The chance for each module to spawn with a turret is determined by the plugin configuration under SpawnWithCar->SpawnChanceByModule.Only applicable if the plugin configuration for SpawnWithCar->OtherCarSpawns->Enabled is true, and only necessary if SpawnWithCar->OtherCarSpawns->RequirePermission is true.

Allows the player to use the carturrets.removall command.

Allows the player to deploy turrets to all module types.

Only applicable if the plugin configuration for SpawnWithCar->OtherCarSpawns->Enabled is true, and only necessary if SpawnWithCar->OtherCarSpawns->RequirePermission is true.

As an alternative to the allmodules permission, you can grant permissions by module type (these are generated from the config):

carturrets.vehicle.1mod.cockpit

carturrets.vehicle.1mod.cockpit.armored

carturrets.vehicle.1mod.cockpit.with.engine

carturrets.vehicle.1mod.engine

carturrets.vehicle.1mod.flatbed

carturrets.vehicle.1mod.passengers.armored

carturrets.vehicle.1mod.rear.seats

carturrets.vehicle.1mod.storage

carturrets.vehicle.1mod.taxi

carturrets.vehicle.2mod.flatbed

carturrets.vehicle.2mod.fuel.tank

carturrets.vehicle.2mod.passengers

carturrets.vehicle.2mod.camper

The following permissions determine the maximum number of turrets that can be deployed to a car owned by the player, overriding the DefaultLimitPerCar option in the plugin configuration.

Allows cars owned by the player to receive at most 2 turrets.

Allows cars owned by the player to receive at most 3 turrets.

Allows cars owned by the player to receive at most 4 turrets.

If multiple of these permissions are granted to a player, the highest will be used.

Car ownership is determined by the OwnerID property of the car, which is usually a player's Steam ID, or 0 for no owner. Various plugins can spawn cars with a set owner, such as Spawn Modular Car or Craft Car Chassis, while other plugins allow the owner to change with certain events, such as Claim Vehicle.

Deploy an auto turret onto the car module you are aiming at. You must not be building blocked. You must be within several meters of the car.

Removes all turrets from all cars.

{ "RequirePermissionToControlCarTurrets": false, "DefaultLimitPerCar": 4, "EnableTurretPickup": true, "OnlyPowerTurretsWhileEngineIsOn": false, "TargetPlayers": true, "TargetNPCs": true, "TargetAnimals": true, "SpawnWithCar": { "NaturalCarSpawns": { "Enabled": false }, "OtherCarSpawns": { "Enabled": false, "RequirePermission": false }, "SpawnChanceByModule": { "vehicle.1mod.cockpit": 0, "vehicle.1mod.cockpit.armored": 0, "vehicle.1mod.cockpit.with.engine": 0, "vehicle.1mod.engine": 0, "vehicle.1mod.flatbed": 0, "vehicle.1mod.passengers.armored": 0, "vehicle.1mod.rear.seats": 0, "vehicle.1mod.storage": 0, "vehicle.1mod.taxi": 0, "vehicle.2mod.flatbed": 0, "vehicle.2mod.fuel.tank": 0, "vehicle.2mod.passengers": 0, "vehicle.2mod.camper": 0 } }, "AutoTurretPositionByModule": { "vehicle.1mod.cockpit": { "x": 0.0, "y": 1.39, "z": -0.3 }, "vehicle.1mod.cockpit.armored": { "x": 0.0, "y": 1.39, "z": -0.3 }, "vehicle.1mod.cockpit.with.engine": { "x": 0.0, "y": 1.39, "z": -0.85 }, "vehicle.1mod.engine": { "x": 0.0, "y": 0.4, "z": 0.0 }, "vehicle.1mod.flatbed": { "x": 0.0, "y": 0.06, "z": 0.0 }, "vehicle.1mod.passengers.armored": { "x": 0.0, "y": 1.38, "z": -0.31 }, "vehicle.1mod.rear.seats": { "x": 0.0, "y": 1.4, "z": -0.12 }, "vehicle.1mod.storage": { "x": 0.0, "y": 0.61, "z": 0.0 }, "vehicle.1mod.taxi": { "x": 0.0, "y": 1.38, "z": -0.13 }, "vehicle.2mod.flatbed": { "x": 0.0, "y": 0.06, "z": -0.7 }, "vehicle.2mod.fuel.tank": { "x": 0.0, "y": 1.28, "z": -0.85 }, "vehicle.2mod.passengers": { "x": 0.0, "y": 1.4, "z": -0.9 }, "vehicle.2mod.camper": { "x": 0.0, "y": 1.4, "z": -1.6 } } }

RequirePermissionToControlCarTurrets (true or false) -- Determines whether players require the carturrets.control permission to remotely control turrets attached to cars. While false, anybody can control car turrets. While a player is prohibited from controlling car turrets, they can still view the turrets perspective.

The maximum number of auto turrets allowed per car. Cars owned by players with additional permissions may have a higher value. Regardless of this value, the number of auto turrets cannot exceed the number of modules on the car.Note: You can also reduce the practical limit of auto turrets per car by restricting which modules they can be deployed to. For example, if you only allow auto turrets to be deployed to flatbed modules, a 2-socket car can have at most one auto turret (assuming it's driveable). For longer cars, players will have to choose between more turrets and other utilities. You can also restrict turrets to only 2-socket modules.

EnableTurretPickup (true or false) -- While false, car turrets cannot be picked up with a hammer or with the RemoverTool pugin, and removing a module from a car will destroy the turret without adding an auto turret item to the player inventory.

OnlyPowerTurretsWhileEngineIsOn (true or false) -- While true, turrets will not be powered unless the engine is on.

TargetPlayers (true or false) -- Whether car-mounted turrets should target real players.

TargetNPCs (true or false) -- Whether car-mounted turrets should target NPCs.

TargetAnimals (true or false) -- Whether car-mounted turrets should target NPC animals such as bears.

Settings for automatically adding turrets to cars when they spawn.NaturalCarSpawnsEnabled (true or false) -- While true, cars that spawn naturally along roads will automatically have turrets added to them, up to the limit determined by DefaultLimitPerCar, and according to the chances in SpawnChanceByModule.OtherCarSpawns.Enabled (true or false) -- While true, cars spawned by plugins (such as Spawn Modular Car or Vehicle Airdrops) will have turrets added to them automatically, up to the limit determined by DefaultLimitPerCar or based on the permissions of the car owner if applicable, and according to the chances in SpawnChanceByModule.RequirePermission (true or false) -- While true, cars spawned by plugins will only have turrets added to them if the car is owned by a player with the carturrets.spawnwithcar permission.SpawnChanceByModule -- For each module type (based on item short name), these values determine the percent chance (0 - 100) that modules of that type will automatically have a turret added to them when the car spawns.

For each module type (based on item short name), these values determine how an auto turret will be positioned relative to its parent module. These defaults were tested with modules in various positions with turrets facing forwards and backwards. Some modules, especially the small engine cockpit module, simply don't have an ideal position due to having a very small roof, but careful placement of modules and turrets can avoid any visual issues.

Note: You can also reduce the practical limit of auto turrets per car by restricting which modules they can be deployed to. For example, if you only allow auto turrets to be deployed to flatbed modules, a 2-socket car can have at most one auto turret (assuming it's driveable). For longer cars, players will have to choose between more turrets and other utilities. You can also restrict turrets to only 2-socket modules.

NaturalCarSpawnsEnabled (true or false) -- While true, cars that spawn naturally along roads will automatically have turrets added to them, up to the limit determined by DefaultLimitPerCar, and according to the chances in SpawnChanceByModule.

While true, cars spawned by plugins (such as Spawn Modular Car or Vehicle Airdrops) will have turrets added to them automatically, up to the limit determined by DefaultLimitPerCar or based on the permissions of the car owner if applicable, and according to the chances in SpawnChanceByModule.RequirePermission (true or false) -- While true, cars spawned by plugins will only have turrets added to them if the car is owned by a player with the carturrets.spawnwithcar permission.

For each module type (based on item short name), these values determine the percent chance (0 - 100) that modules of that type will automatically have a turret added to them when the car spawns.

Enabled (true or false) -- While true, cars that spawn naturally along roads will automatically have turrets added to them, up to the limit determined by DefaultLimitPerCar, and according to the chances in SpawnChanceByModule.

Enabled (true or false) -- While true, cars spawned by plugins (such as Spawn Modular Car or Vehicle Airdrops) will have turrets added to them automatically, up to the limit determined by DefaultLimitPerCar or based on the permissions of the car owner if applicable, and according to the chances in SpawnChanceByModule.

RequirePermission (true or false) -- While true, cars spawned by plugins will only have turrets added to them if the car is owned by a player with the carturrets.spawnwithcar permission.