既存の管理システムを再利用して、連携する物件を追加する方法

AIを使って不動産管理ゲームに連携する物件を追加する方法を解説します。入居者、メンテナンス、キャッシュフローの既存の仕組みを維持しながら、変更内容を確認します。

Seele Editorial Team更新日 2026年11月16日

2件目の物件を追加する目的は、管理ゲームの幅を広げることです。最初の物件を動かす仕組みをすべて複製する必要はありません。入居者、メンテナンス、稼働率、賃料、カレンダーの処理では、対象物件を明確にします。ポートフォリオ全体で使うサービスとキャッシュフローは、共通の管理主体にまとめます。

架空の不動産管理者が、地区内の道路と共通サービスでつながるHarbor Rowの3棟を管理している。
Harbor Rowは説明用の架空の地区です。物件シミュレーションの検証は行っていません。

この記事では、架空のポートフォリオを使って、どのデータをどこで管理するかを説明します。ゲーム、物件、キャッシュフローのシミュレーションは、いずれも検証していません。AIに連携する物件の追加を依頼する前に、既存のプロジェクトがどのように物件を作成し、入居者を割り当て、修繕を予定に入れ、賃料を計算しているかを確認しましょう。

各物件に変わらないIDを割り当てる

まず、表示名を変更しても変わらない物件IDを用意します。物件データには、収容可能な区画数や利用できるサービスなど、制作時に設定する情報と、現在の入居者、未完了の修繕作業、アップグレードなど、ゲームの進行に伴って変わる状態があります。これらを別々のレコードで管理すれば、建物のイラストを差し替えても、割り当て済みの入居者データは消えません。

架空のHarbor Rowの例では、小規模な集合住宅と店舗区画を別々のレコードで管理します。どちらも既存の入居者管理とメンテナンスの仕組みを利用できますが、収容上限、賃料ルール、修繕キューは物件ごとに持ちます。作業用のバンや予備資金は、ポートフォリオ全体で共有してもよいでしょう。これはデータモデルの一案であり、実際のゲーム内経済について述べたものではありません。

管理単位データの例管理主体の例
物件定義物件ID、区画数、物件の種類制作時に定義するコンテンツ
物件の状態入居者の割り当て、修繕、物件固有のアップグレード物件の実行時レコード
ポートフォリオ共通サービス、現金残高、運用方針ポートフォリオ管理機能
カレンダー賃料の対象期間、メンテナンスの期限既存の時間管理システム

入居者管理とメンテナンスの仕組みを再利用する

入居者の割り当てや修繕をすでに処理しているシステムに、物件IDを渡します。賃貸契約は1件の物件にひも付け、修繕は対象の区画または建物を参照します。稼働率は有効な入居者レコードから計算します。所在地が増えただけで、賃料の計算式や修繕キューを別に作る必要はありません。

入居者の移転は、明示的なイベントとして定義します。ゲームで移転が可能なら、移転元の割り当てを解除し、移転先に空きがあることを確認して、入居者レコードを一度だけ更新し、両方の物件を再計算します。移転処理中に入居者が両方の物件に割り当てられたままだと、稼働率の計算や賃料の集計で二重計上が起こり得ます。

架空の3棟がそれぞれの入居者・修繕記録を保持しながら、ポートフォリオ共通の台帳にデータを集約している。
中核システムを複製せずに、物件ごとのレコードを共通のポートフォリオに集約できます。

建物固有のアップグレードは物件レコードに、共通の運用方針はポートフォリオのレコードに保持します。全物件に効くアップグレードはポートフォリオの管理機能を通じて適用し、新しい物件を追加した際に適用漏れが起きないようにします。セーブデータの移行やローカライズに対応できるよう、各アップグレードには変わらないIDを付けます。

全物件を同じタイミングで次の期間に進める

キャッシュフローは、多くの場合、時間の経過に左右されます。賃料を請求する時点、修繕費を計上する時点、空室扱いが始まる時点、共通サービスを割り当てる時点を決めます。ゲームに既存の期間切り替え処理を使い、すべての物件を同じ対象期間で更新します。物件ごとに別の時計を持たせると、ある物件で賃料を二重に請求したり、新しく追加した建物だけが1か月遅れたりする可能性があります。

ポートフォリオを更新する場合は、まず当期の入居者の変更を締め切り、各物件の収入と支出を計算します。次に共通サービス費を反映し、ポートフォリオの残高を確定してから、UIを更新して保存します。正しい順序は既存のゲームルールによって異なります。新しい賃貸契約が賃料の請求前と請求後のどちらで始まるかを明記しておきましょう。

財務データの集計は、1つの管理機能に任せます。建物のパネルにはその建物の収入と修繕費を、ポートフォリオの概要には全体の残高を表示できます。同じ費用が両方の画面に出る場合、概要の値は元のレコードから算出し、別の値として個別に書き込まないようにします。

物件を制作時に定義するデータとして扱う

物件の定義には、現行プロジェクトの制作手順に従います。Godotの安定版ドキュメントでは、シリアライズでき、インスペクターで編集できるカスタムResourceが説明されています。セーブのチュートリアルでは、状態をファイルに保存する方法や、JSONを使う場合の利点と制約を扱っています。これらの資料は、制作時に定義するデータや永続化の方法を選ぶ際に役立ちます。不動産のデータモデルや、入居者に関わるゲーム内経済の設計を定めるものではありません。

物件を1件しか持たない旧セーブデータについては、移行方法をAIに提案してもらいます。既存の住宅に変わらない物件IDを割り当て、入居者、賃料設定、修繕、アップグレードを引き継ぎます。安全な初期値でポートフォリオのデータを追加し、唯一のセーブデータに手を加える前に、複製したプロフィールで移行を試します。

変更範囲を絞り、元に戻せる形でAIに依頼する

たとえば、依頼の範囲は次のように絞れます。「既存の入居者管理、メンテナンス、財務、カレンダーの各システムを使って、複数の物件IDに対応してください。現在の賃料と修繕のルールは維持し、共通サービスはポートフォリオ単位で管理してください。新しい物件を1件追加し、変更したファイル、セーブデータの項目、移行手順、元に戻す手順を列挙してください。」

差分を確認し、財務ロジックが気づかないうちに複製されていないか、入居者レコードのキーが表示名だけになっていないか、UIのクエリが物件1件を前提としていないか、カレンダーの更新ループが最初の物件しか更新していない箇所がないかを調べます。物件一覧、入居者の割り当て、修繕キュー、ポートフォリオの概要をそれぞれどのファイルが管理しているかも、AIに確認します。

期間更新後の同じ架空の地区で、建物ごとの修繕、稼働率、共通サービスを確認できる。
ポートフォリオ画面のイメージです。検証済みの会計結果を示すものではありません。

複数の物件と集計値を検証する

以下はテスト計画の案です。架空の地区で得られたテスト結果ではありません。

テストケース操作確認すること
既存の物件物件が1件の既存セーブデータを読み込む入居者、修繕、アップグレード、残高が保持される
2件目の物件新しい物件レコードを追加する最初の物件が重複せず、2件目の固定IDと収容上限が読み込まれる
入居者の移転移転に対応していれば、入居者を移す移転元と移転先の稼働率がそれぞれ一度だけ更新される
メンテナンス修繕を1件予定に入れ、完了させる正しい物件と費用が記録される
期間の切り替えカレンダーを1期間進める収入と共通費用が一貫したルールで反映される
保存と再読み込みポートフォリオを保存し、開き直す物件ごとの数値と全体の集計値が整合する

プロジェクトのバージョン、物件ID、入居者レコード、対象期間、操作手順、想定した集計値と実測値を記録します。対象ビルドと、移行済みのプロフィールをテストします。生成した地区の図は物件同士の関係を説明するのに使えますが、賃料の計算や入居者の移転が正しいことまでは確認できません。

よくある質問

物件ごとにどのデータを保持すべきですか?

各物件に変わらないIDを付け、入居者の割り当て、メンテナンスの状態、収容上限、物件固有のアップグレードを物件ごとに管理します。現在のゲームがそのデータモデルに対応していれば、共通のキャッシュフローやサービスはポートフォリオ単位で管理できます。物件レコードごとに、固有で変わらない物件キーを持たせてください。

コードを複製せずに複数の物件を連携させるには?

既存の入居者管理とメンテナンスのシステムが、処理対象を特定するために物件IDを読み取るようにします。物件ごとに独立した管理機能へルールをコピーするのではなく、既存の賃料、修繕、カレンダーのルールを再利用します。これで、現在の運用ルールも1か所で管理できます。

連携する物件間で入居者を自動的に移転させるべきですか?

ゲームのルールで移転が定義されている場合に限ります。入居者は常に1件の有効な物件に割り当て、移転は既存の入居者管理システムで記録します。移転処理中に賃料や稼働率が二重計上されないようにしてください。処理では1件の入居者レコードを移し、複製はしません。

ポートフォリオのキャッシュフローの整合性を保つには?

確定した対象期間の物件別収入と支出を、1つの財務管理機能で集計します。ポートフォリオを次の期間に進めるとき、メンテナンス費用、空室、入居者の変更がそれぞれ一度だけ反映されることを確認します。同じ期間の確定時点のスナップショットを使って、合計額を照合します。期間の区切りは全物件で統一してください。

連携する物件を追加した後は、何をテストすべきですか?

まず物件1件でテストし、次に2件目を追加します。移転に対応していれば入居者を移し、メンテナンスを実施し、カレンダーを進め、保存と再読み込みを行って、ポートフォリオの集計値を比較します。実際の結果を記録してください。地図のモックアップは経済シミュレーションではありません。レビュー記録には物件IDと対象期間も残します。

動作を確認した1件の物件レコードから拡張する

まず既存の物件を1件選び、動作を変えずに、変わらないIDを持つ物件レコードを使うようにします。次に、同じ入居者管理、メンテナンス、財務、カレンダーのシステムを利用する2件目の物件を追加します。この順序なら、レビュー担当者が変更前後を比較しやすくなり、ポートフォリオの集計値も元のデータまでたどれます。

ブラウザで遊べる別のプロトタイプを試作するなら、SEELE AI Game Makerを試せます。これは別のプロトタイプを作るための手段で、既存の不動産管理ゲームを編集するツールではありません。

参考資料

SEELE AI

このガイドをプレイできる作品に。

作りたいものを明確にし、Seele AI ワークスペースで改善を重ねましょう。

制作を始める