Skip to main content

Permissions

All VehiclesPlus permission nodes. Every node defaults to op unless stated otherwise, so by default operators can do everything and normal players can only use the basics (open their garage, drive, redeem vouchers they were given).

tip

Grant vp.admin.* to give a rank full access to everything. Each vp.admin.<group> node is a bundle that grants all the child nodes listed below it.


Admin bundles

PermissionGrants
vp.admin.*Everything (all bundles below).
vp.admin.vehiclesAll /v (vehicles) sub-permissions.
vp.admin.garageAll /vg (garage) sub-permissions.
vp.admin.modelAll /vm (model) sub-permissions.
vp.admin.fuelAll /fuel sub-permissions.
vp.admin.addonAll /addon sub-permissions.

Vehicles (vp.admin.vehicles)

PermissionAllows
vp.spawn.admin/v spawn
vp.spawnpersistent.admin/v spawnpersistent
vp.give/v give
vp.voucher/v getvoucher
vp.shop/v shop
vp.shop.others/v shop <player>
vp.repair.admin/v repair

Garages (vp.admin.garage)

PermissionAllows
vp.garage.open.others/vg open <garage> (other garages)
vp.garage.create/vg create
vp.garage.delete.own/vg delete (your own garages)
vp.garage.delete.othersDelete garages owned by others
vp.garage.member.add/vg addmember
vp.garage.member.remove/vg removemember
vp.garage.setowner/vg setowner

Models (vp.admin.model)

PermissionAllows
vp.model.list/vm list
vp.model.info/vm info
vp.model.reload/vm reload
vp.model.delete/vm delete

Fuel (vp.admin.fuel)

PermissionAllows
vp.fuel.give/fuel give
vp.fuel.buy/fuel buy
vp.fuel.shop/fuel shop
vp.fuel.shop.others/fuel shop <player>

Addons (vp.admin.addon)

PermissionAllows
vp.addon.givepaint/addon givepaint
vp.addon.givewheel/addon givewheel

Per-vehicle (action) permissions

On top of the command permissions above, each vehicle model can require players to have a permission before they may buy, adjust, spawn or ride it. The wildcard nodes that grant access to all vehicles are configurable in config.yml (see Configuration → permissions). The defaults are:

ActionWildcard permission
Buy any vehiclevp.buy.*
Adjust any vehiclevp.adjust.*
Spawn any vehiclevp.spawn.*
Ride any vehiclevp.ride.*

To restrict access to a single model, replace the * with the model id — for example vp.buy.examplecar only lets a player buy the examplecar model. The exact node a model checks is configured in that model's .hjson under its permissions block.

note

A model can also allow players to sit in it without the ride permission. See the model's permissions.cansitwithoutride setting (visible via /vm info <model>).


A common, safe starting point:

# Staff / admins
vp.admin.*: true

# Normal players — can use shops, drive what they're allowed, redeem vouchers
vp.shop: true
vp.fuel.shop: true
vp.fuel.buy: true
vp.buy.*: true
vp.spawn.*: true
vp.ride.*: true
vp.adjust.*: true

(Players can always open their own garage with /vg — no permission needed.)