build-game-inventory

ゲームインベントリを構築する

型付けされ、シリアライズ可能な単一のアイテム情報源を使用し、すべての移動をアトミックに行います。

アイテムの仕様を定義する

安定したID、アイテム定義、所有権、スタック上限、装備の互換性、効果、レア度、表示データ、移行バージョンをそれぞれ分けてモデル化します。実行時のUIでは、ステータスや説明を重複させず、IDで定義を参照します。

移動をトランザクションとして実装する

拾う、装備する、装備を外す、交換する、ドラッグ＆ドロップする、消費する、売却する場合は、次の手順に従います。

1. 移動元の所有権と移動先の適法性を検証します。
2. インベントリと装備の次の状態全体を計算します。
3. まとめて一度に確定するか、どちらの状態も変更せずに拒否します。
4. 確定後の状態が有効な場合にのみ永続化します。

適法な移動先を確認する前にアイテムを削除してはいけません。交換時はアイテムの同一性を維持し、効果の重複登録を防ぎます。

使いやすいUIを構築する

スロットとの互換性、装備状態、数量、ツールチップの情報、失敗時のフィードバックを表示します。ドラッグ操作だけでなく、キーボードやタッチ操作にも対応します。フォーカスの動作、ダイアログ、ツールチップはアクセシブルに保ちます。

アイテム喪失の境界条件をテストする

無効な移動先、インベントリの満杯、重複したアイテムの取得、装備の交換、アクション中の交換、セーブ／ロード、スキーマ移行、リセット／ニューゲーム、ツールチップの更新、ディスパッチの繰り返しを網羅します。明示的な消費ルールまたは報酬ルールがある場合を除き、所有するアイテムの同一性がすべて保たれていることを検証します。