Skip to content

MTVehicles/MinetopiaVehicles

Repository files navigation

MinetopiaVehicles

A realistic vehicles plugin for your Minecraft server!

GitHub release (latest by date including pre-releases) Spiget Version Spiget Version Spiget Stars

❗USE /VEHICLE LANGUAGE TO CHANGE THE LANGUAGE❗

Messages in the plugin can be displayed in multiple languages. (Default: English) You can find them here.


We support all major Paper versions from 1.12.2!

✅ For the list of compatible versions, see wiki.
✅ We support latest patch versions – e.g. 1.16.5 is supported, but 1.16.1 is not.
✅ We only support Spigot/Paper. Other forks such as Purpur and Leaf are not supported.
❌ We don't support 1.14.x due to compatibility issues.
❌ 1.12.1 and lower is NOT a will NOT be supported!


Useful links

See our new wiki or contact us via Discord for support!

⚠️ You will not receive any support regarding unsupported Minecraft versions or other than latest plugin versions!


How to set up the plugin?

1. Download the latest version

  • Latest stable releases are always published on Spigot.org.

Put the downloaded plugin into your server's plugins/ folder.

2. Download the resource pack

You may set it as a server resource pack, or everyone would have to download the resource pack individually. (For instance, take a look here.)

⚠ The vehicles WON'T look properly without the resource pack.

3. Restart the server

Restart the server. No explanation needed, right? Right?

4. Enjoy!

Et voilà, it's working! Don't forget to set your language using /vehicle language.

If this did not work don't hesitate to contact the support on our Discord server.


Commands & Permissions

Main commands

Command Description permission
/vehicle info Get information about a vehicle None, mtvehicles.admin to display admin info
/vehicle help Get a list of all the possible commands None, mtvehicles.admin to display admin info
/vehicle version Get info about the plugin (use this on discord) mtvehicles.admin
/vehicle language Change the plugin language mtvehicles.admin or mtvehicles.language

Vehicle specific commands

These commands can only be executed by the owner of the vehicle. Hold a vehicle in your hand while executing these.

Note: You may use some of these commands while sitting inside a vehicle, as long as you're the vehicle's owner.

Command Description Permission
/vehicle public Let everyone sit in your car None
/vehicle private Only allow people who have access to sit in your car None
/vehicle addrider %player% Add a rider to your vehicle None
/vehicle addmember %player% Add a member to your vehicle None
/vehicle removerider %player% Remove a rider from your vehicle None
/vehicle removemember %player% Remove a member from your vehicle None
/vehicle trunk Open the trunk of your vehicle None
/vehicle repair Restore the health of a vehicle (vehicle damage must be enabled in the config.yml) mtvehicles.repair
/vehicle refill Refill the vehicle's fuel mtvehicles.refill

Moderation commands

Command Description Permission
/vehicle edit Adjust vehicle settings mtvehicles.edit
/vehicle menu Open a menu containing all the vehicles mtvehicles.menu
/vehicle give %player% %vehicle% [--voucher:true] Give a vehicle/voucher to a player (uses tab completer) mtvehicles.givevoucher or mtvehicles.givecar
/vehicle restore A menu to recover vehicles mtvehicles.restore
/vehicle benzine Open the menu with jerrycans for the fuel mtvehicles.benzine
/vehicle givefuel %player% %amount% Give a jerrycan to a specific player mtvehicles.givefuel
/vehicle reload Reload the plugin's config files mtvehicles.reload
/vehicle setowner %player% Set an owner of a vehicle mtvehicles.setowner
/vehicle delete Remove a vehicle in your hand from the data mtvehicles.delete
/vehicle despawn %license-plate% Despawn the vehicle from all worlds (doesn't remove from the DB) mtvehicles.despawn
/vehicle update Update the plugin to the latest version mtvehicles.update
/vehicle givevoucher %player% %uuid% Give a voucher to a player (Use /vehicle give) mtvehicles.givevoucher
/vehicle givecar %player% %uuid% Give a vehicle to a player (Use /vehicle give) mtvehicles.givecar

Other permissions

Permission Description
mtvehicles.ride Whether a player can ride others' vehicles
mtvehicles.anwb Whether a player can pick up vehicles from water - useless unless ANWB turned on in config
mtvehicles.oppakken Whether a player can pick up vehicles
mtvehicles.filljerrycans Whether a player can fill up a jerry can - can be turned on/off in config
mtvehicles.filljerrycansforfree Whether a player can fill up a jerry can for free (Economy plugin + Vault necessary)
mtvehicles.limit.X Number of vehicles obtainable from /vehicle menu (Change X to an integer, e.g. mtvehicles.limit.6)
mtvehicles.nolimit No limit for vehicles obtainable from /vehicle menu (in case of issues)

Softdependencies

WorldGuard

You can download WorldGuard to get access to custom features with regions. (Do not forget that WorldGuard needs WorldEdit as its dependency.)

⚠ WorldGuard features are not supported on 1.12.2 as it is no longer maintained and uses older API version.

You can edit the behaviour in the config where you may also find information how to set up the custom flags.

⚠ WorldGuard features are disabled by default and have to be enabled in the config.

Custom flags State Description
mtv-gasstation ALLOW This region is a gas station. (More information can be found in the config.yml)
DENY You can NEVER fill up jerrycans here. No config option can change this.
mtv-place ALLOW Enables players to place vehicles, if region whitelist for placing is enabled.
DENY Prevents players from placing vehicles, if region blacklist for placing is enabled.
mtv-enter ALLOW Enables players to enter vehicles, if region whitelist for entering is enabled.
DENY Prevents players from entering vehicles, if region blacklist for entering is enabled.
mtv-pickup ALLOW Enables players to pick up vehicles, if region whitelist for picking up is enabled.
DENY Prevents players from picking up vehicles, if region blacklist for picking up is enabled.
mtv-use-car DENY Prevents all players from using CARS in this region.
mtv-use-tank DENY Prevents all players from using TANKS in this region.
mtv-use-hover DENY Prevents all players from using HOVERS in this region.
mtv-use-helicopter DENY Prevents all players from using HELICOPTERS in this region.
mtv-use-airplane DENY Prevents all players from using AIRPLANES in this region.

PlaceholderAPI

MTVehicles offers special placeholders for you to use.

Global placeholders

Placeholder Description
%mtv_fuel_pricePerLitre% Price of fuel (used while filling jerrycans)

Per-player placeholders

Placeholder Description
%mtv_vehicle_licensePlate% License plate of a vehicle a player is sitting in
%mtv_vehicle_name% Name of a vehicle a player is sitting in
%mtv_vehicle_type% Type of a vehicle a player is sitting in
%mtv_vehicle_fuel% Remaining fuel of a vehicle a player is sitting in
%mtv_vehicle_speed% Current speed of a vehicle a player is sitting in
%mtv_vehicle_maxspeed% Maximum speed of a vehicle a player is sitting in
%mtv_vehicle_place% Get information whether the player is a DRIVER or a PASSENGER
%mtv_vehicle_seats% Get the number of seats of a vehicle a player is sitting in
%mtv_vehicle_uuid% Get the UUID of a vehicle a player is sitting in
%mtv_vehicle_owner% Get the owner (username) of a vehicle a player is sitting in

Vault

You can download Vault to enable economy integration. (Of course, you must have an economy plugin that supports Vault.)

This includes:

  • Filling up jerrycans at gas stations for a specified price (can be adjusted in config.yml)!
  • Enabling vehicles' price (can be adjusted in vehicles.yml)
  • Buying vehicles and vouchers (with /mtv buy – or /mtv buycar and /mtv buyvoucher, if you wish to use UUID)

Additional commands

Command Description Permission
/vehicle buy %vehicle% [--voucher:true] Buy a vehicle/voucher (uses tab completer) mtvehicles.buyvoucher or mtvehicles.buycar
/vehicle buycar %uuid% Buy a vehicle (for the price specified in vehicles.yml) mtvehicles.buycar
/vehicle buyvoucher %uuid% Buy a voucher (which costs the same as a vehicle) mtvehicles.buyvoucher

Skript

You can perform some basic tasks with the Skript API. See the Skript page on MTVehicles Wiki for documentation.

README.md by Nikd0 & Jeffrey-H

About

A realistic vehicle plugin for your Minecraft server!

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 24

Languages