# HeistTruckController.ver
# This script controls the armored truck heist mechanics.

using { /Fortnite.com/Devices }

# 1. Define our main device. 
# Think of this as the "Brain" of our heist.
heist_controller := class(creative_device):
    
    # 2. Variables (The Changing Stats)
    # A "variable" is a value that can change during the game, 
    # like a player's health or score.
    my_spawner: vehicle_spawner_armored_transport_device = ?
    vault_device: bank_vault_device = ?
    
    # Constants are set once and never change.
    # Here, Team 1 is "Security" (can drive), Team 2 is "Thieves" (can crack).
    const SECURITY_TEAM: int = 1
    const THIEF_TEAM: int = 2

    # 3. The "On Begin" Function
    # This runs once when the game starts. 
    # It's like the "Ready Up" screen before the match begins.
    OnBegin<override>()<suspends>: void = 
        # Find the spawner by its name. 
        # If you named your device differently, change "MyHeistTruck" here.
        my_spawner = GetDevice<vehicle_spawner_armored_transport_device>("MyHeistTruck")
        
        if (my_spawner != ?):
            # Spawn the truck immediately!
            # This is like pressing "Play" to start the event.
            spawned_vehicle := my_spawner.Spawn()
            
            # 4. Navigating the Scene Graph
            # The truck is the Parent. The vault is inside it.
            # We need to find the vault component inside the truck.
            # Note: In real UEFN, you might need to link the vault 
            # via a device connection or find it via the vehicle's components.
            # For this tutorial, we assume we can access the vault 
            # through the spawned vehicle's interface or a linked device.
            
            # Let's configure the driving rules.
            # Set the vehicle to only allow Security Team to drive.
            # This is like putting a lock on the driver's seat.
            my_spawner.SetAllowedTeams({SECURITY_TEAM})
            
            # Now, let's configure the vault.
            # We need to tell the vault who can break it.
            # Usually, you'd link a Bank Vault device to the truck, 
            # or use the truck's built-in vault interface.
            # Here is a simplified conceptual example of setting access:
            
            # If the truck has a built-in vault interface, we might do:
            # spawned_vehicle.SetVaultCrackAllowedTeams({THIEF_TEAM})
            
            # Since Verse APIs for specific vehicle components vary,
            # the most reliable beginner method is to use a SEPARATE 
            # Bank Vault device placed inside the truck, linked via 
            # a "On Interact" event from the truck's weak points.
            
            # For this example, we'll just confirm the truck is spawned.
            Print("The Armored Truck has arrived! Security team, drive it. Thieves, get ready to crack it.")
        else:
            Print("Error: Could not find MyHeistTruck. Check the device name!")

    # 5. A Helper Function (The "Toolbox")
    # Functions are reusable blocks of code, like a specific move in a combo.
    Print(message: string): void = 
        # This just prints a message to the debug console.
        # It's like checking your scoreboard during a game.
        debug_print(message)