INDIE INDEX

レベル:実践

ゲームエンジンを新しい版に上げる前に|UnityとGodotの手順

公開 2026-11-06更新 2026-11-06

Unity の上げる手順は、上げるかどうかの判断・プロジェクトのバックアップ・上げる準備・Hub で新しい版を入れる・新しい版で開く・互換の問題を直す・テストの順。Godot は、版ごとに『Upgrading from Godot 4.5 to Godot 4.6』のようなページがあり、壊れる変更・挙動の変更・既定値の変更が並ぶ。

このページの目次
  1. Unity の上げる手順
  2. 版ごとの変更の書き場所
  3. Godot の 4.5 から 4.6 へのページの節
  4. 上げる前の手順
  5. 失敗を避ける注意
  6. 関連のページ
  7. 次に読む
  8. 情報源

Unity の上げる手順

表1 Unity の上げる手順

段階内容
上げるかどうかの判断サードパーティのパッケージとアセットを使っている場合は、その説明書で、上げる先の版に対応しているかを確かめる。対応していない場合は、代わりの方法を探すか、アセットを自分で更新する必要がある場合がある。
バックアップバックアップがあれば、上げる途中で問題が起きたときに前の版のプロジェクトに戻れる。バージョン管理を使っていない場合は、プロジェクトのフォルダをパソコンの別の場所か外付けのドライブにコピーして、手でバックアップすることもできる。手でコピーする場合は、Library フォルダのような自動で作られるフォルダを除いてよい。Library フォルダは、プロジェクトをエディターで開いたときに作り直される。
準備プロジェクトの中のパッケージとアセットを先に最新の版にする。上げる先の版で非推奨になった機能または API がプロジェクトに無いか見直し、更新するか置き換える計画を立てる。書き出し先のプラットフォームが、上げる先の版でも対応しているかを確かめる。
上げるHub で新しい版のエディターを入れ、プロジェクトを新しい版で開く。
直すスクリプトのコンパイルが始まると、API アップデーターが自動で実行され、スクリプトやアセンブリ内の古いコードを特定し、更新する。コンソールのエラーと警告の見直しなど、ほかの作業もこの段にある。
テストゲームを動かして、すべての機能をテストするなど。
表1

版ごとの変更の書き場所

表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 アップデーターは自動的に実行される。
表2

Godot の 4.5 から 4.6 へのページの節

表3 Godot の 4.5 から 4.6 へのページの節

大きな節下の節の名前
Breaking changesCore・Animation・3D・Rendering・GUI nodes・Networking・OpenXR・Editor
Behavior changesAndroid・Core・Rendering・Navigation
Changed defaults3D・Rendering・GUI nodes
表3

上げる前の手順

上げる前の流れ

上げる前の流れ1バックアップ2パッケージ・アセットを更新3新しい版で開く4アップグレードガイドと照らす5遊んで確かめる
図1
  1. 作っているプロジェクトのエンジンの版と、使っているパッケージ・アセットの対応版を書き出す(表1)
  2. バージョン管理でコミットするか、プロジェクトのフォルダをコピーする(表1。手でコピーする場合は Library フォルダを除いてよい)
  3. 上げる先の版のアップグレードガイド(Unity)か Migrating のページ(Godot)を開き、自分のゲームの機能に関わる変更が無いかを確かめる(表2)
  4. Unity はパッケージとアセットを先に最新にし、非推奨の API を見直す(表1)
  5. 新しい版で開き、API アップデーターや警告を確かめる(表1・表2)
  6. ゲームを最初から最後まで遊んで確かめる(表1)
  7. 上げる途中で問題が起きたときは、バックアップから前の版のプロジェクトに戻せる(表1)

失敗を避ける注意

  • ずっと古い版から新しい版へ直接上げると、メジャーな版を1つずつ順に上げる場合より問題が多くなる場合がある。
  • サードパーティのパッケージとアセットが上げる先の版に対応していない場合は、代わりの方法を探すか、アセットを自分で更新する必要がある場合がある。
  • API アップデーターは、API の特定のエラーや警告のみを修正できます。コンソールメッセージに UnityUpgradable と表示されるものが対象で、「API アップデーターが処理できないその他のエラーや警告は、手動で解決する必要がある」。

関連のページ

次に読む

情報源

このページに出た言葉

このページの内容の誤りは、問い合わせの窓口で受け付けています。