GitHub から Unity プロジェクトを clone してゲームを起動する

# GitHub から Unity プロジェクトを clone してゲームを起動する

こんにちは、@studio_meowtoon です。今回は GitHub から Unity プロジェクトを clone してゲームを起動する方法を紹介します。
![csharp_in_unity.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/0a784c1a-f580-0d22-cafc-93c450f28461.png)

## 目的

GitHub から Unity プロジェクトを clone してゲームを起動する方法を学びます。

:::note warn
ここでは、ゲームのソースコードを GitHub で管理することを想定します。
:::

## 開発環境

+ Windows 11 Home 22H2
+ Unity 2022.3.10f1 LTS
+ Visual Studio Community 2019 Version 16.11.19

## プロジェクトの取得

以前に紹介したプロジェクトを例に、手順を以下に紹介します。

https://qiita.com/studio_meowtoon/items/5dc8744e8896df92b003

https://github.com/3d-gamedev/battle-tank/tree/release/v0.1

### プロジェクトをローカルPCに clone する

プロジェクトを保存するフォルダを作成します。

:::note info
ここでは、C:\\Users\\{ユーザー名}\\Projects フォルダを作成しました。
:::

Windows 11 のコマンドプロンプトでディレクトリに移動します。

```sh
> cd C:\Users\{ユーザー名}\Projects 
```

Unity のプロジェクトを clone します。

```sh
> git clone https://github.com/3d-gamedev/battle-tank.git -b v0.1.0
```

ここでは、**-b v0.1.0** で clone するプロジェクトのタグを指定しています。

:::note info
ここまでの作業で、プロジェクトをローカルPCに clone (≒ダウンロード)することができました。
:::

## Unity Hub にプロジェクトを追加する

### Unity Hub 起動

Unity Hub を起動します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/a15e679e-0757-a2cf-4738-f375e2d1baad.png)

### プロジェクトを開く

Unity Hub で取得したプロジェクトを開きます。

[プロジェクト] > [追加] → [ディスクからプロジェクトを加える] ボタンを押します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/d2e93ebc-5114-116e-2b19-ad9aaa0d2c8a.png)

ここでは、[battle-tank] フォルダを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/0ea4fe65-750c-81f2-68c5-48070781de91.png)

[battle-tank] プロジェクトを追加することができました。

### ※Unity エディターのバージョンが違う場合

git clone で取得したプロジェクトと実際に使用している Unity エディターのバージョンが異なる場合には、Unity エディターのバージョンを指定して開きます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/3d2efe48-e487-6ca0-dc58-bbb7d4860318.png)

:::note alert
以下のワーニングが出ますが続行します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/9ac7f8a5-bb91-e778-cb81-be68f7cb79e1.png)
:::

### Unity エディターでプロジェクトが開けた状態

プロジェクトを開くことに成功したら以下のような画面になります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/6aad6e7c-4b8b-ed00-3496-edb87e9f8c14.png)

:::note info
ここまでの作業で、プロジェクトを Unity エディターで開くことができました。
:::

## ゲームをプレイする

:::note warn
Unity エディターでは、ゲームをプレイする時に **Secene** を選ぶ必要があります。
:::

左下の [プロジェクト] > [Assets] > [Scenes] から [SampleScene] をダブルクリックで選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/c1f1a9c2-e72d-71d7-664b-961860e9eb48.png)

中央の [シーン] タブにゲームのオブジェクトたちが表示されます。

次に、中央の [ゲーム] タブを選択し、上部中央の [▶] ボタンを押します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/92a0f6b0-292d-434f-1c05-88c56c460dcc.png)

Unity エディターでゲームをプレイすることができます。

![Movie_003.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3206449/506b44de-9f12-274b-e31f-db5783cb0743.gif)

**操作方法(PC キーボード)**

|キー|操作|
|:--|:--|
|Z|前進|
|X|弾を発射|
|左カーソル|左に回転|
|右カーソル|右に回転|

:::note info
ここまでの作業で、プロジェクトを Unity エディターでプレイすることができました。
:::


## まとめ

GitHub から Unity プロジェクトを clone してゲームを起動することができました。

:::note alert
この記事の実装例は一つのアプローチに過ぎず、必ずしも正しい方法とは限りません。他にも多様な方法がありますので、さまざまな情報を照らし合わせて検討してみてください。
:::

どうでしたか？ Window 11 の Unity で3Dゲームを開発する環境を手軽に構築することができます、ぜひお試しください。今後も Unity の開発トピックなどを紹介していきますので、ぜひお楽しみにしてください。

## 推奨コンテンツ

https://qiita.com/studio_meowtoon/items/5dc8744e8896df92b003