From 43cdfc72491e017ef9af7389784cdda4ba8394d1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 23:21:31 +0000
Subject: [PATCH 1/3] Initial plan


From a45554c5564b80ccd6099f16f3a53c396112e932 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 23:24:19 +0000
Subject: [PATCH 2/3] Add comprehensive English README.md

Co-authored-by: Snabeldier <79211348+Snabeldier@users.noreply.github.com>
---
 README.md | 134 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 134 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9857c49
--- /dev/null
+++ b/README.md
@@ -0,0 +1,134 @@
+# FastCarAPI
+
+A comprehensive vehicle management API for Minecraft servers using PaperMC. FastCarAPI provides a robust framework for creating, managing, and interacting with various types of vehicles in the Minecraft world.
+
+## Features
+
+### Vehicle Types
+- **Cars** - Combustion and electric vehicles
+- **Motorcycles** - Powered two-wheelers
+- **Scooters** - Combustion and electric scooters
+- **Bicycles** - Standard and electric (pedelec) bicycles
+- **Helicopters** - Aircraft with vertical takeoff capabilities
+
+### Core Features
+- **Unique Identification** - Each vehicle has a unique license plate
+- **Customizable Models** - Support for custom vehicle designs with materials and custom model data
+- **Color System** - Full vehicle color customization
+- **Physics Engine** - Realistic vehicle physics including:
+  - Air resistance
+  - Mass and weight
+  - Brake force
+  - Grip and traction
+- **Power Systems**
+  - Combustion engines (refuelable)
+  - Electric motors (rechargeable)
+- **Storage Capabilities** - Vehicles can have storage compartments
+- **Tire Management** - Durability tracking for tires
+- **Event System** - Vehicle spawn, vanish, and penalty events
+- **Parking & Garages** - Garage system with parking tickets
+- **Administration** - Penalty and fine management
+- **Component System** - Support for seats, addons, and attachments with custom positioning
+
+## Requirements
+
+- **Java 21** or higher
+- **PaperMC 1.21.3** or compatible version
+- **MineValley CoreAPI 1.300.2** or higher
+
+## Installation
+
+### Maven
+
+Add the MineValley GitHub repository to your `pom.xml`:
+
+```xml
+<repositories>
+    <repository>
+        <id>github</id>
+        <url>https://maven.pkg.github.com/MineValley/FastCarAPI</url>
+    </repository>
+</repositories>
+```
+
+Add the dependency:
+
+```xml
+<dependency>
+    <groupId>minevalley.fastcar</groupId>
+    <artifactId>api</artifactId>
+    <version>0.1.6</version>
+</dependency>
+```
+
+## Usage
+
+FastCarAPI uses a provider pattern for accessing the API functionality. The API is designed to be implemented by a FastCar plugin, and then accessed through the API interfaces.
+
+### Accessing Vehicles
+
+Vehicles are accessed through their interfaces, which provide methods for:
+- Getting and changing vehicle properties (color, owner, model)
+- Accessing physics objects for world interaction
+- Managing vehicle state (spawned, parked, etc.)
+
+### Vehicle Hierarchy
+
+```
+Vehicle (base interface)
+├── RechargeableVehicle (electric vehicles)
+├── RefuelableVehicle (combustion vehicles)
+├── StorageVehicle (vehicles with storage)
+├── Car
+│   ├── ElectricCar
+│   └── CombustionCar
+├── Motorcycle
+├── Scooter
+│   ├── ElectricScooter
+│   └── CombustionScooter
+├── Bicycle
+│   └── Pedelec
+└── Helicopter
+```
+
+### Models and Manufacturing
+
+Each vehicle type has a corresponding model interface that defines:
+- Available colors
+- Physical dimensions and properties
+- Tire specifications
+- Seat and component configurations
+- Custom model data for rendering
+
+## Events
+
+The API provides events for tracking vehicle lifecycle:
+- `VehicleSpawnEvent` - When a vehicle spawns in the world
+- `VehicleVanishEvent` - When a vehicle despawns
+- `PenaltyIssuedEvent` - When a penalty is issued to a vehicle owner
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Project Information
+
+- **Group ID**: `minevalley.fastcar`
+- **Artifact ID**: `api`
+- **Version**: `0.1.6`
+- **Packaging**: JAR
+
+## Dependencies
+
+- **MineValley CoreAPI** - Core functionality and user management
+- **PaperMC** - Minecraft server API
+- **Lombok** - Code generation
+- **Gson** - JSON serialization
+
+## Contributing
+
+This is part of the MineValley project. For issues, feature requests, or contributions, please refer to the project's issue tracker.
+
+## Related Projects
+
+- [MineValley CoreAPI](https://github.com/MineValley/CoreAPI) - Required dependency providing core functionality

From 01cefb6fb7ae7ec843fbfe213ff3895ddaf26d53 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 23:26:01 +0000
Subject: [PATCH 3/3] Fix vehicle hierarchy to accurately reflect code
 structure

Co-authored-by: Snabeldier <79211348+Snabeldier@users.noreply.github.com>
---
 README.md | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 9857c49..0329103 100644
--- a/README.md
+++ b/README.md
@@ -76,19 +76,18 @@ Vehicles are accessed through their interfaces, which provide methods for:
 
 ```
 Vehicle (base interface)
-├── RechargeableVehicle (electric vehicles)
-├── RefuelableVehicle (combustion vehicles)
-├── StorageVehicle (vehicles with storage)
-├── Car
-│   ├── ElectricCar
-│   └── CombustionCar
-├── Motorcycle
-├── Scooter
-│   ├── ElectricScooter
-│   └── CombustionScooter
+├── RechargeableVehicle (electric vehicles - mixin)
+├── RefuelableVehicle (combustion vehicles - mixin)
+├── StorageVehicle (vehicles with storage - mixin)
+├── Car (base for cars, extends StorageVehicle)
+│   ├── ElectricCar (extends Car, RechargeableVehicle)
+│   └── CombustionCar (extends Car, RefuelableVehicle)
+├── Motorcycle (extends RefuelableVehicle, StorageVehicle)
+├── ElectricScooter (extends RechargeableVehicle, StorageVehicle)
+├── CombustionScooter (extends RefuelableVehicle, StorageVehicle)
 ├── Bicycle
-│   └── Pedelec
-└── Helicopter
+├── Pedelec (extends RechargeableVehicle)
+└── Helicopter (extends RefuelableVehicle, StorageVehicle)
 ```
 
 ### Models and Manufacturing