🧱
Block
Creating your first custom block
Resourcepack hosting
Remember to decide a resourcepack hosting method before you start.
I advise you to use self-host which is easier and faster, but you can also use Dropbox and similar
For example I created a file which will contain all my custom blocks.
I created it in the folder:
plugins/ItemsAdder/contents/myitems/configs/
In this file (
blocks.yml
) I start creating a simple block called red_block
.info:
namespace: myitems
items:
red_block:
display_name: Red Block
permission: red_block
resource:
material: PAPER
It's very important to use a non placeable vanilla material. For example
PAPER
.
If you use a block (like STONE
or DIRT
) it will result a bit glitchy when placed.Now the fun part, let's set the textures!
To do that you have to put the
.png
textures file inside the correct folder.In this case your namespace is
myitems
so you have to put them in this folder:
plugins/ItemsAdder/contents/myitems/textures/block/
Alternatively you can put them in this folder too:
plugins/ItemsAdder/contents/myitems/resourcepack/assets/myitems/textures/block/

Now open
blocks.yml
file again and add the resource
part as I did.
As you can see I set generate: true
and I set the textures for the item.
This tells the plugin to generate the 3D model automatically using your texture.info:
namespace: myitems
items:
red_block:
display_name: Red Block
permission: red_block
resource:
generate: true
material: PAPER
Important: keep the correct cardinal directions order as shown in the example.
info:
namespace: myitems
items:
red_block:
display_name: Red Block
permission: red_block
resource:
generate: true
material: PAPER
textures:
- block/red_block_down.png
- block/red_block_east.png
- block/red_block_north.png
- block/red_block_south.png
- block/red_block_up.png
- block/red_block_west.png
info:
namespace: myitems
items:
red_block:
display_name: Red Block
permission: red_block
resource:
generate: true
material: PAPER
textures:
- block/red_block.png
You have to add the
specific_properties
attribute.info:
namespace: myitems
items:
red_block:
display_name: Red Block
permission: red_block
resource:
generate: true
material: PAPER
textures:
- block/red_block.png
specific_properties:
block:
placed_model:
type: REAL_NOTE
break_particles: ITEM
Click on the bottom link if you want to specify tools which can break the block, add hardness and other attributes.
Now you just need to tell the plugin to load your just added block.
Make sure to read the hosting tutorial or you won't see the block correctly.
Run
/iaget red_block
to get the item.


specific_properties:
block:
placed_model:
type: REAL_NOTE
break_particles: BLOCK
rotx: 0
roty: 0
cancel_drop: true #default is false. if true the custom block won't be dropped when
#player mines it
light_level: 12 #make block emit light
#tools you can't use to break block(accepts partial name of material/customitem)
break_tools_blacklist:
- WOODEN_PICKAXE
- STONE_PICKAXE
- IRON_PICKAXE
#tools you can use to break block(accepts partial name of material/customitem)
break_tools_whitelist:
- DIAMOND_PICKAXE
- PICKAXE
- pickaxe
hardness: 2 #hardness of the block
blast_resistance: 1 #explosion resistance (by default is hardness*3)
no_explosion: false #totally immune from explosions, ignoring blast_resistance
sound: #customizable sounds of the block
break:
name: BLOCK_WOOD_BREAK
volume: 1
pitch: 0.9
place:
name: BLOCK_WOOD_PLACE
volume: 1
pitch: 0.9
this property can have these value:
REAL_NOTE
- uses a real block (note_block), no lag, no entities, 100% real blocks.
- downsides:
- no support for transparency.
- max of 750 blocks in total.
REAL
- uses a real block (mushroom), no lag, no entities, 100% real blocks. (although it's advised to use
REAL_NOTE
which is more stable). - downsides:
- max of 191 blocks in total
REAL_TRANSPARENT
- uses a real block (chorus), no lag, no entities, 100% real blocks, also with transparency support!
- downsides:
- max of 63 blocks in total
REAL_WIRE
- uses a real block (tripwire), no lag, no entities, 100% real blocks.
- downsides:
- max of 127 blocks in total.
TILE
- uses tile blocks (modified spawner with custom skin). It's not an entity but it have some downsides. Good thing is that you can create infinite blocks, there is no amount limit like REAL blocks.
- downsides:
- not a 100% real block, it's a retextured spawner
- texture/model vanishes on high distance, so it will reveal the spawner vanilla texture
- it could cause clientside lag if A LOT of blocks are in the player field of view, but only on lowend PCs.
FIRE
- this is a special type of block, it's the fire block.
- downsides:
- only a max of 14 custom fires is possible, so be sure to create only the ones you need.
REAL
andREAL_NOTE
are meant to be used for decorative blocks and ores.TILE
blocks for trade machines and machinery/rare decorative blocks. You should not useTILE
blocks for ores because it may cause a bit of lag on chunk generation. They are not adviced to be used for populators or decorators.
This allows you to specify a rotation for a particular model. This is an option for expert users.
The specified rotation is STATIC, it's not dynamic. This is useful only if you want to create multiple variants of the same block without having to create a separate model manually.
This allows to make some blocks placeable directly on water surface.
This allows to make some blocks placeable directly on lava surface.
This allows to make some blocks placed 1 block up. This is useful for
REAL_WIRE
blocks to create tall plants.Available on ItemsAdder 3.2.5+
Special property which allows to specify custom variants for that block.
Accepts the same properties shown in the Minecraft wiki models page.
Example:
custom_variants:
variant1:
model: "minecraft:block/end_stone_bricks"
y: 90
variant2:
model: "minecraft:block/end_stone_bricks"
y: 180
x: 90
variant3:
model: "minecraft:block/diamond_block"
uvlock: true
variant4:
model: "minecraft:block/cobblestone"
Cancel drop when block is broken.
Useful if you have any mineral that will drop out of the block (loots), to avoid exploits.
If you use silk touch enchanted tool to break the block you will still get the block but it won't drop any item from its loot
You can set "_PICKAXE" so every pickaxe will match the list rule, also "_AXE" as the plugin checks if the material name contains the word you set in the rule.
It also works for custom items ids, so for example if you set "ruby_" every ruby tool will work (ruby_pickaxe, ruby_axe...)
Blacklist of tools that cannot break this block
Whitelist of tools that can break this block
Hardness of the block, it makes it more difficult to be mined.
Refer to my blocks to get some examples (check blocks.yml file inside itemsadder namespace).
Explosion resistance (by default is
hardness * 3
)Totally immune from explosions, ignoring
blast_resistance
You can change block break and place sounds. You can specify a custom sound name instead of a Minecraft sound.
You can specify both Spigot sounds or vanilla Minecraft sounds names.
If no place sound is specified it will play the default sound of the vanilla material you set in the resource attribute of this block.
There are 2 ways to drop experience from your custom blocks.
This has a downside, you can only set the experience drop to custom blocks, not to vanilla blocks.
ruby_block:
display_name: display-name-ruby_block
permission: ruby_block
resource:
material: PAPER
generate: true
textures:
- block/ruby_block.png
specific_properties:
block:
placed_model:
type: REAL_NOTE
break_particles_material: REDSTONE_BLOCK
break_tools_whitelist:
- PICKAXE
- pickaxe
events:
placed_block:
break:
drop_exp:
chance: 100
min_amount: 0
max_amount: 3
This is the best way because you can also apply this to vanilla blocks types and you can add as many as exp settings you want. This allows you to add more randomness and dynamicity to your drops.
loots:
blocks:
ruby_ore:
type: iasurvival:ruby_ore
items:
ruby:
item: iasurvival:ruby
min_amount: 1
max_amount: 2
chance: 100
exp:
exp_1:
min_amount: 0
max_amount: 3
chance: 100
Last modified 6mo ago