サンプル: csv_export

ワールド (または選択範囲) のブロックの種類ごとの数を CSV にエクスポートするサンプル・id csv_export ・SDK ^1.0 ・最新バージョン 1.0.0

マネージャーウィンドウでの名前は「블록 통계 CSV (예제)」(ブロック統計 CSV、サンプル) です。SDK 1.0 の機能だけを使います。

示す内容	コード
エクスポート形式	`AddExporter` · `NpFileFormat`
コンソールコマンドと引数	`AddCommand`
編集の監視	`Committed`
新しいワールドで状態をクリア	`WorldChanged`
テストしやすい構造	計算関数 (`Stats` ・ `ToCsv`) を `INpWorld` だけを受け取る `static` 関数として分離

要件

項目	値
エディター	0.9.0 以上
SDK	1.0 以上 (`^1.0`)
依存プラグイン	なし
ソース	NP Editor ソースの `samples/plugins/csv_export/` (`Plugin.cs` ・ `CsvExport.csproj` ・ `plugin.json`)

ビルドします。
```
dotnet build samples/plugins/csv_export/CsvExport.csproj -c Release
```
ソースの外でビルドする場合は、クイックスタートのように、インストールフォルダーの NP.Editor.Sdk.dll を参照するよう csproj を変更します。
CsvExport.dll と plugin.json を %APPDATA%\NPEditor\plugins\csv_export\ にコピーします。NP.Editor.Sdk.dll は入れません。
ツール › プラグインマネージャー… で「再スキャン」を押します。
「블록 통계 CSV (예제)」が「オン」になれば完了です。

コンソールで直接確認することもできます (数値は例です)。

> blockstats 3
블록 2,304칸 · 4종 · 편집 2번(2,304칸)
  minecraft:grass_block  2,048
  minecraft:stone_bricks  200
  minecraft:oak_stairs  40

種類	名前	説明
エクスポート	ビルド › エクスポート: 블록 통계 CSV (`.csv`)	ブロックステートごとの数・割合を CSV に書き出します。選択があれば選択範囲内のみ、なければワールド全体です。空気は数えません。
コマンド	`blockstats [n]`	全体のマス数・種類数・編集回数と、多い順に上位 `n` 行 (既定 5) を表示します。選択があれば選択範囲内のみを数えます。
イベント	`Committed`	プラグインを有効にした後 (または新規ワールドの後) の元に戻すのステップ数と、変更されたマスの数を数えます。
イベント	`WorldChanged`	編集回数を 0 に戻します。

列	内容	例
`block`	プロパティを除いたブロック id	`minecraft:oak_stairs`
`state`	ブロックステートの文字列全体	`"minecraft:oak_stairs[facing=east,half=bottom]"`
`count`	マス数	`40`
`percent`	全体に対する % (小数第 3 位まで、ドット区切りの小数)	`1.736`

数はブロックステートごとです。blockstats の行はプロパティを除いた id を表示するため、同じ id が複数行に出ることがあります (向きの異なる階段など)。
plugin.json の説明には「파일 › 내보내기」(ファイル › エクスポート) と書かれています。0.9.0 以降、エクスポート項目は「ビルド」メニューにあります。
大きなワールドではワールド全体をスキャンするため時間がかかります。その間、エディターは停止します。
編集回数はメモリ上にだけあります。エディターを再起動すると 0 になります。

バージョン	日付	内容
1.0.0	2026-10-02	最初のバージョン: エクスポート「블록 통계 CSV」・コマンド `blockstats` ・ `Committed` による編集回数