diff --git a/vehiclesplus-v3/api.md b/vehiclesplus-v3/api.md index aa9121a..eba5b3e 100644 --- a/vehiclesplus-v3/api.md +++ b/vehiclesplus-v3/api.md @@ -1,8 +1,8 @@ --- -title: API -description: Api usage examples +title: Getting Started +description: Api usage published: false -date: 2024-12-28T21:07:51.850Z +date: 2024-12-28T21:08:25.669Z tags: developers editor: markdown dateCreated: 2024-12-28T20:10:42.650Z 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