Vehicle Vendor Options

vehiclevendoroptions.ownership.allvehicles - Granting this to a player makes it so all vehicles they purchase from NPC vendors will spawn with the vehicle's OwnerID set to the player's Steam ID. This allows various plugins to enable features for the vehicle based on that player's permissions, such as no decay with Vehicle Decay Protection.

Alternatively, you can grant permissions by vehicle type:

vehiclevendoroptions.ownership.minicopter

vehiclevendoroptions.ownership.scraptransport

vehiclevendoroptions.ownership.attackhelicopter

vehiclevendoroptions.ownership.hotairballoon

vehiclevendoroptions.ownership.rowboat

vehiclevendoroptions.ownership.rhib

vehiclevendoroptions.ownership.solosub

vehiclevendoroptions.ownership.duosub

vehiclevendoroptions.ownership.ridablehorse

The following permissions come with this plugin's default configuration. Granting one to a player determines the price they must pay for the corresponding vehicle type.

vehiclevendoroptions.price.minicopter.scrap.500

vehiclevendoroptions.price.minicopter.scrap.250

vehiclevendoroptions.price.scraptransport.scrap.800

vehiclevendoroptions.price.scraptransport.scrap.400

vehiclevendoroptions.price.attackhelicopter.scrap.1750

vehiclevendoroptions.price.attackhelicopter.scrap.1250

vehiclevendoroptions.price.hotairballoon.scrap.100

vehiclevendoroptions.price.hotairballoon.scrap.50

vehiclevendoroptions.price.rowboat.scrap.80

vehiclevendoroptions.price.rowboat.scrap.40

vehiclevendoroptions.price.rhib.scrap.200

vehiclevendoroptions.price.rhib.scrap.100

vehiclevendoroptions.price.solosub.scrap.125

vehiclevendoroptions.price.solosub.scrap.50

vehiclevendoroptions.price.duosub.scrap.200

vehiclevendoroptions.price.duosub.scrap.100

You can add more custom prices in the plugin configuration under each vehicle type (PricesRequiringPermission), and the plugin will automatically generate a permission of the format vehiclevendoroptions.price.<vehicle>.<item>.<amount>. If a player has permission to multiple prices for a given vehicle type, only the last will apply, based on the order in the config.

Granting this to a player allows them to obtain vehicles from NPC vendors for free.

Alternatively, you can grant permission by vehicle type:

vehiclevendoroptions.free.minicopter

vehiclevendoroptions.free.scraptransport

vehiclevendoroptions.free.attackhelicopter

vehiclevendoroptions.free.hotairballoon

vehiclevendoroptions.free.rowboat

vehiclevendoroptions.free.rhib

vehiclevendoroptions.free.solosub

vehiclevendoroptions.free.duosub

vehiclevendoroptions.free.ridablehorse

Note: Having permission to free horses still requires a saddle to be in your inventory for the claim option to appear client-side, but claiming the horse will not consume the saddle.

To restrict vehicles to permission, set RequiresPermission to true in the plugin configuration under each vehicle type that you want to restrict. When a vehicle is restricted, players will only be allowed to purchase it if they have the corresponding permissions below.

vehiclevendoroptions.allow.all (all vehicles)

vehiclevendoroptions.allow.minicopter

vehiclevendoroptions.allow.scraptransport

vehiclevendoroptions.allow.attackhelicopter

vehiclevendoroptions.allow.hotairballoon

vehiclevendoroptions.allow.rowboat

vehiclevendoroptions.allow.rhib

vehiclevendoroptions.allow.solosub

vehiclevendoroptions.allow.duosub

Default configuration:

{ "Vehicles": { "Minicopter": { "RequiresPermission": false, "FuelAmount": 100, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 500, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 250, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "ScrapTransport": { "RequiresPermission": false, "FuelAmount": 100, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 800, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 400, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "AttackHelicopter": { "RequiresPermission": false, "FuelAmount": 100, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 1750, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 1250, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "HotAirBalloon": { "RequiresPermission": false, "FuelAmount": 75, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 100, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 50, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "Rowboat": { "RequiresPermission": false, "FuelAmount": 50, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 80, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 40, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "RHIB": { "RequiresPermission": false, "FuelAmount": 50, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 200, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 100, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "SoloSub": { "RequiresPermission": false, "FuelAmount": 50, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 125, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 50, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] }, "DuoSub": { "RequiresPermission": false, "FuelAmount": 50, "DespawnProtectionSeconds": 300.0, "PricesRequiringPermission": [ { "Amount": 200, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false }, { "Amount": 100, "ItemShortName": "scrap", "UseEconomics": false, "UseServerRewards": false } ] } } }

Each vehicle has the following options.

RequiresPermission (true or false) -- While true, players must have the vehiclevendoroptions.allow.<vehicle> permission to purchase vehicles of this type. While false, the vehicle type is open to all players.

The amount of low grade fuel to put in the vehicle's fuel tank when it spawns.Set to -1 for the max stack size of low grade fuel on your server.

The amount of time that purchased vehicles will be safe in the spawn location before new ones can be spawned in their place. Reducing this is favorable in high population servers and/or where vehicles are relatively cheap.Note: If you are having an issue where players cannot buy vehicles quickly enough in succession, you may want to consider using Monument Addons to add more vehicle vendors to monuments.

List of prices that can be granted to players with permission. Each price config generates a permission of the format vehiclevendoroptions.price.<vehicle>.<item>.<amount>. Granting one to a player overrides the price they will be charged. They will also see UI text on the screen indicating what the real price is, since the vanilla UI cannot be changed.Amount -- The amount of items, Economics currency or Server Rewards points required to purchase the vehicle.ItemShortName (default: "scrap") -- The short name of the item to charge the player.UseEconomics (true or false) -- While true, the Amount represents the price in Economics currency.Generated permission format: vehiclevendoroptions.price.<vehicle>.economics.<amount>If the Economics plugin is not loaded when the player talks to the vendor, another price config will be selected for the user if they have permission to any, or else the vanilla price will be used.UseServerRewards (true or false) -- While true, the Amount represents the price in Server Rewards points.Generated permission format: vehiclevendoroptions.price.<vehicle>.serverrewards.<amount>If the Server Rewards plugin is not loaded when the player talks to the vendor, another price config will be selected for the user if they have permission to any, or else the vanilla price will be used.

Set to -1 for the max stack size of low grade fuel on your server.

Note: If you are having an issue where players cannot buy vehicles quickly enough in succession, you may want to consider using Monument Addons to add more vehicle vendors to monuments.

The amount of items, Economics currency or Server Rewards points required to purchase the vehicle.

ItemShortName (default: "scrap") -- The short name of the item to charge the player.

UseEconomics (true or false) -- While true, the Amount represents the price in Economics currency.Generated permission format: vehiclevendoroptions.price.<vehicle>.economics.<amount>If the Economics plugin is not loaded when the player talks to the vendor, another price config will be selected for the user if they have permission to any, or else the vanilla price will be used.

UseServerRewards (true or false) -- While true, the Amount represents the price in Server Rewards points.Generated permission format: vehiclevendoroptions.price.<vehicle>.serverrewards.<amount>If the Server Rewards plugin is not loaded when the player talks to the vendor, another price config will be selected for the user if they have permission to any, or else the vanilla price will be used.

Generated permission format: vehiclevendoroptions.price.<vehicle>.economics.<amount>

If the Economics plugin is not loaded when the player talks to the vendor, another price config will be selected for the user if they have permission to any, or else the vanilla price will be used.

Generated permission format: vehiclevendoroptions.price.<vehicle>.serverrewards.<amount>

If the Server Rewards plugin is not loaded when the player talks to the vendor, another price config will be selected for the user if they have permission to any, or else the vanilla price will be used.

For reference, here are the vanilla scrap prices for vehicles.

Minicopter: 750

ScrapTransport: 1250

AttackHelicopter: 2250

HotAirBalloon: 150

Rowboat: 125

RHIB: 300

Solo sub: 200