データの命名規則・フォルダー管理の規則【Unreal Engine】

更新日：2025年1月12日

上記の記事が論理的かつ包括的に解説していて参考になる。

絶対に正しいフォルダー管理ルールはなく、かなり人やプロジェクトによって分かれるので、各自で自分が使いやすいように決める。

命名規則

あらゆるデータ名は「単語の最初1文字だけ大文字・スペースなし」として命名する。
英語のみを使用し、日本語や絵文字・特殊記号などは使わない。

ブループリント：BP_、マテリアル：M_、テクスチャ：T_など、ファイルタイプによって最初に特定の文字を付けておく。
こうすることで、名前だけでどのようなデータなのかがわかりやすい。

Bool値
- Bool値は形容詞を付ける。
- Bool値には、"b"を付ける。
  (Bool型であるとわかりやすくするため)
- Bool値には、"Is"は付けない。
  (Isは関数用としてすでに使われているので)
- 複雑な複数の状態を表したい場合はEnum(列挙型)にする。
  Enumなら武器の射撃中・リロード中・切り替え中など複数の状態を表現できる。
冗長な名前はつけない。
- 例として、プレイヤーの変数なら"PlayerScore"ではなく"Score"にする。
- AssetやDataのような名前はつけない。
  すべてのアセットはAssetである。
全ての関数は動詞にする。
- 関数は全て何かを実行する処理であるため。
Boolを返す関数にはIsを付ける。
- 例えば死んでいるかどうかを確認する関数なら、"IsDead"とする。
- 持っているなら"Has"
- 前の状態を確認するなら"Was"
- 可能かどうかなら"Can"

フォルダーは、背景・キャラ・武器・マップ・エフェクト・配置アイテム・ゲームのコアデータのように大分類する。

背景・キャラ・武器・マップ・エフェクト・配置アイテム
- Common
  その大分類内のどのデータでも共通のものは、そのフォルダ内の"Common"に入れる。
コア
- キャラ・武器・配置アイテム・エンジン・ゲームモードなどの、ゲームを動作させるコアデータ。
MaterialLibrary
- 共有マテリアルを置く。

メッシュ・テクスチャ・マテリアルなどでは分類しない。

データタイプごとはコンテンツブラウザーでフィルターできる。
該当の大分類フォルダ内で"M_"を検索するだけでも素早く検索できる。

背景モデル用のデータをキャラや武器で扱うことはない。

Content直下に、プロジェクト名などでまずフォルダ分けをする。
こうすることで他プロジェクトにデータを移行してもパス被りが置きないようにする。
Content直下にデータを置かない。

ストアからダウンロードしたアセットを、StoreAssetsとしてまとめる。
外部アセットが数個なら気にならないが、大量にあるならまとめた方がすっきりする。

ファイル操作はUnreal Engine内のコンテンツブラウザーで行う。
エクスプローラーなど外部でいじるとリンク切れを起こすので、絶対にやらない。

フォルダーカラーを設定する。
色で識別しやすくなる。
指定はないが、頻繁に使うフォルダーはわかりやすく赤や青に、外部アセットやメッシュ・アニメなど参照だけして直接使わないフォルダーは灰色にするとよい。