「追加」に石レンガの階段の塔のプリセットを追加するサンプル・id hello_tool ・SDK ^1.1 ・最新バージョン 1.1.0
マネージャーウィンドウでの名前は「계단 탑 (예제)」(階段の塔、サンプル) です。1 つのプラグインで複数の登録ポイントを使う方法を示します。
| 示す内容 | コード |
|---|
| クイック追加 + 元に戻す 1 ステップ | AddQuickAddItem · World.Edit |
| 設定パネル | AddContentTab · NpUi |
| コンソールコマンド | AddCommand |
| ショートカット | AddShortcut |
| 3D オーバーレイ描画 | host.Draw |
| 設定の保存 | host.Settings |
| 新しいワールドで状態をクリア | WorldChanged |
| 項目 | 値 |
|---|
| エディター | 0.9.0 以上 |
| SDK | 1.1 以上 (^1.1) |
| 依存プラグイン | なし |
| ソース | NP Editor ソースの samples/plugins/hello_tool/ (Plugin.cs ・ HelloTool.csproj ・ plugin.json) |
- ビルドします。
dotnet build samples/plugins/hello_tool/HelloTool.csproj -c Release
NP.Editor.Sdk.dll を参照するように変更します。
- ビルド出力の
HelloTool.dll と plugin.json を %APPDATA%\NPEditor\plugins\hello_tool\ にコピーします (ツール › プラグインフォルダーを開く)。NP.Editor.Sdk.dll は入れません。
- ツール › プラグインマネージャー… で「再スキャン」を押します。初回の場合は、警告で「信頼できる — 読み込む」を押します。
- 「계단 탑 (예제)」が「オン」になれば完了です。
- 床のブロックの上にマウスを置きます。
- メインツールバーの「追加」を開き、
탑 を検索します。
- 分類「プリセット」の「계단 탑」を押します。マウスの下のマスを角として 5×5 の塔ができます。
- Ctrl+Alt+H を押します。塔の周りに青いボックスと「계단 탑 #1」の名札が表示されます。
- Ctrl+Z を 1 回押すと、塔全体が消えます。
| 種類 | 名前 | 説明 |
|---|
| クイック追加 | 「追加」 › プリセット › 계단 탑 | ctx.Place を最小の x・z の角として塔を建てます。検索語: tower stair 탑 계단 나선 |
| パネル | 계단 탑 | 高さ・壁ブロック・階段の木材の設定、建てた数、「선택 가운데에 짓기」(選択の中央に建てる) ボタン。ウィンドウメニューから開きます。 |
| コマンド | tower [高さ] | (0, 1, 0) に塔を建てます。高さは 4〜64 に収めます。結果: 계단 탑 높이 12 — <マス数>칸 |
| ショートカット | 계단 탑: 탑 표시 켜기/끄기 (塔の表示のオン/オフ) (Ctrl+Alt+H) | このワールドで建てた塔ごとに、周囲のボックス + 名札を描画または消去します。 |
| ショートカット | 계단 탑: 마지막 자리 옆에 또 짓기 (最後の位置の隣にもう 1 つ建てる) (Ctrl+Alt+J) | 最後の塔から x 方向に 7 マス隣に建てます。建てた塔がなければ (0, 1, 0) です。 |
| イベント | WorldChanged | 新規ワールド・開くときに、建てた塔の一覧と描画をクリアします。 |
| 部分 | 内容 |
|---|
| 壁 | 5×5 の外周、高さ = 設定「높이」(高さ)、ブロック = 設定「벽 블록」(壁ブロック) |
| 扉 | 最小の z 側の壁の中央、下の 2 マス |
| 窓 | 4 階ごと (y % 4 == 2) に、4 面の壁の中央に 1 マス |
| 中央の柱 | (2, 2) のマス、壁ブロック |
| 階段 | 柱の周りの 8 マスを回りながら、1 段ごとに 1 マスずつ上がるらせん。minecraft:<階段の木材>_stairs |
| 屋根 | 石レンガのハーフブロック + 胸壁、階段の終わりの上に出口の穴 |
塔 1 つは World.Edit 1 回 (元に戻すのラベル 계단 탑 ×<高さ>) です。
| 行 | 種類 | 役割 |
|---|
| 높이 (高さ) | 数値 4〜64 | 塔の高さ。変更するとすぐに保存 |
| 벽 블록 (壁ブロック) | 文字列 | 壁・柱のブロックステートの文字列。変更するとすぐに保存 |
| 계단 나무 (階段の木材) | 文字列 | 階段の木材の名前 (oak ・ spruce ・ birch …)。変更するとすぐに保存 |
| 만든 탑 … (作った塔 …) | ライブテキスト | このワールドで建てた数・これまでに建てた数・ワールドのブロック数 |
| 선택 가운데에 짓기 (選択の中央に建てる) | ボタン | 選択ボックスの中央・床の高さに建てます。選択がなければ通知のみ |
host.Settings に保存します。ファイルは %APPDATA%\NPEditor\plugin_settings\hello_tool.json です。
| キー | 型 | 既定値 | 説明 |
|---|
height | 整数 | 12 | 塔の高さ (パネルの「높이」) |
wall | 文字列 | minecraft:stone_bricks | 壁ブロック (パネルの「벽 블록」) |
stair_wood | 文字列 | oak | 階段の木材 (パネルの「계단 나무」) |
towers | 整数 | 0 | これまでに建てた塔の数 (すべてのワールドの合計) |
- 壁ブロック・階段の木材の文字列は検査しません。誤っているとテクスチャのないブロックが配置されます。
tower <高さ> で変更した高さは今回の実行でのみ使い、保存しません。パネルの高さ欄も変わりません。- 塔の表示 (Ctrl+Alt+H) は、このワールドでプラグインによって建てた塔だけを描きます。元に戻すで消した塔のボックスは残ります。
- パネルの数値・文字列欄の初期値は、プラグインを有効にしたときの設定です。
- クイック追加のアイコンは古い絵文字記号 (
▤) で登録されているため、エディターがプレハブのアイコンに置き換えて表示します。新しいプラグインでは Icon: "prefab" のようにアイコン名を使います。
- パネル名も絵文字記号 (
▤ 계단 탑) で登録されているため、画面には「계단 탑」と表示されます。
| バージョン | 日付 | 内容 |
|---|
| 1.1.0 | 2026-10-02 | SDK 1.1: 設定の保存 (高さ・壁・階段の木材・建てた数)・ショートカット Ctrl+Alt+H / J ・塔の周囲の 3D 描画 |
| 1.0.0 | 2026-10-02 | 最初のバージョン: クイック追加「계단 탑」・設定パネル・コマンド tower |