プリセット

アイテムプリセット

Minecraft カスタムアイテムコマンドジェネレーター

カスタムアイテムコマンドは、剣の専用プリセットよりも適用範囲が広いものです。やることは、アイテムに名前を付け、プレイヤーが理解できる説明文 (lore) を書き、重要な効果だけを追加し、後段のセレクターやインベントリ判定で安定して使える custom_data マーカーを保存することです。

プリセット結果

ゲーム内では読みやすく、custom_data を通じて後段のマップロジックからも検出可能なカスタムアイテムコマンドが得られます。

出力

カスタムアイテム Give 出力

/give @p minecraft:netherite_sword[custom_name={text:"Vaultbreaker",color:"aqua",italic:false},lore=[{text:"Opens ancient vault routes",color:"dark_gray",italic:false},{text:"Quest item",color:"gold",italic:false}],enchantments={"minecraft:sharpness":4},enchantment_glint_override=true,custom_data={quest_item:"vaultbreaker"}] 1
Too long for Minecraft chat

The longest command line is 328 characters, 72 over the 256-character chat input limit. Pasting it into chat can truncate the line and make Minecraft report a syntax error even when the generated command is valid.

  • Use a Command Block: run /give @s command_block, place it, then paste this command into the block command field.
  • Use a .mcfunction for a reusable datapack: save the line without the leading slash at saves/<world>/datapacks/<pack>/data/<ns>/function/<name>.mcfunction with a minimal pack.mcmeta, run /reload, then run /function <ns>:<name>. Do not paste .mcfunction content into chat.

プリセットのスクリーンショット

Minecraft カスタムアイテムコマンドの記事で使用する NBTForge Workbench の状態です。表示されるコントロールと、生成された出力をあわせて確認できます。

プリセットを作成

  1. 報酬やツールにふさわしいアイテム種別を選び、Give から作業を始めます。
  2. 生のままエスケープした JSON ではなく、custom_name と説明文 (lore) をテキストコンポーネントとして記述します。
  3. そのアイテムの役割上必要な場合に限り、エンチャント、エンチャントの輝き、レアリティ、custom_data を追加してください。
  4. コマンドをコピーし、今後のクリア処理、execute、ルートテーブルのロジックでも識別できるよう、同じ custom_data キーを保ち続けます。

名前、説明文 (lore)、データの三つは一貫させる

表示名はプレイヤーへ「このアイテムは何か」を伝え、説明文 (lore) は「なぜ重要なのか」を補足します。custom_data はコマンドロジック側に対して、後で名前が翻訳されたりスタイル変更されても壊れない安定した識別子を提供します。

NBTForge ではこの 3 要素を Give Workbench にまとめて保持できるため、アイテムはプレイヤーとコマンドロジックの双方にとって長く使い続けられる存在になります。

  • インベントリを読みやすく保つため、表示名は短めに付けてください。
  • 説明文 (lore) の各行は簡潔にしてください。長すぎるテキストはアイテムのツールチップ内でうまく折り返されません。
  • 表示テキストを判定するのではなく、マップのロジックには custom_data を使用してください。

プリセットとして保存するべきタイミング

ボスのドロップ、クエスト報酬、ショップの商品、キットアイテム、アドベンチャーモードのキーアイテムなどとしてカスタムアイテムを使い回す予定がある場合は、必ず保存しておきましょう。保存したひとつのアイテムは、後で Give、Summon、equipment、ルートテーブル、Command Pack の各ステップへ供給できます。

アイテムが一度きりのテスト用途であれば、/give の出力をそのままコピーするだけで十分です。複数のシステムに登場するなら、Project として保管し、同じソース設定を使い回してください。

プリセットを実際の Project に合わせ込む

Minecraft カスタムアイテムコマンドジェネレーターは、単にコピーする文字列ではなく、テスト済みの出発点として扱ってください。出力がきちんと動いた段階で、わかりやすい Project 名を付けて保存し、対象の Minecraft バージョンを書き残し、scoreboard、ボスバー、ルートテーブル、リセット行など関連するセットアップコマンドの近くに置いておきます。

プリセットをマップ、サーバー、Command Pack へ公開する前に、起動中の Workbench の中だけで動かすのではなく、いったんコピーした成果物から実行してみてください。これによって、依存関係の抜け、古いセレクター、Edition の選び間違い、ローカルでの作業状態に依存して偶然動いていただけのコマンドなどを洗い出せます。

  • 選択した Edition と Version は、共有するコマンドにそのまま反映させます。
  • ダメージ、キル、クリア、テレポートを行う前に、無害なコマンドでセレクターの挙動を確認してください。
  • 長いコマンドをチャットに貼り付けるのではなく、Project か関数スタイルのワークフローへ移しましょう。
  • エンティティ、アイテムコンポーネント、passenger、データパックのリソースを変更した後は、警告内容をもう一度見直してください。

FAQ

custom_data は scoreboard のタグを置き換えられますか?

両者は別の問題を解決します。custom_data はアイテム自体を識別し、scoreboard タグはエンティティやプレイヤーを識別するためのものです。多くのマップでは両方を併用しています。

アイテムをカスタムするためには、エンチャントの輝きだけで十分ですか?

いいえ。エンチャントの輝きはあくまで見た目だけの効果です。プレイヤーにも機械にも識別できるアイテムにしたい場合は、custom_name、説明文 (lore)、custom_data を組み合わせて使ってください。

このプリセットを Command Pack に組み込むべきタイミングは?

出力がセットアップ行、リセットコマンド、ルートテーブルのリソース、scoreboard の状態、繰り返し実行するテストに依存している場合は、Command Pack のエントリとして扱います。単発で安全に使えるコマンドであれば、引き続き出力から直接コピーするので構いません。

このワークフローを開く

関連する Give ワークベンチから始め、ワールドに合わせてプリセット項目を調整します。