デバッグメニュー
作業中
このドキュメントはまだ拡張・修正中です。機能、スクリーンショット、説明はTalescapeの公開リリースまで変更される可能性があります。わかりにくい点や助けが必要な場合は、公式Talescape Discordで質問してください。必要に応じてページを明確化したり更新したりします。
デバッグメニューは、エディタでストーリーをプレビューしながら状態を検査・変更できるテストツールです。ログの確認、変数の編集、インベントリ変更のシミュレーションなどを行い、さまざまな条件下でストーリーがどのように反応するかを確認できます。
プレビュー中は、Story Preview でDebugアイコンを選択するとデバッグメニューを開けます。
1. 概要
デバッグメニューには、プレビューの主要なシステムごとに分かれた専用タブがあります:
- Logs: プレビュー中のストーリーのevent、アクション、システムメッセージを表示します。
- Inventory: ストーリーで使われるitemの所持数を表示・編集できます。
- Variables: 実行中のvariableの値をリアルタイムで確認・変更できます。
- Events: イベントの状態を表示し、プレビュー中にどのストーリーイベントがアクティブかを検証できます。
- Timers: 稼働中のカウントダウンや周期的なタイマー挙動を含むタイマー状態を表示します。
デバッグメニューから行った変更は現在のプレビューセッションにのみ影響します。ストーリーには保存されず、プレビューを再起動するとリセットされます。
2. ログ
Logsタブは、ストーリー実行時の裏側で何が起きているかを表示します。ストーリーの流れを追い、ロジックをテストし、特定のイベントがいつ発生するかを理解するのに役立ちます。
見られる内容:
- トリガーの起動やアクションの結果
- 会話の進行や条件チェック
- プレイヤーの選択による変数やアイテムの変更
Logsタブは主にストーリーテリング支援として、Bardsがストーリーロジックが期待通りの順序で動いていることを確認するためのものです。技術的・ランタイムエラーは表示されません。
3. インベントリ
Inventoryタブにはストーリー内で利用可能なすべてのアイテムが一覧表示されます。プレイヤーが現在所持しているものだけが表示されるわけではありません。クラフト、パズル、アイテム条件のテストのために、アイテム数を自由に調整できます。
できること:
-
- / − ボタンで任意のアイテムの数量を追加・削除できます。
- 名前でアイテムを検索できます。
これにより以下のようなシナリオをテストできます:
- レシピを使った新アイテムのクラフト。
- アイテムがあるときにイベントが発生するかの確認。
- 集めたオブジェクトに依存するストーリーパスの検証。
4. 変数
Variablesタブにはストーリーで定義されたすべての変数とその現在値が表示されます。プレイヤーの選択をシミュレートしたり、別の分岐をテストするために値を変更できます。
できること:
- フラグ（flags）をトグル（true/false）できます。
- 数値（numbers）を直接変更できます。
- テキスト（text）値を編集できます。
- 個別の変数をリセットできます。
新しい変数が作成されたり値が変更されると、変数リストは自動で更新されます。
5. テストワークフロー
デバッグメニューはクリエイティブなテスト向けに設計されており、技術的なデバッグ用ではありません。次の点を確認するのに役立ちます:
- 選択肢や変数が意図どおりに動作するか。
- アイテムやクラフトのロジックが正しく機能するか。
- 正しい条件でストーリーブランチが解放されるか。
- イベントやタイマーが期待したタイミングで発火するか。
- プレイヤーの状態遷移が一貫しているか。
リリース前の完全な検証ワークフローには、Editor Checks System とデバッグメニューを組み合わせて使うと良いでしょう。
6. ベストプラクティス
- Logs を使ってストーリーの流れをたどり、イベントの順序を確認しましょう。
- Variables を使って特定の分岐に直接ジャンプし、素早くテストしましょう。
- Inventory を使って、序盤をやり直さずにクラフトやアイテムゲーティングをテストしましょう。
- Events と Timers を使って、トリガーやカウントダウンの挙動を確認しましょう。
- 頻繁にリセットして、初期状態からストーリーが正しく動くか検証しましょう。
デバッグメニューはテストのための完全な制御を提供し、Dreamersに公開する前にすべての分岐、選択、結果を探索できるようにします。