Garages, shop and trading
Where vehicles live, who can use them, and how they move from one player to another.
Garages
Every player has a personal garage. /garage create creates company garages, shared with other players through roles. /garage opens the menu; from there you open vehicles, the shop and the settings (members, roles, name, owner, deletion).
Garage roles and permissions
| Default role | Can |
|---|---|
| guest | Get on (RIDE). |
| driver | Get on, open the trunk, lock and unlock the vehicle, take it out (RIDE, OPEN_TRUNK, LOCK, SPAWN). |
| manager | Everything except renaming and deleting the garage, managing roles and transferring vehicles. |
| owner | Everything. |
Default roles cannot be changed; more can be created from the menu, choosing permissions one by one: RIDE, OPEN_TRUNK, LOCK, SPAWN, REPAIR, REMOVE, BUY, UPGRADE, TUNE, VEHICLE_RENAME, DELETE, TRANSFER_VEHICLE, MANAGE_MEMBERS, MANAGE_ROLES, RENAME, DELETE_GARAGE.
Shop
The shop sells models with price greater than 0: the player pays the price with their Vault account and the money leaves the economy. Anyone with the ev.admin permission sells to themselves with /veicolo sell (no name): the vehicle arrives in their garage for free.
The voucher (/veicolo getvoucher) is an item worth one vehicle: whoever uses it receives it in their garage.
Selling and transferring between players
| Command | What it does |
|---|---|
/veicolo sell <player> | The seller picks a model, color and use (personal or commercial) and confirms. The buyer pays the shop price. With ev.admin the player can be omitted (or you write your own name): the vehicle goes into your own garage, for free. |
/veicolo transfer <player> [price] | Moves a vehicle from your personal garage to the buyer's. With a price it is a sale, without one it is a gift. |
/veicolo accept and /veicolo deny | The buyer answers (they also appear as clickable buttons in the message). |
Requests expire after requests.timeout-seconds (60) or if either player logs out. With distance.enabled the two players must be within distance.blocks blocks in the same world, both when sending and when accepting. The transferred vehicle must not be out on the road.
Plates and categories
Every vehicle has a unique plate, generated with plate.pattern (default XXXXXX): X letter or digit, L letter, N digit, any other character stays as is (for example LL-NNN-LL). /veicolo targa <plate> shows the owner, model and status. A model's category is its file's category field, or vehicles-registry.yml.
Company garages and storage areas
- Appearance.
company-garages.ymlgives a company garage its own title and icon in the menus. - Staff.
/staffgarage <player>opens a player's personal garage. - Storage areas.
/vehicle-storage editgives a wand: left and right click pick the two corners, thensave <id>. Areas are stored invehicle-storages.yml.