ゲームエンジンを新しい版に上げる前に|UnityとGodotの手順
Unity の上げる手順は、上げるかどうかの判断・プロジェクトのバックアップ・上げる準備・Hub で新しい版を入れる・新しい版で開く・互換の問題を直す・テストの順。Godot は、版ごとに『Upgrading from Godot 4.5 to Godot 4.6』のようなページがあり、壊れる変更・挙動の変更・既定値の変更が並ぶ。
Unity の上げる手順
表1 Unity の上げる手順
| 段階 | 内容 |
|---|---|
| 上げるかどうかの判断 | サードパーティのパッケージとアセットを使っている場合は、その説明書で、上げる先の版に対応しているかを確かめる。対応していない場合は、代わりの方法を探すか、アセットを自分で更新する必要がある場合がある。 |
| バックアップ | バックアップがあれば、上げる途中で問題が起きたときに前の版のプロジェクトに戻れる。バージョン管理を使っていない場合は、プロジェクトのフォルダをパソコンの別の場所か外付けのドライブにコピーして、手でバックアップすることもできる。手でコピーする場合は、Library フォルダのような自動で作られるフォルダを除いてよい。Library フォルダは、プロジェクトをエディターで開いたときに作り直される。 |
| 準備 | プロジェクトの中のパッケージとアセットを先に最新の版にする。上げる先の版で非推奨になった機能または API がプロジェクトに無いか見直し、更新するか置き換える計画を立てる。書き出し先のプラットフォームが、上げる先の版でも対応しているかを確かめる。 |
| 上げる | Hub で新しい版のエディターを入れ、プロジェクトを新しい版で開く。 |
| 直す | スクリプトのコンパイルが始まると、API アップデーターが自動で実行され、スクリプトやアセンブリ内の古いコードを特定し、更新する。コンソールのエラーと警告の見直しなど、ほかの作業もこの段にある。 |
| テスト | ゲームを動かして、すべての機能をテストするなど。 |
版ごとの変更の書き場所
表2の Unity の版の一覧は、Unity 6.0(6000.0.65f1・2025年12月15日のビルド)のマニュアルのものです。
表2 版ごとの変更の書き場所
| エンジン | 場所 | 内容 |
|---|---|---|
| Unity | 『Unity のアップグレード』のページ | Unity 6 へのアップグレード・Unity 2023.2 へのアップグレード・Unity 2023.1 へのアップグレード・Unity 2022 LTS へのアップグレード・Unity 2021 LTS へのアップグレードの版ごとのアップグレードガイドへの案内がある。特定のレンダーパイプラインの版のアップグレード情報は、URP アップグレードガイドまたは HDRP アップグレードガイドを参照する。版の順に読む。例えば、プロジェクトを 2020 から 2022 に上げる場合は、2022 のガイドに従う前に、2021 のガイドを読んで変更すべき点が無いか確かめる。 |
| Godot | 『Migrating to a new version』のページ | 3 から 4 へのページと、4.0 から 4.1、4.1 から 4.2、4.2 から 4.3、4.3 から 4.4、4.4 から 4.5、4.5 から 4.6、4.6 から 4.7 へのページへの案内がある。 |
| Unity | 『API アップデーター』のページ | 「破壊的変更の影響を最小限に抑えるため、スクリプトやアセンブリ内の古いコードを特定し、更新する」。スクリプトのコンパイルが始まると、API アップデーターは自動的に実行される。 |
Godot の 4.5 から 4.6 へのページの節
表3 Godot の 4.5 から 4.6 へのページの節
| 大きな節 | 下の節の名前 |
|---|---|
| Breaking changes | Core・Animation・3D・Rendering・GUI nodes・Networking・OpenXR・Editor |
| Behavior changes | Android・Core・Rendering・Navigation |
| Changed defaults | 3D・Rendering・GUI nodes |
上げる前の手順
上げる前の流れ
- 作っているプロジェクトのエンジンの版と、使っているパッケージ・アセットの対応版を書き出す(表1)
- バージョン管理でコミットするか、プロジェクトのフォルダをコピーする(表1。手でコピーする場合は Library フォルダを除いてよい)
- 上げる先の版のアップグレードガイド(Unity)か Migrating のページ(Godot)を開き、自分のゲームの機能に関わる変更が無いかを確かめる(表2)
- Unity はパッケージとアセットを先に最新にし、非推奨の API を見直す(表1)
- 新しい版で開き、API アップデーターや警告を確かめる(表1・表2)
- ゲームを最初から最後まで遊んで確かめる(表1)
- 上げる途中で問題が起きたときは、バックアップから前の版のプロジェクトに戻せる(表1)
失敗を避ける注意
- ずっと古い版から新しい版へ直接上げると、メジャーな版を1つずつ順に上げる場合より問題が多くなる場合がある。
- サードパーティのパッケージとアセットが上げる先の版に対応していない場合は、代わりの方法を探すか、アセットを自分で更新する必要がある場合がある。
- API アップデーターは、API の特定のエラーや警告のみを修正できます。コンソールメッセージに UnityUpgradable と表示されるものが対象で、「API アップデーターが処理できないその他のエラーや警告は、手動で解決する必要がある」。
関連のページ
次に読む
情報源
- Upgrade your Unity project(Unity マニュアル・本文は英語)https://docs.unity3d.com/ja/current/Manual/upgrade-project.html確認日 2026-11-06
- Unity のアップグレード(Unity マニュアル)https://docs.unity3d.com/ja/current/Manual/UpgradeGuides.html確認日 2026-11-06
- API アップデーター(Unity マニュアル)https://docs.unity3d.com/ja/current/Manual/APIUpdater.html確認日 2026-11-06
- Migrating to a new version(Godot ドキュメント・英語)https://docs.godotengine.org/en/stable/tutorials/migrating/index.html確認日 2026-11-06
- Upgrading from Godot 4.5 to Godot 4.6(Godot ドキュメント・英語)https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.6.html確認日 2026-11-06