using { /Fortnite.com/Devices }
using { /Verse.org/Sim }

# This is our main script entity.
# Think of it as the "Brain" of our island.
class RevealBrain extends GameScript():
    
    # We need a reference to the Prop-O-Matic device.
    # In your actual editor, you'd drag the device into this slot.
    PropOMatic: PropOMaticDevice = PropOMaticDevice
    
    # This is the main entry point. It runs when the game starts.
    Run(): void =
        # For this demo, let's say a button press triggers this.
        # In a real build, you'd bind this to a UI button or trigger.
        # Here, we'll just call our reveal function directly.
        RevealAllHidingProps()
    
    # FUNCTION: RevealAllHidingProps
    # This function checks EVERY player on the island.
    # It's like a security camera scanning the room.
    RevealAllHidingProps(): void =
        # Get all agents (players) currently in the game.
        # This is the list of everyone alive and in the match.
        all_agents := GetAgents()
        
        # LOOP: Go through each player in the list.
        # Think of this like checking every locker in the school.
        for agent : all_agents do:
            # CHECK: Is this player currently a prop?
            # IsPlayerProp is a "predicate" - it asks a Yes/No question.
            if PropOMatic.IsPlayerProp(agent) == true:
                # ACTION: If yes, ping them!
                # This highlights them on the map and maybe plays a sound.
                PropOMatic.PingPlayerProp(agent)
                
    # OPTIONAL: A specific ping for one person (Revenge Mode!)
    # Use this if you want to target a specific cheater.
    TargetedReveal(target_player: Agent): void =
        # Check if the target is actually a prop.
        if PropOMatic.IsPlayerProp(target_player) == true:
            # Ping only that specific person.
            PropOMatic.PingPlayerProp(target_player)
        else:
            # If they aren't a prop, tell the user.
            # (You could play a "Not Found" sound here)
            print("Target is not hiding as a prop.")