# PulseTrap.verse
# A Verse script that creates a rhythmic damage trap.

# Import the basic Verse framework
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }

# This is our main script class. Think of it as the "Brain" of the trap.
class PulseTrapScript is active_world_script():

    # VARIABLES: These are like your loadout slots.
    # We define them here so we can change them easily later.
    # A "Variable" is a container for data that can change.
    
    # This variable holds the Pulse Trigger device.
    # We will assign it in the editor.
    PulseDevice: PulseTriggerDevice = PulseTriggerDevice()
    
    # This variable holds the damage amount.
    # A "Constant" is a variable that never changes once set.
    # Here, we use a variable so we can tweak it.
    DamageAmount: int = 25
    
    # This is a FUNCTION. A function is a block of code that does a specific job.
    # Think of it like a "Healing Item" - you use it, and it restores health.
    # Here, our function "ActivatesPulse" will send the signal.
    OnActivatePulse() -> void:
        # This line tells the Pulse Trigger to start sending pulses.
        # It's like pressing the "Fire" button on a weapon.
        PulseDevice.SetBPM(120) # Set to 120 BPM for fast pulses
        PulseDevice.SetDamage(DamageAmount)
        
        # This line actually triggers the first pulse immediately.
        PulseDevice.TriggerPulse()

    # This is an EVENT. Events are like "Eliminations" or "Win Conditions".
    # They happen automatically when something occurs in the game.
    # Here, we want to react when a player enters the trap's volume.
    OnBeginPlay() -> void:
        # This is a LOOP. A loop repeats code over and over.
        # Think of it like a "Storm Timer" that keeps checking the clock.
        # We use a loop to keep the pulse going.
        for (i : 10): # Repeat 10 times (or use a while loop for infinite)
            OnActivatePulse()
            # This pauses the script for 1 second (1000 milliseconds).
            # It's like the cooldown between shots.
            Wait(1000)