Blocks

1
specific_properties:
2
  block:
3
    placed_model:
4
      type: REAL_NOTE
5
      break_particles: BLOCK
6
      rotx: 0
7
      roty: 0
8
    cancel_drop: true #default is false. if true the custom block won't be dropped when
9
                      #player mines it
10
    light_level: 12 #make block emit light
11
    #tools you can't use to break block(accepts partial name of material/customitem)
12
    break_tools_blacklist:
13
    - WOODEN_PICKAXE
14
    - STONE_PICKAXE
15
    - IRON_PICKAXE
16
    #tools you can use to break block(accepts partial name of material/customitem)
17
    break_tools_whitelist:
18
    - DIAMOND_PICKAXE
19
    - PICKAXE
20
    - pickaxe
21
    hardness: 2 #hardness of the block
22
    blast_resistance: 1 #explosion resistance (by default is hardness*3)
23
    no_explosion: false #totally immune from explosions, ignoring blast_resistance
24
    sound: #customizable sounds of the block
25
      break:
26
        name: BLOCK_WOOD_BREAK
27
        volume: 1
28
        pitch: 0.9
29
      place:
30
        name: BLOCK_WOOD_PLACE
31
        volume: 1
32
        pitch: 0.9
Copied!
placed_model 
type
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.
It's better to use REAL and REAL_NOTE blocks for decorative blocks/ores and use TILE blocks for trade machines and machinery/rare decorative blocks.
You should not use TILE blocks for ores because it COULD cause a bit of lag on chunk generation.
rotx and roty
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.
placeable_on_water
This allows to make some blocks placeable directly on water surface.
placeable_on_lava
This allows to make some blocks placeable directly on lava surface.
shift_up
This allows to make some blocks placed 1 block up. This is useful for REAL_WIRE blocks to create tall plants.
cancel_drop
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 
Tools blacklist and whitelist
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...)
break_tools_blacklist
Blacklist of tools that cannot break this block
break_tools_whitelist
Whitelist of tools that can break this block
events_tools_blacklist
Blacklist of tools that cannot run events on this block (placed_block.interact)​
events_tools_whitelist
Whitelist of tools that cannot run events on this block (placed_block.interact)​
Other options
hardness
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).
blast_resistance
Explosion resistance (by default is hardness * 3)
no_explosion
Totally immune from explosions, ignoring blast_resistance
sounds
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 break sound is specified it will play  BLOCK_STONE_BREAK  (block.stone.break)
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.