Custom vehicles, transport, and vehicle combat for TF-Minecraft.
VehicleFramework brings modeled vehicles into the Minecraft world with their own movement, seats, components, and controls. Its systems support ground travel, boats, aircraft, and trains, letting each vehicle combine the features suited to its role.
Fuel, damage, ownership, and repairs make vehicles persistent parts of the world, with uses ranging from passenger transport and hauling to armed encounters.
- Different ways to travel — movement systems for ground vehicles, floating hulls, wings, balloons, and rail travel.
- Drivers and passengers — multiple seats, ownership rules, access lists, and vehicle tickets control who can ride.
- Vehicle upkeep — fuel tanks, damageable components, and repairs give vehicles ongoing maintenance needs.
- Cargo and towing — vehicle containers and towing support transport beyond individual passengers.
- Mounted weapons — vehicle weapons use ammunition systems including bullets, projectiles, bombs, and torpedoes.
- Connected trains — track and carriage systems support railway vehicles and linked consists.
VFBuilders adds vehicle construction gameplay around VehicleFramework.
Originally created by Drefvelin.
Technical documentation is maintained in TF-Minecraft/Docs.
User guide: commands, models, vehicle YAML, weapons, and trains.
With Java 21 and the pinned plugin dependencies installed (see the Build workflow), run:
mvn -B --no-transfer-progress clean verifyJUnit 5 and Mockito cover track geometry, train routing and placement,
persistence, vehicle controls, weapons and plugin lifecycle. They do not start
a live Paper server or load ModelEngine models. Surefire writes test results to
target/surefire-reports/. JaCoCo requires 100% line coverage across all
production classes, with no coverage exclusions; instruction and branch coverage
are reported separately. HTML/XML reports are written to target/site/jacoco/.
The Build workflow runs verification on pull requests and pushes to main and
uploads both test and coverage reports.
Copyright (c) 2026 TF-Minecraft contributors.
TF-Minecraft-authored material in this repository is licensed under the Artistic License 2.0. Third-party dependencies and bundled material retain their own licenses.