Unity の Package Manager では、Unity公式のパッケージのほか、GitHub やパソコンの中のパッケージも追加できます。
追加の入り口は、Package Manager の左上の「+」です。
- 名前で追加:Install package by name
- Git から追加:Install package from git URL(# でタグ、?path= でフォルダー)
- パソコンから追加:Install package from disk(package.json を選ぶ)・Install package from tarball(.tgz を選ぶ)
- 独自の配布元を使う:Project Settings の Package Manager でスコープ付きレジストリを登録
この記事は、Unity公式マニュアル(Unity 6.3)の Package Manager のページ(2026年9月29日に確認)にもとづいています。
Unityのエディタでの再現は含まず、画面の名前は英語版の表記です。
Package Managerを開く
「Window」→「Package Manager」で開きます。
左上の「+」を押すと、4つの追加方法が出ます。
名前で追加する
- 「+」→「Install package by name」を選ぶ
- Name にパッケージ名(例:com.unity.toonshader)を入れる
- 必要なら Version に版を入れる
- 「Install」を押す
版が分からないときや、今のエディタに合う最新の版を入れたいときは、名前だけ入れればよいとマニュアルに書かれています。
Git URLで追加する
GitHub などで公開されているパッケージは、リポジトリの URL で追加できます。
- パソコンに Git(2.14.0 以上)を入れ、PATH に Git の場所を通しておく
- 「+」→「Install package from git URL」を選ぶ
- URL を入れて「Install」を押す
リポジトリが Git LFS を使っている場合は、Git LFS も入れておきます。
| やりたいこと | 書き方の例 |
|---|---|
| タグ・ブランチ・コミットを決める | https://github.example.com/myuser/myrepository.git#v1.0.0 |
| リポジトリの中のフォルダーを指す | https://github.example.com/myuser/myrepository.git?path=/subfolder |
| 両方 | https://github.example.com/myuser/myrepository.git?path=/example/folder#v1.2.3 |
?path= と # を両方使うときは、?path= を先に書きます。
使えるプロトコルは https・ssh・file・git の4つです。
実際の例として、lilToon は https://github.com/lilxyzw/lilToon.git?path=Assets/lilToon#master の形で案内されています。
パソコンの中のパッケージを追加する
| 方法 | 選ぶもの |
|---|---|
| Install package from disk | パッケージのフォルダーの一番上にある package.json |
| Install package from tarball | 拡張子が .tgz のファイル(それ以外はダイアログに出ない) |
パッケージのフォルダーをプロジェクトの中に置くときは、Assets・Library・ProjectSettings・Packages のフォルダーを避けるよう書かれています。
.unitypackage は Package Manager のパッケージとは別物で、入れ方はUnityにパッケージをインポートする方法で紹介しています。
スコープ付きレジストリを登録する
会社のサーバーや OpenUPM など、Unity以外の配布元からパッケージを入れるときに使います。
- 「Edit」→「Project Settings」→「Package Manager」を開く
- Scoped Registries の一覧の下の「+」を押す
- Name・URL・Scope(s) を入れる
- 「Save」を押す
登録した内容は、プロジェクトの Packages フォルダーにある manifest.json の scopedRegistries に書き込まれます。
{
"scopedRegistries": [
{
"name": "Example",
"url": "https://registry.example.com",
"scopes": ["com.example"]
}
],
"dependencies": {
"com.example.tool": "1.0.0"
}
}Scope(s) には、そのレジストリから取るパッケージ名の頭の部分を書きます。
同じ画面の Advanced Settings にある「Show Pre-release Package Versions」をオンにすると、正式版の前の版も一覧に出ます。
うまく入らないとき
- Git URL で失敗する:Git が入っているか、PATH が通っているかを確かめる。入れたあとは Unity Hub ごと再起動する
- LFS のファイルが取れない:Git LFS を入れる
- 版が合わない:Version を空にして、今のエディタに合う版を入れる
まとめ
- 追加の入り口は Package Manager の「+」
- Git URL は # で版、?path= でフォルダーを指す(?path= が先)
- パソコンからは package.json か .tgz を選ぶ
- 独自の配布元は Project Settings の Package Manager で登録する
参考:Unity「Add and remove UPM packages」「Git dependencies」「Scoped registries」(2026年9月29日に確認)。
