diff --git a/vehiclesplus-v3/api/examples.md b/vehiclesplus-v3/api/examples.md new file mode 100644 index 0000000..d86d48d --- /dev/null +++ b/vehiclesplus-v3/api/examples.md @@ -0,0 +1,59 @@ +--- +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 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. + } +} +``` \ No newline at end of file