How to Make Your First Custom Item Addon in Minecraft Bedrock! (Easy Beginner Tutorial)

About this page

As the title suggests, this article explains how to create original items and add-ons in the Minecraft Bedrock Edition. For example, like this: ↓

While it’s a little cut off, the image on the left shows me creating my own block, the “Magic Workbench,” on a workbench, while the image on the right shows me adding a custom sword.

Character
You can create your own unique world!

By watching this article and video, you’ll be able to create these custom items in the Minecraft Bedrock Edition. First, please watch this video. I previously posted it on YouTube, but it’s easy to follow thanks to its slow explanation.

Incidentally, while the video says “describe in the description,” I’ll write it below, not in the description. To create original items, you’ll need to create something called an “add-on,” as I’ll explain later. First, let’s set up the add-on creation environment!

  • At a minimum, you need Minecraft (PC version).
created by Rinker
¥3,960 (2025/10/18 11:12:25時点 楽天市場調べ-詳細)

Minecraft path

To create a addon, you must first open the working folder. If you haven’t changed the folder location, the Minecraft (Bedrock Edition) folder is located as follows:

C:\Users\(username)\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang.

In File Explorer, the “AppData” file is a hidden file. To select it, you must enable hidden files in File Explorer’s View settings. Alternatively, you can open it by launching the “Run” app and entering “%LocalAppData%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang.” In Windows 10, you can launch the “Run” app by typing “Run” in the “Type here to search” search box on the taskbar.

First, let’s open the Minecraft (Unified Edition) folder. This is the add-on’s working folder.

Creating custom items

For details on how to create an original item, please watch the video above. This article will briefly explain how to create an original item. First, creating an “add-on” is required to create an original item.

What is an add-on?

Simply put, an add-on is software that adds new functionality to existing software (in this case, Minecraft). Using add-ons, you can create original items like those found in the Marketplace, as well as custom entities, biomes, and even commands and enchantments!

Character
Add-ons significantly modify the game itself.

Add-ons are broadly divided into “behavior packs” and “resource packs.” The former defines item behavior, while the latter defines the appearance. Behavior packs define item actions and behavior. Resource packs define item appearance. Let’s start by creating these two.

Creating a Resource Pack

First, open the Minecraft folder (com.mojang) listed above and open development_resource_packs. Then, create a new folder (name it as you like) directly under development_resource_packs and create and place the manifest.json file for the resource pack inside it. The contents are as follows: (As explained later, it is recommended to change the uuid)


{
    "format_version": 1,
    "header": {
        "description": "This is a Sample Resource Pack.",
        "name": "Sample Resource Pack",
        "uuid": "adfbd316-3164-409f-a89c-d31466588931",
        "version": [1, 0, 0],
        "min_engine_version": [1, 12, 0]
    },
    "modules": [
        {
            "description": "Sample Resource Pack",
            "type": "resources",
            "uuid": "adfbd316-3164-409f-a89c-d31466588932",
            "version": [1, 0, 0]
        }
    ],
     "dependencies": [
    {
     "uuid":"adfbd316-3164-409f-a89c-d31466588933",
      "version":[1,0,0]
    }
 ]
}
Copied!
Character
Open this in a text editor like VSCode or Notepad.

This defines the requirements for this resource pack. The description above defines the resource pack’s description, and the name defines the resource pack’s name. As mentioned earlier, the three uuids listed here are unique IDs that identify this resource pack and cannot be duplicated with other resource packs. For convenience, we’ve included the uuid above, but we strongly recommend changing it to prevent conflicts with other resource packs. You can generate a UUID on this page.

Character
A UUID is a unique identifier defined in hexadecimal notation.

Creating a Behavior Pack

Once you’ve finished generating the resource pack, you’ll then generate a behavior pack. As before, open development_behavior_packs directly under com.mojang and create a folder with a name of your choice. Create and place manifest.json for the behavior pack in that folder. It contains the following:

{
    "format_version": 1,
    "header": {
      "description": "This is a Sample Behavior Pack",
      "name": "Sample Behavior Pack",
      "uuid":"adfbd316-3164-409f-a89c-d31466588933",
      "version": [1, 0, 0],
      "min_engine_version": [1, 12, 0]
    },
    "modules":
      [
        {
          "description": "Sample Behavior Pack",
            "type": "data",
            "uuid": "adfbd316-3164-409f-a89c-d31466588934",
            "version": [1, 0, 0]
        }
      ],
    "dependencies": [
      {
       "uuid":"adfbd316-3164-409f-a89c-d31466588931",
        "version":[1,0,0]
      }
   ]
  }
Copied!

We recommend changing the UUID here as well, but there is one important thing to note. In order to link a behavior pack and a resource pack, the UUID of the dependencies in the resource pack’s manifest.json must match the UUID of the behavior pack’s header. Similarly, the UUID of the dependencies in the behavior pack and the UUID of the resource pack’s header must also match.

Character
Note that in the above script, these match.

By the way, we have created a generator to make it easy to generate these series of manifest.json files. You can access it here:

Easy Manifest.json Template Generator [ Minecraft Bedrock Edition ]
Easy Manifest.json Template Generator [ Minecraft Bedrock Edition ]
Minecraft manifest.json ジェネレーター Minecraft manifest.json Generator Addon Name Addon Description Addon Version (Optional) Minimum Required Minecraft Version (Optional) Use Script API @minecraft/server Version (Optional) @minecraft/server-ui Version (Optional) Entry JS File (Optional) Generate Behavior Pack Copy Resource Pack Copy overview When creating add-ons for the Minecraft Bedrock Edition, manifest.json is a…

Once you’ve finished creating your resource pack and behavior pack, check that they’re properly reflected in Minecraft. Open the world creation screen and check the behavior pack list page:

It won’t have any functionality, but if the behavior pack itself is properly reflected, you’ve succeeded. Check the resource pack in the same way.

Character
Now you’ve created a “do-nothing add-on!”

For reference, here’s an illustration of the structure of the various files and folders you’ve created so far:

The manifest.json file outlined in red is the file you just created.

Creating an Original Item

Now, the real work begins. Let’s actually create a custom item. First, create a folder called “items” in the behavior pack folder you just created, and create and place a json file named (item name).json inside it. For example, here’s an example of sample_item.json for creating a “sample_item”:

{
    "format_version": "1.21.10",
    "minecraft:item": {
      "description": {
        "identifier": "test:sample_item"
      },
      "components": {
        "minecraft:icon":"sample_item"
      }
    }
}
Copied!

The “identifier” above defines the item’s ID. In this case, it’s “test:sample_item.” Feel free to change this. This is required for the give command.

You can also use my “Original Item Generator” for this part. It’s compatible with version 1.21.20. You can also use the script created here as is.

[No Coding] Custom Item Generator – Create Your Own Items Online! [Minecraft Bedrock 1.21.20+]
[No Coding] Custom Item Generator – Create Your Own Items Online! [Minecraft Bedrock 1.21.20+]
Item ID Display Name (optional) Item Type None Food Weapon Fuel Set Item Category Allow Off-hand Stack Size Use Animation Eat Drink Nutrition Saturation Modifier Time to eat [seconds] Can always eat: Convert to another item on use (optional): Attack Damage Enchantment Settings Sword Pickaxe Axe Shovel Elytra All Durability…
Character
You can also use this to make swords and food.

  • This defines the minimum item.

However, this isn’t the end. Next, you need to define the item’s texture. Create a folder called “textures” in the resource pack folder you created earlier, and then create a folder called “items” within that. Place the item’s texture image inside.

Save it as (the item’s name).png. In this case, it’s “sample_item.png.” You can also create your own original texture and use it. In that case, image editing software is very useful, so it’s a good idea to use it. I use software called “Clip Studio.”

Character
If you’re distributing an add-on, it’s a good idea to have your own texture.

If you create your own texture, I recommend setting the size to 16×16. Next, return to the “textures” folder and place item_texture.json inside it. Here’s the script for creating “sample_item”:

{
    "resource_pack_name":"sample_resource",
    "texture_name":"atlas.items",
    "texture_data":{
        "sample_item":{
            "textures":"textures/items/sample_item"
        }
    }
}
Copied!

Be sure to replace sample_item above with your own item name. This must be the same as what you defined in “minecraft:icon” in the item definition earlier.

Folder Structure (Reposted)

I’ll leave the folder structure here again just in case. If you’re unsure, please also see this:

This defines the item’s texture.

Translation:

As it is, it will be displayed as “item.test:sample_item”, which doesn’t look very good. You can solve this problem by defining translation. Open the resource pack folder and create a folder called “texts”. Inside it, create a lang file called “ja_JP.lang”.(when you want to translate it to English, call it “en_US.lang“) Open this in a text editor and write it like this:

Copied!
item.test:sample_item=sample_item. 

Replace “test:sample_item” on the left with your own item ID, and “sample_item” with the Japanese (or English) you want to translate.

Setting the Pack Icon:

The icons for behavior packs and resource packs will be reflected in their respective folders by placing them in the same directory as manifest.json, with the name “pack_icon.png.” If you do this and run Minecraft, you’ll see the following:

Character
This setting is recommended for distribution.

Now, we’ve created a “do-nothing item.” But that’s not enough, is it? For example, you might want to create an item with some kind of effect, like a sword that activates a special effect when used or food that has an effect when eaten. This is where “custom components” come in. For more information, see:

【マイクラ統合版】自作アイテムに特殊効果を付与できる、カスタムコンポーネントとは? – ScriptAPIとCustomComponentの概要
【マイクラ統合版】自作アイテムに特殊効果を付与できる、カスタムコンポーネントとは? – ScriptAPIとCustomComponentの概要
はじめに 先日、以下の記事を投稿しました: https://lemon-slime.com/?p=1758 上記で説明してように、マインクラフトではオリジナルアイテムを制作できることが広く知られています。実際に自分好みのアイテムや武器などを作って遊んでいらっしゃる方も少なくないでしょう。 ただ、アイテムというのはただ存在すればいいというものではありません。ただテクスチャーを貼っただけのアイテムは、プレイヤーにとって何ら新鮮味がないですよね。できることなら、そのアイテムに特殊効果を持たせて、唯一無二のアイデンティティを確立させたいものです。例えば・・・ 攻撃したときに毒を付与したい! 食べると暗視の効果がつく食べ物を作りたい! という具合。 それができて初めて、作ったアドオンに個性が生まれるのです。「焔の剣」という名前なのに何の効果もない剣とか、何も面白みがないですよね? ということで、本記事では、オリジナルアイテムに特殊効果を付与する方法についてお話していきます。上記の記事が前提となる旨、予めご了承ください。 Youtube動画 本記事の内容について解説したYoutube動画を作成しました。こちらより視聴できます: https://youtu.be/7v6DAZ81odg 前提 とはいえ、以前(ver1.21.20より前)はアイテムに特殊効果を付与することなど何ら難しいことではありませんでした。言わずもがな、アイテムの定義ファイル内でeventsを定義するだけでよかったからです。しかし、「ホリデークリエイターの特徴」の削除はアドオン環境を大きく一変させました。詳細はこちらの記事で説明しています: https://lemon-slime.com/?p=1024 このアップデートを機に、アイテムへの特殊効果の付与にはScriptAPIの一要素である、CustomComponent(カスタムコンポーネント)の使用が必須となってしまいました。これによって大きく制作難易度が上昇したのは言うまでもありません。 本記事では、このアップデートに対応し、カスタムコンポーネントを使用した方法について説明していきます。 カスタムコンポーネントとは カスタムコンポーネント(CustomComponent)とは、端的に言えば自分で定義するアイテム・ブロックのコンポーネント(構成要素)のことです。アイテムの定義時に、jsonファイル内で"minecraft:food"や"minecraft:max_stack_size"のように様々なコンポーネントを使用しますよね?  このコンポーネントを自作し、その効果についてScriptAPIを用いて決定する一連の過程・システムのことをカスタムコンポーネントと呼称します。 要は自分でアイテム・ブロックの性能をカスタマイズできる機能のことです 本題 まず、アドオンの構成は以下。ScriptAPIを用いるため、scriptsフォルダとmain.jsが必須となります。 アドオン・アイテムの定義 アドオンそのものの作成方法や、「何もしないアイテム」の定義方法については、本題ではないのでここでは割愛します。それらの詳細については、こちらの記事で詳しく解説しております。 「何もしないアイテム」が前提となります また、ScriptAPIを使う都合上、ビヘイビアパックのmanifest.json内で、moduleとしてscripts/main.jsの定義が必須です。古い記事を参考にしてアイテムを定義している場合、manifest.json内で同記述が存在しない可能性があるので注意しましょう。manifest.jsonの内容自体は上の記事でコピペできます。 { "type": "script", "language": "javascript", "uuid": "f1942413-eee9-4f18-a275-a408b915ddab", "entry": "scripts/main.js", "version": [0, 1, 0] }, みたいな記述があればOKです カスタムコンポーネントの付与 まず、アイテムにカスタムコンポーネントを付与する必要があります。具体的には、ビヘイビアパックのアイテムを定義するjsonファイル内で、"components"内に "minecraft:custom_components":["custom:test"] コピー Copied! といったコンポーネントを追加しなければなりません。このうち、"custom:test"はカスタムコンポーネントのidであり、これは(名前空間):(id名)の形式であればどんな名前でも問題ありません。ご自身で分かりやすい名前をつけてください。 このidは後で使います…

Custom components require a Script API environment. This site also explains how to create original blocks. For more details, please visit:

【マイクラ統合版】オリジナルブロックの作り方を解説 – 初心者のためのアドオン制作【ver 1.21.20~対応】 
【マイクラ統合版】オリジナルブロックの作り方を解説 – 初心者のためのアドオン制作【ver 1.21.20~対応】 
はじめに 本記事では、マインクラフト統合版でのオリジナルブロックの制作方法について解説します。 オリジナルブロックはアイテムと異なり、自由度が大きい分様々な点で複雑です。したがって、解説は本記事を含めて何回かに分けて行うことになるかと思います。本記事では、まず「何もしない単純なブロック」を制作し、これをゲーム内に追加していきます。 本記事の内容について解説したYoutube動画を作成しました。こちらより閲覧できます: https://youtu.be/S7TZ602bkdE 前提 ブロックの制作にあたっては、「何もしないアドオン」の制作が必須です。まずはアドオンそのものを作っていきましょう。既にアドオンがある場合、この節は飛ばしてください。 com.mojangの場所 まず、アドオン制作の舞台となるcom.mojangフォルダにアクセスしましょう。フォルダの場所を以下に示します。 フォルダの場所を変更していない場合、マインクラフト(統合版)のフォルダの場所は以下の通り。C:\Users\(ユーザー名)\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojangエクスプローラー上で、「AppData」というファイルは隠しファイルです。これを選択するには、エクスプローラーの「表示」設定から隠しファイルのチェックをオンにすればOKです。 または、「ファイル名を指定して実行」というアプリを起動し、「%LocalAppData%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang」と入力することでも開くことができます。 Windows10の場合、「ファイル名を指定して実行」というアプリは、タスクバーにある「ここに入力して検索」と記された検索ボックスに、「ファイル名を指定して実行」と入力することで起動できます。 まずは、準備としてこのマインクラフト(統合版)のフォルダを開きましょう。 アドオンはイラストのように「ビヘイビアパック」と「リソースパック」の2つによって構成されます。ここでは、簡単にその2つを定義していきましょう。 development_behavior_packsを開き、まずはビヘイビアパックを制作します。フォルダを新規作成し、任意の名前を付けましょう。その後、そのフォルダを開き、manifest.jsonを作成します。 以下は、manifest.jsonの内容です。これをコピー&ペーストし、テキストエディタに貼り付けましょう。 { "format_version": 2, "header": { "name": "テスト用アドオン", "description": "アドオンのテストです", "uuid": "adfac116-3164-409f-a89c-d31366588136", "version": [1, 0, 0], "min_engine_version": [1, 20, 0] }, "modules": [ { "type": "script", "language": "javascript", "uuid": "b1ef9620-c58e-4fa3-bdcd-f5f1d3c70c12", "entry": "scripts/main.js", "version": [0, 1,…

最新情報をチェックしよう!