よくある問題
作業中
このドキュメントはまだ拡張・修正中です。機能、スクリーンショット、説明はTalescapeの公開リリースまで変更される可能性があります。わかりにくい点や助けが必要な場合は、公式Talescape Discordで質問してください。必要に応じてページを明確化したり更新したりします。
構成の整ったストーリーでも、チェックに引っかかったり予期しない挙動をすることがあります。この記事では、テストや公開時によくある問題とその原因、対処法をまとめています。
1. 背景やメディアが表示されない
症状: シーンが白紙または黒背景で読み込まれる。
原因: 背景画像が削除されたか、割り当てられていない。
対処:
2. 孤立したシーン（到達されないシーン）
症状: プレイ中にそのシーンに到達しない。
原因: トリガーや遷移がそのシーンに繋がっていない。
対処:
- シーンチェックを使って未使用のシーンを特定する。
- そこへ繋がる遷移や会話アクションを作成するか、不要なら削除する。
3. 到達不能な会話選択肢
症状: 一部の会話オプションが表示されない。
原因: 条件の裏に隠れており、その条件が満たされない。
対処:
- 関連する変数やフラグを再確認する。
- デバッグメニューで変数の値を切り替え、可視性を確認する。
4. 説明文やスクリーンショットの不足
症状: リリースがマーケットプレイスのチェックに落ちる。
原因: 必須のメタデータ（説明文の長さ、タグ、スクリーンショットなど）が不足している。
対処:
- ストーリー設定 → Marketplace を開く。
- 説明文（最低300文字）、スクリーンショット3枚、タグ3つを追加する。
5. 年齢レーティングやコンテンツ警告の誤り
症状: レビュー中にフラグが立つ、またはリジェクトされる。
原因: 選択した年齢層がストーリーの内容と一致していない。
対処:
- コンテンツガイドラインを確認する。
- 年齢層を調整し、該当するコンテンツ警告にチェックを入れる。
6. ストーリーが適切に終了しない
症状: ストーリーが無限に続く、または予期せずループする。
原因: 最終チャプターに完了トリガーがない。
対処:
- 最後のチャプターの終わりにチャプター成功アクションを追加する。
- ストーリープレビューでクレジットが正しく表示されるか確認する。
7. 未使用または壊れたアイテム
症状: アイテムが存在するが、可視の用途や効果がない。
原因: クラフトレシピ、アイテムトリガー、インベントリチェックが不足している。
対処:
- 各itemがイベント、クラフトレシピ、条件のいずれかで参照されているか確認する。
- 未使用のアイテムはプロジェクトを整理するために削除する。
8. 変数の不一致
症状: ロジックが期待通りに動かない（誤った分岐が発動する）。
原因: 変数の型が間違っているか、誤った値が設定されている。
対処:
- 変数を変更するactionを再確認する。
- デバッグメニュー → 変数で実際の値を確認する。
9. シーン遷移が機能しない
症状: 選択やクリック後にプレイヤーが詰まる。
原因: シーン遷移に紐づくトリガーや条件が無効である。
対処:
- アクションに有効な「シーンへ移動」ステップが含まれているか確認する。
- デバッグメニューのログタブでトリガーの発動を確認する。
10. 修正後もチェックが通らない
症状: 修正したのに問題が「失敗」のまま表示される。
原因: チェック結果がキャッシュされている。
対処:
- チェックを実行を再度クリックして検証結果を更新する。
- 再実行の前に関連する全てのコンテンツが保存されていることを確認する。
11. リリースが手動レビューに進まない
症状: リリースが「自動レビュー」のまま進まない。
原因: Checks に未解決の失敗レベルの問題がある。
対処:
- Checksを開き、一覧の失敗を全て解決する。
- ストーリーが検証を通過したらリリースを再提出する。
12. コンテンツフラグ（AI）の不足や誤り
症状: チェックは通るがモデレーションで落ちる。
原因: AI生成のアセットが開示されていない。
対処:
- ストーリー設定 → コンテンツを開き、該当するAIフラグ（例：「AI画像」や「AI音声」）を有効にする。
- リリースを再提出する。
13. 協力者の変更が反映されない
症状: 協力者が特定の部分を編集またはアクセスできない。
原因: 協力者追加後に権限が更新されていない。
対処:
- ストーリー設定 → 協力者を開く。
- 関連する権限が全て有効になっているか確認し、変更を保存をクリックする。
14. 一般的なベストプラクティス
- リリースを作成する前に必ずエディタチェックを実行する。
- デバッグメニューを使ってロジックやインベントリの挙動を確認する。
- メタデータ（説明、年齢レーティング、タグ）は常に最新かつ完全にしておく。
- 大きな編集を行ったらチェックを再実行して準拠性を確保する。
これらはBardsやレビュアーから報告される最も頻繁な問題です。早めに修正することで、ストーリーが検証をスムーズに通過し、遅延なくDreamersに届きます。