この内容は古いバージョンです。最新バージョンを表示するには、戻るボタンを押してください。
バージョン:5
ページ更新者:guest
更新日時:2026-06-11 07:12:00

タイトル: プロジェクト(Project)
SEOタイトル: Unity Project (プロジェクト) 用語集完全ガイド

この記事の要点
  • Unity Project = 1 つのゲームアプリを構成するファイル群のルートディレクトリ
  • Assets/: 自作リソース、ProjectSettings/: 設定、Packages/: パッケージ、Library/: 自動生成キャッシュ
  • .unity = Scene、.prefab = Prefab、.cs = スクリプト、.meta = アセット ID 紐付け
  • Git 管理: Assets / ProjectSettings / Packages は push、Library / Temp / Logs は ignore
  • 複数 Unity バージョン管理は Unity Hub で（同一バージョンでプロジェクト共有）

Unity Project とは

Unity Project（プロジェクト）とは、1 つのゲームアプリ・コンテンツを開発するために必要なすべてのファイルを含むルートディレクトリです。Visual Studio の Solution、Xcode の .xcodeproj に相当します。

Unity Hub から「新規プロジェクト作成」を行うと、指定パスに以下のような構造のディレクトリが作成されます。

標準ディレクトリ構成

MyGame/                          ← プロジェクトルート
├── Assets/                      ★ 自作リソース（Git 必須）
│   ├── Scenes/
│   │   ├── Main.unity           ← シーン
│   │   └── Main.unity.meta
│   ├── Scripts/
│   │   ├── PlayerController.cs
│   │   └── PlayerController.cs.meta
│   ├── Prefabs/
│   ├── Materials/
│   ├── Textures/
│   ├── Audio/
│   └── Animations/
├── Packages/                    ★ パッケージ宣言（Git 必須）
│   ├── manifest.json            ← 依存パッケージ
│   └── packages-lock.json
├── ProjectSettings/             ★ プロジェクト設定（Git 必須）
│   ├── InputManager.asset
│   ├── ProjectSettings.asset
│   ├── QualitySettings.asset
│   └── TagManager.asset
├── Library/                     ✗ 自動生成キャッシュ（Git 不要）
│   ├── ShaderCache/
│   ├── ArtifactDB/
│   └── PackageCache/
├── Temp/                        ✗ 一時ファイル（Git 不要）
├── Logs/                        ✗ ログ（Git 不要）
├── UserSettings/                △ ユーザー固有（任意）
└── MyGame.sln                   △ Rider/VS用（自動生成）

各フォルダの役割

フォルダ内容Git 管理
Assets/シーン / スクリプト / 画像 / 音声 / Prefab / マテリアル等の自作リソース必須
ProjectSettings/レイヤー / タグ / 物理 / グラフィック等の全体設定必須
Packages/Package Manager の依存定義（manifest.json）必須
Library/インポート結果・シェーダー・パッケージ実体のキャッシュ不要（環境ごと再生成）
Temp/セッション一時ファイル不要
Logs/エディタログ不要
UserSettings/個人のレイアウト等原則ignore（チーム方針次第）
obj/ / Build/C# ビルド成果物 / ゲームビルド出力不要

主要なファイル拡張子

拡張子意味備考
.unityScene ファイル1 ゲームに複数。YAML 形式
.prefabPrefab（再利用可能 GameObject）YAML 形式
.csC# スクリプトMonoBehaviour / 通常クラス
.assetScriptableObject / 設定アセットYAML 形式
.matMaterial（マテリアル）シェーダー + パラメータ
.animAnimation Clip
.controllerAnimator Controllerステートマシン
.fbx / .obj / .png / .wav3D / 画像 / 音声素材外部ツールで作成
.metaアセット ID（GUID）と import 設定★ Git で必ず追跡
.unitypackageアセット配布パッケージAsset Store の形式

.meta ファイルの重要性

Unity は各アセットに対し同名の .meta ファイルを自動生成し、GUID（一意の ID）を保存します。プレハブやスクリプトの参照関係はパスではなくこの GUID で管理されているため、.meta を Git に含めないと参照が壊れます。

# Player.cs.meta の例
fileFormatVersion: 2
guid: 7a3b5d2f8c1e4a4b9e6c2d1f3a8b5c0e   ← 一意の ID
MonoImporter:
  externalObjects: {}
  serializedVersion: 2
  defaultReferences: []
  executionOrder: 0
  icon: {instanceID: 0}
  userData:
  assetBundleName:
  assetBundleVariant:

Git での標準 .gitignore

# .gitignore (Unity 公式テンプレートベース)

[Ll]ibrary/
[Tt]emp/
[Oo]bj/
[Bb]uild/
[Bb]uilds/
[Ll]ogs/
[Uu]ser[Ss]ettings/

# Visual Studio
.vs/
*.csproj
*.sln
*.suo
*.user

# OS / IDE
.DS_Store
Thumbs.db
.idea/

# Unity 自動生成
sysinfo.txt
*.pidb.meta
*.pdb.meta
*.mdb.meta

# Asset Store / 巨大バイナリは Git LFS 推奨
*.psd filter=lfs diff=lfs merge=lfs -text
*.fbx filter=lfs diff=lfs merge=lfs -text

Packages/manifest.json

Unity Package Manager の依存ライブラリ宣言。npm の package.json に相当します。

{
  "dependencies": {
    "com.unity.cinemachine": "2.9.7",
    "com.unity.textmeshpro": "3.0.6",
    "com.unity.inputsystem": "1.5.1",
    "com.unity.render-pipelines.universal": "14.0.8",
    "com.unity.addressables": "1.21.14",
    "com.unity.ide.visualstudio": "2.0.18",
    "com.unity.ide.rider": "3.0.21",
    "com.unity.collab-proxy": "2.0.5",
    "com.unity.test-framework": "1.1.33"
  },
  "scopedRegistries": []
}

Unity Hub での複数プロジェクト管理

Unity Hubは Unity 公式のランチャー兼バージョン管理ツールです。

  • Projects タブ: 開いたことのある全プロジェクト一覧
  • Installs タブ: 複数の Unity バージョン共存（2021.3 / 2022.3 / 6000.0 LTS など）
  • Learn タブ: 公式チュートリアル
  • Community タブ: アセットストア・フォーラム

同じプロジェクトを異なる Unity バージョンで開くと、Library が再生成されるためファイル整合性に注意（特にチーム開発）。

ProjectSettings の主要アセット

ファイル内容
ProjectSettings.asset会社名 / 製品名 / バージョン
InputManager.assetレガシー Input 設定（Horizontal / Jump 等）
QualitySettings.asset描画品質プリセット
TagManager.assetTag / Layer / Sorting Layer
PhysicsManager.asset / Physics2DSettings.asset物理エンジン
AudioManager.assetオーディオ・空間音響
GraphicsSettings.assetシェーダー・URP/HDRP 等の選択
EditorBuildSettings.assetビルドに含めるシーン一覧

プロジェクトの新規作成

  1. Unity Hub を起動
  2. 「New project」をクリック
  3. Editor バージョンを選択（LTS 推奨: 2022.3 / 6000.0）
  4. テンプレートを選択（2D / 3D Core / URP / HDRP / Mobile 等）
  5. プロジェクト名・保存場所を入力
  6. 「Create project」

プロジェクトのバックアップ

Unity プロジェクトは Git 管理が基本ですが、それでも以下を別途バックアップすると安全:

  • Git / GitHub / GitLab: Assets / ProjectSettings / Packages
  • 大容量バイナリ: Git LFS / クラウドストレージ（OneDrive / Google Drive）
  • 外付け SSD: プロジェクト全体（Library 含む）の定期スナップショット
  • ビルド済みバイナリ: リリースタグごとに別保管

FAQ

Q: プロジェクトを別 PC に持っていきたい
A: 最低限 Assets / Packages / ProjectSettings をコピー。Library 等は不要。受け手側で Unity Hub から「Open project」、初回は Library 再生成で時間がかかります。

Q: プロジェクトサイズが大きすぎる
A: テクスチャ・FBX・音声の最適化（圧縮設定の見直し）、未使用アセット削除、Addressables への移行で配布サイズ削減。

Q: 別バージョンの Unity で開いたら警告が出る
A: Unity はプロジェクトのバージョンアップは不可逆です。事前に Git でブランチを切り、別バージョン専用にしておくこと。