Amazonで商品を見るセール会場へ

Unity│Package Managerの使い方|Git URL・スコープ付きレジストリ・ローカル追加

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つの追加方法が出ます。

名前で追加する

  1. 「+」→「Install package by name」を選ぶ
  2. Name にパッケージ名(例:com.unity.toonshader)を入れる
  3. 必要なら Version に版を入れる
  4. 「Install」を押す

版が分からないときや、今のエディタに合う最新の版を入れたいときは、名前だけ入れればよいとマニュアルに書かれています。

Git URLで追加する

GitHub などで公開されているパッケージは、リポジトリの URL で追加できます。

  1. パソコンに Git(2.14.0 以上)を入れ、PATH に Git の場所を通しておく
  2. 「+」→「Install package from git URL」を選ぶ
  3. 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
Unity公式マニュアル「Git dependencies」の例

?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以外の配布元からパッケージを入れるときに使います。

  1. 「Edit」→「Project Settings」→「Package Manager」を開く
  2. Scoped Registries の一覧の下の「+」を押す
  3. Name・URL・Scope(s) を入れる
  4. 「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日に確認)。

次に学ぶ・作業環境を選ぶ

学習を続けたい方や、作業環境を整えたい方は、目的に合うガイドをご覧ください。

Unityのおすすめ書籍

開発PCの選び方

周辺機器の優先度

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次