MOD・ツール/CKAN

CKANはKerbal Space ProgramのMOD管理ツールです。GUIでMODをインストールできるだけでなく、MOD間の依存関係を自動的に解消してくれます。

CKANのインストール

GitHubからckan.exeをダウンロードして、KSP.exe*1と同じフォルダへ置きます。

MODのインストール

ckan.exeをダブルクリックして起動します。

初回起動時は[Refresh]ボタンを押してMOD一覧を取得します。

インストールするMODをチェックして[Go to changes]ボタンを押します。ここではProcedural Airshipsを選択しました。

インストールするMODを確認して[Apply]ボタンを押します。Procedural AirshipsはProcedural Partsに依存するので、一緒にインストールすることが表示されます。

同時使用が推奨されるMODをチェックして、[Continue]ボタンを押します。ここではModule Managerも一緒にインストールすることを選択しました。

ダウンロードとインストールが始まります。

インストール済みのMODにはチェックが表示されます。[Launch KSP]ボタンを押しても良いし、スタートメニューからKSPを起動しても構いません。

上級テクニック

バージョン制限を無視してModを導入する

各Modは作者により動作するバージョンが指定されています。(例: 1.8.1~1.12.0等)
本体のアップデートの度に細かな調整が必要なModもありますが、そうでないものもあります。(特にパーツ追加系)
そういったModを対応するバージョンを無視してCKAN経由でインストールすることができます。
但し、バージョンチェックを無視して導入できるだけであり、動作保証はありませんのでよく確認しながら導入してください。
手順は以下の通り。

1, CKANを起動し、Filtersを押してALLやIncompatible等にして導入したいModを探します。
2, そのModが対応するMax game versionを確認します。(赤丸の部分で確認可能) 今回の場合1.12.1以下のバージョンなら問題なく導入できるようです。

3, 左上のSettings → Compatible game versionsへ進みます。
4, ウインドウが開いたらModインストールを許可するゲームバージョンの下限を指定しAcceptを押します。今回の場合1.12.1以下のバージョンなら問題なく導入できるので、1.12を選べば問題ありません。

5, 適正なバージョンが指定されていればInstalledの場所にチェックを入れられるようになっているはずです。このあとは通常インストールと同じです。

Modの依存関係を把握する、必須または推奨Modの中で未対応のModを見つけ出す

大型Modの中には前提Modが必要なだけでなく、シナジー効果のある推奨Modを用意したりするものもあり、中には大型Mod専用のコンフィグを用意して各Modに対応するなど、とても複雑な相互関係となっています。
この相互関係のうち、RelationshipsのタブからそのModを導入する時に必須または推奨として提示されるもののツリー関係を見ることができます。
CKANでは5つのアイコンと黒文字か赤文字で状況を確認することができます。
例えばこの画像の場合、Real Solar Systemを導入する際、ModuleManager, Kopernics 2, RSSTexturesは必須、それ以下はRecommends(推奨)となっていますが、その中でもRealism Overhaulは赤文字となっています。
この赤文字はそのModまたはそのModのツリー関係にあるModの中に未対応のModが含まれていることを示しています。
この機能を上手く使うと大型Modを導入する前に本来必要だった機能を知ることができるため、せっかく導入したのに機能不全になったり機能が歯抜けになったりする不具合を未然に防ぐことができます。

コマンドラインオプション

CKANにオプションを付けて起動すると、CLIで動作します。

update

まず最初に実行すべきコマンド。インターネット上にあるMOD一覧*2をダウンロードして、ローカルのCKAN\registry.jsonへ保存します。MODの新しいバージョンをインストールしたい場合も、これを実行しましょう。

実行例*3:

C:\Program Files (x86)\Steam\SteamApps\common\Kerbal Space Program>ckan update

Setting up CKAN for the first time...

Creating C:/Program Files (x86)/Steam/SteamApps/common/Kerbal Space Program\CKAN

Scanning for installed mods...

Creating C:/Program Files (x86)/Steam/SteamApps/common/Kerbal Space Program\CKAN\downloads

Downloading updates...

Updated information on 363 available modules

scan

手動(CKANを使わずに)でGameDataフォルダへインストールしたMODをスキャンします。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan scan

available

インストール可能なMODの一覧を表示します。

実行例:

C:\Program Files (x86)\Steam\SteamApps\common\Kerbal Space Program>ckan available

Mods available for KSP 0.90.0

* Achievements (1.8.0) - KSP Achievements

* ActiveStruts (1.1.1) - CIT - ActiveStruts

* ActiveTextureManagement-x64-Aggressive (4-3) - Active Texture Management - X64 - Aggressive

* ActiveTextureManagement-x64-Basic (4-3) - Active Texture Management - X64 - Basic

* ActiveTextureManagement-x86-Aggressive (4-3) - Active Texture Management - X86 - Aggressive

(以下略)

search

名前を基準にMODを探します。

実行例:

C:\Program Files (x86)\Steam\SteamApps\common\Kerbal Space Program>ckan search airship

Found 1 mods matching "airship".

ProceduralAirships

install

MOD名を指定してインストールします。依存するMODも同時にインストールします。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan install ProceduralAirships

About to install...

* ProceduralAirships 1.3

* ProceduralParts v1.0.2

* ModuleManager 2.5.9

Continue? [Y/N] y

Downloading "https://github.com/ItMustBeACamel/ProcAirships/releases/download/1.3/ProcAirships-1.3.zip"

Downloading "https://github.com/Swamp-Ig/ProceduralParts/releases/download/v1.0.2/ProceduralParts-1.0.2.zip"

Downloading "https://ksp.sarbian.com/jenkins/job/ModuleManager/lastStableBuild/artifact/ModuleManager-2.5.9.zip"

0 kbps - downloading - 0 MiB left - 99%

Installing mod "ProceduralAirships 1.3"

Installing mod "ProceduralParts v1.0.2"

Installing mod "ModuleManager 2.5.9"

Updating registry

Commiting filesystem changes

Rescanning GameData

Done!

=の後にバージョン番号を指定してインストールすることも可能です。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan install ProceduralParts=v1.0.1

About to install...

* ProceduralParts v1.0.1

* ModuleManager 2.5.9 (cached)

Continue? [Y/N] y

Downloading "https://github.com/Swamp-Ig/ProceduralParts/releases/download/v1.0.1/ProceduralParts-1.0.1.zip"

0 kbps - downloading - 0 MiB left - 99%

Installing mod "ProceduralParts v1.0.1"

Installing mod "ModuleManager 2.5.9"

Updating registry

Commiting filesystem changes

Rescanning GameData

Done!

オプション-cを付けることで、ローカルのckanファイルを読み込むことができます。GitHubのリポジトリに用意されていない場合はこの方法を用います。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan install -c SCANsat-dev-v9.0rc4.1.ckan

About to install...

* SCANsat-dev v9.0rc4.1

* Toolbar 1.7.8

Continue? [Y/N] y

Downloading "https://github.com/S-C-A-N/SCANsat/releases/download/v9.0rc4.1/SCANsat_v9rc4.1.zip"

Downloading "http://blizzy.de/toolbar/Toolbar-1.7.8.zip"

0 kbps - downloading - 0 MiB left - 99%

Installing mod "SCANsat-dev v9.0rc4.1"

Installing mod "Toolbar 1.7.8"

Updating registry

Commiting filesystem changes

Rescanning GameData

Done!

SCANsat-dev-v9.0rc4.1.ckanの中身

{
   "spec_version": "v1.4",
   "identifier": "SCANsat-dev",
   "x_real_kref": "#/ckan/kerbalstuff/249",
   "x_bad_vref": "#/ckan/ksp-avc",
   "ksp_version": "0.90",
   "author": "DMagic",
   "name": "SCANsat - DEV RELEASE",
   "abstract": "SCANsat: Real Scanning, Real Science, Warp Speed!",
   "license": "restricted",
   "provides": [
       "SCANsat"
   ],
   "conflicts": [

           "name": "SCANsat"
       }
   ],
   "recommends": [

           "name": "Toolbar"
       }
   ],
   "suggests": [

           "name": "RasterPropMonitor"
       }
   ],
   "install": [

           "find": "SCANsat",
           "install_to": "GameData"
       }
   ],
   "resources":
       "repository": "https://github.com/S-C-A-N/SCANsat"
   },
   "version": "v9.0rc4.1",
   "download": "https://github.com/S-C-A-N/SCANsat/releases/download/v9.0rc4.1/SCANsat_v9rc4.1.zip",
   "x_generated_by": "netkan",
   "download_size": 1920582
}

upgrade

MOD名を指定して最新版にアップグレードします。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan upgrade ProceduralParts

Upgrading modules...

Done!

オプションとして--allを付加すると、インストール済みのMOD全てを最新版にします。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan upgrade --all

Upgrading modules...

Done!

remove

MOD名を指定して削除します。

実行例:

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan remove ProceduralParts

About to remove:

* ProceduralParts

Continue? [Y/N] y

Removing ProceduralParts...

Done!

list

インストールされているMODの一覧を表示します。

C:\Program Files (x86)\Steam\steamapps\common\Kerbal Space Program>ckan list

KSP found at C:/Program Files (x86)/Steam/steamapps/common/Kerbal Space Program

KSP Version: 0.90.0

Installed Modules:

- ModuleManager 2.5.9

- Toolbar 1.7.8

Legend: -: Up to date. X: Incompatible. ^: Upgradable. ?: Unknown

トラブルシューティング

CKANはCKANフォルダの中に状態を記録しています。動作がおかしい時はCKANフォルダを削除して、GameDataフォルダをバニラに戻して*4みましょう。
それでもダメな時はKSPを全削除して再インストールしましょう。CKANは「安全のためファイルを上書きしない」という設計になっているのですが、かえって思い通りにいかないこともあります。
CKANのリポジトリには不安定版が登録されないことがあります。SCANsatのVer. 9系列は開発版という位置づけのため登録されませんでした*5。

コメント