Block Display Vehicle

Features

• Vehicles built 100% from /summon commands (block_display, item_display, text_display): no proprietary model required, everything is configurable.
• Only one example vehicle (car) ships by default — every other vehicle model is up to you to create, see Building a custom vehicle with BDEngine.
• Multiple seats with a dedicated driver seat, optional animated wheels (rotation, steering, spin).
• Keyboard driving (WASD) via the Player.getCurrentInput() API, with per-vehicle acceleration, friction and direction settings.
• In-game editor (/vehicle edit): clickable chat GUI + a floating in-game indicator to position seats and wheels without typing any coordinates.
• Speedometer HUD in km/h (faked, based on the real speed in blocks/tick) + a fuel gauge.
• Per-vehicle key/anti-theft system (unique UUID), with a hacking tool to steal a key.
• Fuel system with spawnable/removable fuel pumps, refuel by clicking.
• Shop (/vehicle shop) and garage (/vehicle garage): players buy their vehicles and spawn/store them at will; the key and fuel level are preserved across every store cycle.
• Economy: charges Vault if present, otherwise emeralds straight from the inventory.
• Persistence: pumps survive a server restart; vehicles, on the other hand, belong to players through the garage (never left alive in the world between two startups, see below).
• i18n: every message lives in lang/messages_fr.yml and lang/messages_en.yml, language picked via config.yml (language: fr or en).
• /vehicle enter or /vehicle exit: a click-free alternative for Bedrock/Geyser players (see below).

Installation

1. Drop the .jar into your Paper 1.21.11 server's plugins/ folder.
2. (Optional) Install Vault + an economy plugin if you want to charge real server currency instead of emeralds.
3. Start the server once to generate plugins/BlockDisplayVehicles/config.yml.
4. Edit config.yml (language, vehicles, pumps...), then /vehicle reload.

Permissions
Permission Default Description
bdvehicles.use true Spawning and driving vehicles, /vehicle enter / exit, shop and garage
bdvehicles.admin op Reload, removal, editing (seats/wheels), pumps, hacking tool
Commands
Aliases for /vehicle: /bdv, /veh

Command Permission Description
/vehicle spawn <id> use Spawns vehicle <id> at your position and gives you its key
/vehicle remove admin Removes the vehicle you're driving or the closest one (< 20 blocks)
/vehicle list use Lists the vehicles defined in config.yml
/vehicle reload admin Reloads config.yml and the language files
/vehicle enter [index] use Boards the closest vehicle without having to click (useful on Bedrock)
/vehicle exit use Leaves the current vehicle
/vehicle edit admin Opens the editor (chat GUI) on the targeted/driven vehicle
/vehicle editstop admin Closes the current edit session
/vehicle save admin Saves the seat/wheel changes made while editing
/vehicle seat list admin Lists the seats of the vehicle being edited
/vehicle seat add <x> <y> <z> [driver] admin Adds a seat at a relative position
/vehicle seat set <index> <x> <y> <z> admin Repositions an existing seat
/vehicle seat nudge <index> <axis> <delta> admin Moves a seat by a delta on an axis (x/y/z)