godot-gdscript-patterns

Godot GDScript のパターン

アーキテクチャ、シグナル、シーン、最適化を扱う、Godot 4.x のゲーム開発向け本番環境用パターンです。

このスキルを使用する場面

• Godot 4 でゲームを開発する場合
• GDScript でゲームシステムを実装する場合
• シーンアーキテクチャを設計する場合
• ゲームの状態を管理する場合
• GDScript のパフォーマンスを最適化する場合
• Godot のベストプラクティスを学ぶ場合

このスキルを使用しない場面

• タスクが Godot の GDScript パターンと無関係な場合
• この範囲外の別の分野やツールが必要な場合

手順

• 目標、制約、必要な入力を明確にします。
• 関連するベストプラクティスを適用し、結果を検証します。
• 実行可能な手順と検証方法を提示します。
• 詳細な例が必要な場合は、resources/implementation-playbook.md を開きます。

リソース

• 詳細なパターンと例については、resources/implementation-playbook.md を参照してください。

制限事項

• タスクが上記の範囲に明確に合致する場合に限り、このスキルを使用してください。
• 環境固有の検証、テスト、専門家によるレビューの代わりとして、出力を扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。

プレイブックのサンプルは別ファイルの断片です。使用する前に、Input Map のアクション、シーンノード、Player／State のサブクラス、die() やその他のプロジェクト固有のヘルパーを用意してください。プールには CanvasItem と互換性のあるシーンルートと、明示的な物理／衝突状態のリセットが必要です。処理や可視性を無効にしても、すべてのシグナルコールバックが防がれるわけではないため、非アクティブなオブジェクトはヒットを拒否する必要があります。初期状態を検証し、非同期のシーン読み込み／遷移でリクエストが重複しないように保護してください。セーブファイルにはスキーマ／バージョン／範囲の検証とアトミックな置き換えが必要です。配布するゲームにハードコードされた暗号化キーを含めても抽出可能であり、秘密を保護したり、チート対策の信頼性を確立したりすることはできません。セーブ／オープン／削除の失敗を確認してください。Godot のバージョンを固定し、効果を主張する前にプロファイラーを使用してください。Godot の一時停止／処理モードを参照してください。