10
6

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

Unreal Engine4でプロジェクト名を変更する方法(C++化してしまった場合)

Last updated at Posted at 2022-01-17

#前置き
UE4でゲームを作り出す時点で適当な名前を付けてしまって後から変えたくなった、更にプラグイン等の導入でC++化してしまった私の備忘録です。
Twitterでは文字数全然足りなかったので…。
C++コード打つ方はこんなことで困らないと思うので、需要は無いかもしれませんが、私のような人もいるかもしれませんので参考に残しておこうと思います。

BPのみのプロジェクトであれば、おかずさんの記事に解決方法がありますのでそちらを参照してください。
ご説明頂いている通りにクローン化をするとC++化したプロジェクジェクトの場合、slnファイルやその他の名前が元のままになります。
でも、動いてUEのプロジェクト名が変わればそれでいいんだよ、という方には以下の記事は参考になりません。

今回は、そういうところもなんか気持ち悪い!!!という稀な方向けです。

また、今回の記事はあくまでも私の環境ではこれで問題なかった、という内容ですので全ての環境で同じ手順かどうかはわかりませんことと、類似部分はある程度省きますのでこの点をご留意ください。
※ソースファイルを直接書き換えますので不安な方はやめておきましょう。
最悪直せなくなってプロジェクトが開けなくなる恐れがありますので自己責任でお願いします。

#手順
※Unreal Engine4.27.2での記事です。
 1.変更したい元のプロジェクトのクローンを作成
 2.一部ファイルを直接書き換え

##1.変更したい元プロジェクトのクローンを作成

image.png

色々触って動かなくなってしまうなどのトラブルが発生する可能性がありますので必ずクローンしてバックアップをしておきましょう。

クローンボタンを押して新しいプロジェクト名を入力することになりますが、警告が出ます。
ここではTESTProjectからHogeに変更するとします。

image.png

構わず続けるを押しましょう。

image.png

クローンが出来ました。
が、しかしslnファイルの名前がそのまま、Sourceフォルダ内もいくつかそのままの名前のものがあります。
image.png
更にC++クラスを追加しようとすると警告が発生します。
複数ファイルのリネームと、中身を直接書き換えを行って解決したいと思います。

##2.一部ファイルを直接書き換え
注意)この作業を始めると問題なく書き換えが全て終わるまで.uprojectがエラーで開けなくなります。

書き換えが必要なファイル/フォルダ
・/TESTProject.sln
・/Source/TESTproject.Target.cs
・/Source/TESTprojectEditor.Target.cs
・/Source/TESTProject/TESTProject.Build.cs
・/Source/TESTProject/TESTProject.cpp
・/Source/TESTProject/Hoge.h
・Pluginによって追加された.hファイル
・自身で追加した.hファイル
・/Config/DefaultEngine.ini
・Hoge.uproject
・その他、旧プロジェクト名が存在するファイル

このファイル達の中に、以前のプロジェクト名である、"TESTProject"という文字列が残っています。
これを全て"Hoge"置換えていきます。
合わせて、このファイル達のファイル名もHoge.Target.csなどのように全てリネームします。
TESTProject.slnを開いてファイル名も書き換えもVisualStudio上で行うのをオススメします。

例)
image.png
TESTProject.cpp(3箇所ありますが全て置換え)
image.png
MyCharacter.h(自分で追加したC++クラス。ここは全て大文字)
image.png
Hoge.uproject(ここにもあります)

書き換えが終わったらVisualStudioを閉じてHoge.uprojectを起動してみます。

image.png
上のように出るのでリビルトということではいを選択。

image.png

あら、どこかおかしいようです。
この時点で絶望を感じますが、Logを確認してみましょう。
/Saved/Logsフォルダ内の更新日時が一番新しい.logファイルを確認。

image.png

どうやらHoge.Target.csがおかしいらしい。

image.png
ということで元ファイルの同じ.csファイルと比べて確認してみたら書き換えた部分からTargetが抜けてしまっていたようです。
HogeTargetに修正。
それでは気を取り直して再度Hoge.uprojectを開きます。
正しく書き換えが完了していれば以下のようにビルドが走るはずです。

image.png

無事にプロジェクトを開くことができました。
右上のプロジェクト名もHogeになっていますね。
では、警告が出ていた新規C++クラスの追加を確認してみましょう。

image.png

とりあえず適当にActorクラスを追加してみます。
image.png

無事に警告なしで追加することができました!!

image.png

#まとめ
あらゆる箇所を元プロジェクト名から新プロジェクト名にひたすら書き換える、というだけでした。
書き換え漏れやミスも、Logファイルをたどってどこでエラーが出てるかを確認して修正すれば大丈夫です。
ヘッダーとかよくわかってませんがとりあえずこれで問題なく動いておりますし、Windowsパッケージ化、Androidパッケージ化も試しましたがエラーは出ませんでした。

ニッチな需要かとは思いますが参考になれば幸いです。

10
6
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
10
6

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?