Spawn Modular Car

The following permissions control the maximum number of module sockets the player is allowed to have on their car. If none of these are granted, the player cannot spawn a car, even from a preset.

Allows spawning a car with 2 sockets.

Allows spawning a car with 2-3 sockets.

Allows spawning a car with 2-4 sockets.

Granting the following permissions will cause the player's car to automatically spawn with engine parts of the corresponding quality in each engine module. If none of these are granted, the car spawns without any engine parts, so it cannot be driven until a player adds them.

Spawn your car with low quality engine parts.

Spawn your car with medium quality engine parts.

Spawn your car with high quality engine parts.

Presets:

Allows you to spawn your car from a personal preset. Also enables the save, update, rename and delete preset commands.

Required to use mycar load <preset> and mycar common load <preset>.

Required to use mycar common <preset> and mycar common load <preset>.

Required to manage common presets.

Required to use the givecar command.

Misc:

Required to use mycar fix.

Required to use mycar fetch.

Required to use mycar destroy.

Fuels your car automatically.

Required to use the automatic code lock feature (i.e., mycar autocodelock).

Required to use the automatic key lock feature (i.e., mycar autokeylock).

spawnmodularcar.autofilltankers - Required to use automatic filling of tanker modules (i.e. mycar autofilltankers).

Start your car's engine instantly.

Spawn a modular car using your "default" preset if saved, else spawn a random car with the maximum number of allowed sockets based on your permissions.

mycar <2|3|4> -- Spawn a random modular car with the specified number of sockets.

Spawn a modular car from the specified personal preset. See the personal presets section for more details.

Spawn a modular car from a common preset managed by privileged adminstrators. See the common presets section for more details.

Spawn a car for the target player using the specified server-wide preset. See the server presets configuration section for details.

When a modular car is spawned, it will be at full health. Additionally, depending on your granted permissions and personal settings:

It may be fueled (amount is configurable).

It may automatically have a code lock, via the Vehicle Deployed Locks plugin.

It may automatically have a key lock, via the Vehicle Deployed Locks plugin.

All tanker modules may be automatically filled with fresh water (amount is configurable).

All engine modules may be automatically filled with your highest allowed quality of engine parts.

Fix your car. This restores it to original condition as though you had just spawned it, with the exception that it will not add or remove a lock, regardless of your AutoCodeLock or AutoKeyLock setting. Engine parts will also be repaired. If you were granted any of the spawnmodularcar.engineparts.* permissions, missing engine parts are added, and lower quality parts are replaced with the maximum quality you are allowed.

Teleport your car to you in an upright position.

Destroy your car, allowing you to spawn a new one.Non-empty storage modules will drop a bag with their items next to where the car was located.If the car's engine modules contained parts that are of higher quality than are allowed by your spawnmodularcar.engineparts.* permissions, those will be added to your inventory if there is space, else dropped to the ground in front of you.

Print a list of available commands and their usage. Only shows commands allowed by your permissions.

Non-empty storage modules will drop a bag with their items next to where the car was located.

If the car's engine modules contained parts that are of higher quality than are allowed by your spawnmodularcar.engineparts.* permissions, those will be added to your inventory if there is space, else dropped to the ground in front of you.

Players with the spawnmodularcar.presets permission can save custom module configurations, allowing them to spawn their car or change their car in-place with a saved preset.

List your saved module configuration presets.

Save your car's current module configuration under the specified preset name.

Overwrite an existing preset with your car's current module configuration.

Load the specified preset (partial name matching supported) onto your existing car, replacing any modules that don't match the preset. Loading a preset is not allowed if your current car is occupied or if it has a different number of sockets than the preset.The car will be fixed according to the same rules as mycar fix.The car's locks will be removed if the car no longer has at least one cockpit module.Non-empty storage modules that were replaced will drop a bag with their items next to the car.Any engine parts of higher quality than are allowed by your spawnmodularcar.engineparts.* permissions will be redistributed throughout the engine modules in the loaded preset, with the highest quality parts towards the front-most engine modules. If any engine parts are left over, those will be added to your inventory if there is space, else dropped to the ground in front of you.

Rename a preset.

Delete the specified preset.

The car will be fixed according to the same rules as mycar fix.

The car's locks will be removed if the car no longer has at least one cockpit module.

Non-empty storage modules that were replaced will drop a bag with their items next to the car.

Any engine parts of higher quality than are allowed by your spawnmodularcar.engineparts.* permissions will be redistributed throughout the engine modules in the loaded preset, with the highest quality parts towards the front-most engine modules. If any engine parts are left over, those will be added to your inventory if there is space, else dropped to the ground in front of you.

Note: The save, update, load and delete commands will use the "default" preset if the preset name is not specified.

Players with the spawnmodularcar.presets.common.manage permission can optionally save their cars as common presets for the rest of the server to use. Any player with the spawnmodularcar.presets.common permission can list common presets and spawn a car from a common preset, as long as the player's spawnmodularcar.spawn.* permission allows for the number of sockets in the preset.

List all common presets that you have permission to spawn, based on your spawnmodularcar.spawn.* permission.

Load the specified common preset onto your existing car. See the personal preset section for details on how loading works.

Save your car's current module configuration under the specified common preset name.

Overwrite an existing common preset with your car's current module configuration.

Rename a common preset.

Delete the specified common preset.

Toggle AutoCodeLock. While ON, spawning your car will automatically create a code lock and add it to the front-most cockpit module if it has one. Requires spawnmodularcar.autocodelock permission.

Toggle AutoKeyLock. While ON, spawning your car will automatically create a key lock and add a matching key to your inventory, as long as the car has at least one cockpit module. Requires spawnmodularcar.autokeylock permission.

Toggle AutoFillTankers. While ON, spawning your car, fixing it, or loading a preset will automatically fill any tanker modules to allowed capacity (configurable) with fresh water, replacing any salt water already in them. Requires spawnmodularcar.autofilltankers permission.

{ "CanSpawnWhileBuildingBlocked": false, "CanFetchWhileBuildingBlocked": false, "CanFetchWhileOccupied": false, "CanDespawnWhileOccupied": false, "DismountPlayersOnFetch": true, "FuelAmount": 500, "FreshWaterAmount": -1, "MaxPresetsPerPlayer": 10, "EnableEffects": true, "DisallowedMonuments": [], "Cooldowns": { "SpawnCarSeconds": 3600, "FetchCarSeconds": 600, "LoadPresetSeconds": 3600, "FixCarSeconds": 3600 }, "Presets": [] }

CanSpawnWhileBuildingBlocked (true or false) -- Whether to allow players to spawn their car while they are building blocked.

CanFetchWhileBuildingBlocked (true or false) -- Whether to allow players to fetch their car while they are building blocked.

CanFetchWhileOccupied (true or false) -- Whether to allow players to fetch their car while it's occupied. If true, fetchinig a car will safely eject players from seating and flatbed modules if DismountPlayersOnFetch is true, else those players will be teleported with the car.

CanDespawnWhileOccupied (true or false) -- Whether to allow players to use mycar destroy while their car is occupied. If true, despawning a car will safely eject players from seating and flatbed modules.

DismountPlayersOnFetch (true or false) -- Whether to dismount all players from a car when it is fetched. Has no effect unless CanFetchWhileOccupied is also true.

The amount of low grade fuel to add to the fuel tank when spawning. Only applies if the player has the spawnmodularcar.autofuel permission. When fixing the car or loading a preset, only the amount missing will be added to reach this minimum target value. Defaults to -1 which represents maximum stack size.

The amount of fresh water to add to each of the car's tanker modules when spawning. Only applies if the player has the spawnmodularcar.autofilltankers permission and has the AutoFillTankers setting on. Defaults to -1 which represents maximum stack size. Note: If for some reason the car has multiple tankers (i.e., no other modules), this amount will be added to each one.

The maximum number of module configuration presets each player is allowed to save.

EnableEffects (true or false) -- Enable audio and visual effects when spawning a car from a preset, using mycar fix or mycar load.

List of monument short names where cars cannot be spawned or fetched. For example, ["powerplant", "trainyard"]. These do not have to be exact matches, so ["oilrig"] will apply to both "oilrig_1" and "oilrig_2". Requires the Monument Finder plugin to be installed. See the Monument Finder documentation for how to determine monument short names.

Various cooldowns for balancing.

Server presets must be manually defined in the plugin's configuration file. A car can be spawned for a player using a server preset with the givecar <player> <preset> command. Cars spawned this way will use the settings that are provided in the preset, instead of using the general plugin configuration, player permissions and player settings. These cars do not count towards the player limit of one car, nor can they be spawned or interacted with using mycar.

Here is an example list of presets to get you started.

"Presets": [ { "Name": "LongChassis", "Options": { "Modules": [0, 0, 0, 0] } }, { "Name": "TourBus", "Options": { "Modules": [ "vehicle.1mod.cockpit.with.engine", "vehicle.2mod.passengers", "vehicle.1mod.rear.seats" ], "EnginePartsTier": 2, "FuelAmount": 100, "CodeLock": true } }, { "Name": "ArmoredCar", "Options": { "Modules": [ "vehicle.1mod.engine", "vehicle.1mod.cockpit.armored", "vehicle.1mod.cockpit.armored" ], "EnginePartsTier": 3, "FuelAmount": 500, "KeyLock": true } }, { "Name": "DoubleTanker", "Options": { "Modules": [ "vehicle.2mod.fuel.tank", "vehicle.2mod.fuel.tank" ], "FreshWaterAmount": 50000 } } ],

Here are all of the available options you can define per preset. The only required option is Modules. The rest default to 0 or false.

List of module item ids or short names that will be added to the car automatically. The number 0 represents an empty socket. Item names and ids can be found on the uMod item list page.Previously this field was named ModuleIDs. That name still works for backwards compatibility but it only accepts ids.

CodeLock (true or false) -- Whether to deploy a code lock to the car.

KeyLock (true or false) -- Whether to create a key lock and add a matching key to the player's inventory.

EnginePartsTier (0 - 3) -- The quality of engine parts to automatically add to all engine modules (0 for no engine parts).

The amount of fuel to put in the fuel tank (-1 for max).

The amount of fresh water to add to each tanker module if applicable (-1 for max).

Previously this field was named ModuleIDs. That name still works for backwards compatibility but it only accepts ids.