タイマーデバイス

⏱️ timer_device とは？

イベントのカウントダウンや時間調整に使用するタイマーデバイスです。
成功、失敗、急性モードなどのイベントに動的に反応することができます。ストップウォッチやカウントアップに対応。

🧠 主なイベント

• SuccessEvent：時間が成功で終了
• FailureEvent：時間が失敗で終了
• StartUrgencyModeEvent：急性モードへ移行

⚖️ 主な操作

• Start(), Pause(), Resume(), Complete() で正規操作
• StartForAll(), ResetForAll(), CompleteForAll() は全プレイヤー一括
• SetActiveDuration(Time)：残り時間を設定
• GetActiveDuration()：残り時間を取得
• SetMaxDuration(Time), GetMaxDuration()：最大時間を設定/取得
• IsStatePerAgent()：個別管理か全体管理かを確認

📃 サンプルコード

ゲーム開始時にタイマーを開始し、成功時にログを出力する基本例:

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

timer_example := class(creative_device):

    @editable
    var Timer: timer_device = timer_device{}

    OnBegin<override>()<suspends>: void =
        Timer.SuccessEvent.Subscribe(OnTimerSuccess)
        Timer.Start()

    OnTimerSuccess(Agent: ?agent): void =
        if (TimerAgent := Agent?):
            Print("タイマー成功: TimerAgent")

🔹 活用アイデア

• FailureEvent を使って失敗時のやり直しログ
• StartUrgencyModeEvent でサウンドやビジュアル効果を付与
• Pause() / Resume() を使ってもらすも可能
• Save() / Load() でプレイヤーの進行を保存復元

🔝 まとめ

timer_device は時間管理、ミニゲームのカウントダウン、成功/失敗分定などに対応する、強力なデバイスです。
Start(), Pause(), Complete() の上手な組み合わせで、ゲーム内に経過を付けることができます。