59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
|
---
|
||
|
|
title: Examples
|
||
|
|
description: Example usages of the api
|
||
|
|
published: false
|
||
|
|
date: 2024-12-28T21:11:02.102Z
|
||
|
|
tags: developers
|
||
|
|
editor: markdown
|
||
|
|
dateCreated: 2024-12-28T21:11:02.102Z
|
||
|
|
---
|
||
|
|
|
||
|
|
# VehiclesPlus API Examples
|
||
|
|
|
||
|
|
In this section, you'll find additional examples of how to use the VehiclesPlus API (v3) for various tasks.
|
||
|
|
|
||
|
|
## Example 1: Adding a Car to Someone's Garage
|
||
|
|
|
||
|
|
```java
|
||
|
|
// Give car to garage
|
||
|
|
public void giveCar(Garage garage, String vehicleType) {
|
||
|
|
// Attempt to create a vehicle
|
||
|
|
StorageVehicle vehicle = VehiclesPlusAPI.createVehicle(vehicleType);
|
||
|
|
|
||
|
|
if (vehicle == null) {
|
||
|
|
System.err.println("Failed to create vehicle of type: " + vehicleType);
|
||
|
|
return; // Exit if the vehicle could not be created
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add the vehicle's UUID to the garage
|
||
|
|
garage.addVehicle(vehicle.getUuid());
|
||
|
|
System.out.println("Vehicle created and added to the garage successfully.");
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example 2: Adding a Vehicle to the Player's Default Garage
|
||
|
|
|
||
|
|
```java
|
||
|
|
// Give car to player's default garage
|
||
|
|
public void giveCar(Player player, String vehicleType) {
|
||
|
|
// Attempt to create a vehicle
|
||
|
|
StorageVehicle vehicle = VehiclesPlusAPI.createVehicle(vehicleType);
|
||
|
|
|
||
|
|
// Retrieve the player's default garage
|
||
|
|
Optional<Garage> optionalGarage = VehiclesPlusAPI.getGarage(player.getName());
|
||
|
|
|
||
|
|
if (vehicle == null) {
|
||
|
|
System.err.println("Failed to create vehicle of type: " + vehicleType);
|
||
|
|
return; // Exit if the vehicle could not be created
|
||
|
|
}
|
||
|
|
|
||
|
|
if (optionalGarage.isPresent()) {
|
||
|
|
Garage garage = optionalGarage.get();
|
||
|
|
garage.addVehicle(vehicle.getUuid());
|
||
|
|
System.out.println("Vehicle created and added to the garage successfully.");
|
||
|
|
} else {
|
||
|
|
System.err.println("Garage not found for player: " + player.getName());
|
||
|
|
// Optionally, you could create a new garage for the player here if the API allows it.
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|