godot-version-migration

Godot バージョン移行

エンジンのバージョンアップグレードを、初期の Godot からライブラリの対象バージョンまでオーケストレーションします。ドメインスキルでは現在の API を説明し、このハブではアップグレードの手順を扱います。

**ライブラリの対象バージョン：**Godot 4.7 以降

コーパス：ドキュメントの変更履歴 · インタラクティブな変更履歴 · ダウンロードアーカイブ · GitHub リリース · 移行ガイドのインデックス

絶対にしてはいけないこと

• メジャーバージョンを絶対に飛ばさないでください — 1.x → 2.x → 最新の 3.x → 4.0 の順に進んでから、4.x のマイナーバージョンを順番にアップグレードしてください。
• 4.x のステップを絶対に飛ばさないでください — 4.0 → 4.1 → … → 4.7 と、一度に 1 つのマイナーバージョンだけアップグレードし、各ステップの後に安定化してください。
• 1.x から 4.x への自動変換や、ビット単位で完全に一致する自動処理を絶対に主張しないでください。
• ドメインスキルの本文を移行変更履歴として絶対に扱わないでください — references/<topic>.md（各スキルの references/migration-notes.md を反映したもの）を読み込んでください。
• すべてのモジュールノートを一度に絶対に読み込まないでください — プロジェクトに存在するサブシステムのものだけを読み込んでください。
• ハイレベルなマルチプレイヤー機能では、サーバーとクライアントで Godot のマイナーバージョンを絶対に混在させないでください（特に 4.2 から 4.3 への SceneMultiplayer プロトコル変更の前後）。
• VCS のバックアップなしで、Mesh の「Restart & Upgrade」を絶対に選択しないでください（4.1 から 4.2 へのメッシュ形式変更）。
• 完全なバックアップなしで 3 から 4 へのコンバーターを絶対に実行しないでください（ツールはバックアップを作成しません）。

バージョンの検出

1. project.godot（config_version、config/features）またはレガシーの engine.cfg を読み取ります。
2. ファイルから判別できない場合は、ユーザーに確認します。
3. references/era-index.md で該当する時代を特定します。

ワークフローのルーター（必須）

検出された時代	読み込むもの	してはいけないこと
1.x / 初期の 2	legacy/pre-2-context.md	1 から 4 へのコンバーターをでっち上げない
2.x	legacy/2-to-3.md、その後最新の 3.xで安定化	4.7 のノートに直行しない
3.x	bridges/3-to-4.md + 公式の 3 から 4 へのガイド	最新の 3.x で安定化する段階を飛ばさない
4.x < 4.7	公式のステップガイド + 変更対象のシステムに関する hop-index.md のモジュールノート	マイナーバージョンを飛ばさない
すでに 4.7 以降	godot-master / ドメインスキル	このハブをコーディングチュートリアルとして扱わない

手順（4.x のマイナーバージョン）

1. current < 4.7 の間、current + 0.1 へのステップを必ず 1 回だけ実行します。
2. 移行先バージョンの公式アップグレードページを開きます。
3. hop-index.md から、プロジェクトに存在するサブシステムのモジュールノートだけを開きます。
4. 修正を適用し、新しいエディターで開いてプレイテストし、繰り返します。

ステップ表

メジャーバージョン / ブリッジ

時代	リソース
1.x の調査	legacy/pre-2-context.md
2.x → 3.x	legacy/2-to-3.md
3.x → 4.0	bridges/3-to-4.md · 公式ガイド
段階的アップグレードの概要	era-index.md

4.x のマイナーバージョン

ホップ	公式ガイド
4.0 → 4.1	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.1.html
4.1 → 4.2	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.2.html
4.2 → 4.3	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.3.html
4.3 → 4.4	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.4.html
4.4 → 4.5	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.5.html
4.5 → 4.6	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.6.html
4.6 → 4.7	https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.7.html

スキル横断チェックリスト: references/hop-index.md

モジュールディレクトリ

ミラーリングされたドメインスキルの移行ノートは references/<topic>.md にあります (例: references/2d-physics.md)。ハブネイティブの legacy/、bridges/、era-index.md はドメインスキルのミラーではありません。

sync_godot_version_migration.py --all

リファレンス

公式ドキュメント

• 新しいバージョンへの移行
• Godot 3 から Godot 4 へのアップグレード
• ドキュメント変更履歴

関連スキル

マスター

• godot-master — 移行が完了した後の、現在のドメインスキルモジュール向けライブラリルーターです。

ダウンストリーム / コンシューマー

• godot-analyst — 各ホップの完了後、ターゲットの API 上でアーキテクチャを評価します。
• godot-auditor — アップグレード後の Never リスト / レガシー構文の検証を行います。
• godot-builder — 各ホップ後に、新しいエンジンターゲットに対して CI / ヘッドレスビルドを実行します。

補完

• godot-project-foundations — ターゲットバージョンに移行した後のプロジェクト設定 / 構造を扱います。
• godot-gdscript-mastery — 3→4 / 4.x の言語ホップ後の、型付き GDScript 2.0 のイディオムを扱います。
• godot-export-builds — プラットフォームに関わる各ホップ後に、エクスポートを再検証します。