Skip to content

About

Configurable vehicles, movement physics, turrets, and weapons for TFMC Minecraft servers.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Latest commit

 

History

174 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VehicleFramework

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.

Features

  • 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.

Related projects

VFBuilders adds vehicle construction gameplay around VehicleFramework.

Originally created by Drefvelin.

Documentation

Project documentation

Technical documentation is maintained in TF-Minecraft/Docs.

User guide: commands, models, vehicle YAML, weapons, and trains.

Tests

With Java 21 and the pinned plugin dependencies installed (see the Build workflow), run:

mvn -B --no-transfer-progress clean verify

JUnit 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.

Server-owned vehicles

Staff can run /vf server and right-click a vehicle within 60 seconds to convert it. /vf server list lists live and stored server vehicles (also available from console). Conversion clears the whitelist, group switches and tickets. These vehicles cannot be claimed. Use requires vf.server.use (default op) or vf.admin. Whitelists, group switches and tickets cannot be enabled on them. Revert with /vf takeover [character] or the staff ownership menu's release button.

API consumers can recognize the case-insensitive owner value server with VehicleOwners.isServer; its display name is Server. It is neither unowned nor a personal/character owner. Conversion fires the usual ownership events with staff reason SERVER. The synchronous ServerVehicleUseEvent defaults to denied; listeners may call setAllowed(true) to admit a player without permission, for example for a side assigned by staff during a battle. Coupled cars also check their locomotive's access. cleanup.keep-owners: [server] protects these vehicles from configured cleanup.

License

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.

About

Configurable vehicles, movement physics, turrets, and weapons for TFMC Minecraft servers.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages