配布とバージョン

プラグインはフォルダー 1 つで配布します。受け取った人は、そのフォルダーをプラグインフォルダーに入れ、プラグインマネージャーで有効にします。

含めるファイル

ファイル	含めるか	説明
`plugin.json`	はい	フォルダーの直下
自分の dll	はい	`plugin.json` の `dll` のパス
自分が使う他の dll (NuGet パッケージなど)	はい	自分の dll の隣。ビルド出力の `.deps.json` も一緒に入れます。
`.pdb`	任意	エラーの位置 (行番号) がログに表示されます。
`NP.Editor.Sdk.dll`	いいえ	エディターのものを使います。csproj で `Private=false` にして除外しておきます。
大きなデータ	任意	フォルダー内に置き、`host.PluginDir` で見つけます。

road_tools\
├─ plugin.json
├─ RoadTools.dll
├─ RoadTools.deps.json
├─ RoadTools.pdb
└─ data\
   └─ presets.json

dotnet build -c Release の出力フォルダーから上のファイルを選んで圧縮します。受け取る人には次のことを伝えます。

エディターのインストールフォルダーの下にある plugins\ フォルダーに入れても、エディターは読み込みます。

plugin.json の version は semver (major.minor.patch) で上げます。プラグインマネージャーの「バージョン」列に表示されます。

変更内容	上げる位置	例
バグ修正のみ	patch	1.2.0 → 1.2.1
機能を追加 (保存形式・コマンドはそのまま)	minor	1.2.1 → 1.3.0
コマンド名・ワールドロジック type・設定キー・保存形式を変更	major	1.3.0 → 2.0.0

ワールドロジックの Type と項目の Name はマップファイル (scene.json) に保存されます。変更すると、古いマップのルールが「不明な type」になります。
id は変更しないでください。設定ファイル・ユーザーが変更したショートカットは id で保存されます。

sdk には実際に使う機能の最小バージョンを書きます。

約束	内容
同じ major 内	型・メンバーを追加するだけです。名前の変更や削除はしません。
新しい項目	既定値のある末尾の項目として追加します。古いコードはそのままコンパイルできます。
互換性を壊す変更	major を上げます (2.0)。`^1.x` のプラグインは「バージョン不一致」で安全に停止し、エディターは動作を続けます。
動作	同じ major 内では登録ポイントの意味を変えません。

バージョンごとの変更は SDK 変更履歴にあります。

プラグインは署名チェックなしで、このコンピューター上でエディターと同じ権限で実行されるコードです。

防げるもの	防げないもの
プラグインコードの例外 → そのプラグインだけを無効化 (隔離)	無限ループ・スタックオーバーフロー・プロセスの終了
無効にしたプラグインの登録・描画・カメラの後片付け	ファイルの読み取り・書き込み・削除
	ネットワークへのアクセス

詳しいリストはトラブルシューティングの「公開前の確認」にあります。