BlockDisplayCreator -----
Plugin for creating and fully customizing custom blocks from Display Entities using bdengineAbout BlockDisplayCreator
BlockDisplayCreator is a user-friendly plugin that allows you to create Custom Blocks with any display ( without using resource packs or mods), as well as support for interactions and collisions. The block display modeling is done via the BDEngine.
Display Entity is used for display, Interaction Entity is used for interaction, Shulkers is used for collisions.
Examples of some custom blocks
![[IMG]](//proxy.spigotmc.org/974450a366fdf3e149644275f190a53f883a1830/68747470733a2f2f6d656469612e67697068792e636f6d2f6d656469612f69305231384e443661643637626b704b36762f67697068792e676966)
Placing custom blocks
Full customization of the custom block is done in its own file,
It is possible to prohibit destruction/placement/interactions of blocks and
permissions for their destruction/placement/interactions.
Plugin works on versions 1.19.4 - Latest version
Creating a Custom Block
We will demonstrate how to create a custom block using a barrel as an example. Here's what the completed custom block looks like in the configuration file and in-game:
#To create a custom block you only need to have the display.spawn-command and item.material parameters filled in
#Display Entities of a given block.
display:
#Command to create entities for block display (models must be created on the https://block-display.com/bdengine). When creating a block, you must specify the command to display
spawn-command:
- /summon block_display ~-0.5 ~-0.5 ~-0.5 {Passengers:[{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000601733f,1.7320588474f,0.5312243317f,-1.1191f,-0.0000085105f,0.9999688777f,-0.9201562637f,0.375f,-0.9999914024f,0.0000808251f,0.0000443638f,1f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000241794f,1.7321268631f,-0.5313050334f,-0.5816f,-1e-10f,-1.0000550782f,-0.920232991f,1.5625f,-0.9999978017f,0.0000380747f,-0.0000093431f,1f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-1f,0f,0f,1f,0f,0.9999344907f,-0.9201720835f,0.375f,0f,-1.7320886278f,-0.5312151982f,2.1191f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-1f,0f,0f,1f,0f,-1.0000050776f,-0.9202370365f,1.5625f,0f,-1.732047876f,0.5313026977f,1.5816f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000601733f,-1.7320588474f,-0.5312243317f,2.1035f,0.0000085105f,0.9999688777f,-0.9201562637f,0.375f,0.9999914024f,0.0000808251f,0.0000443638f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000241794f,-1.7321268631f,0.5313050334f,1.566f,1e-10f,-1.0000550782f,-0.920232991f,1.5625f,0.9999978017f,0.0000380747f,-0.0000093431f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.7071038239f,1.2246710981f,0.3757035385f,-0.2848f,3.767e-7f,0.9999936961f,-0.9202251756f,0.3826f,-0.7071096842f,-1.2246604546f,-0.3757009031f,2.0026f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.707103747f,1.2246707216f,-0.3757038174f,0.0953f,-2e-10f,-0.9999936061f,-0.9202250927f,1.5701f,-0.7071096523f,-1.2246606106f,0.3757007876f,1.6225f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071031011f,1.2246726043f,0.3757038933f,-0.9919f,3.764e-7f,0.9999920534f,-0.9202257557f,0.3826f,-0.7071105033f,1.2246604925f,0.3756994164f,-0.3096f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071036746f,1.2246707215f,-0.3757043074f,-0.6118f,2e-10f,-0.9999947522f,-0.9202248441f,1.5701f,-0.7071098829f,1.2246599488f,-0.3757009906f,0.0705f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071031011f,-1.2246726043f,-0.3757038933f,1.3096f,-3.764e-7f,0.9999920534f,-0.9202257557f,0.3826f,0.7071105033f,1.2246604925f,0.3756994164f,-0.9919f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071036746f,-1.2246707215f,0.3757043074f,0.9295f,-2e-10f,-0.9999947522f,-0.9202248441f,1.5701f,0.7071098829f,1.2246599488f,-0.3757009906f,-0.6118f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325794424f,-0.6123720888f,0.5303334748f,0.5325f,0.3247612919f,0.4999919687f,3.429e-7f,0.3125f,-0.1325813604f,0.6123794408f,0.5303267353f,-0.0303f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325800794f,0.6123720659f,-0.5303327289f,0.5325f,0.3247610434f,0.4999929659f,-3.428e-7f,0.3125f,0.1325812084f,-0.6123785264f,-0.5303273933f,1.0303f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325800794f,0.6123720659f,0.5303327289f,0.0021f,0.3247610434f,0.4999929659f,3.428e-7f,0.3125f,-0.1325812084f,0.6123785264f,-0.5303273933f,0.5f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325794424f,-0.6123720888f,-0.5303334748f,1.0628f,0.3247612919f,0.4999919687f,-3.429e-7f,0.3125f,0.1325813604f,-0.6123794408f,0.5303267353f,0.5f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1f,0f,0f,0f,0f,0.999934491f,-0.9201720834f,0.375f,0f,1.7320886276f,0.5312151983f,-1.1f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1f,0f,0f,0f,0f,-1.0000050774f,-0.9202370366f,1.5625f,0f,1.7320478761f,-0.5313026976f,-0.5625f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071067812f,-5.3033008589f,0f,5.125f,0f,0f,-1.25f,1.125f,0.7071067812f,5.3033008589f,0f,-4.8125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0f,-7.9375f,0f,7.9375f,0f,0f,-1.25f,1.125f,1f,0f,0f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.7071038239f,-1.2246710981f,-0.3757035385f,2.0026f,-3.767e-7f,0.9999936961f,-0.9202251756f,0.3826f,0.7071096842f,-1.2246604546f,-0.3757009031f,1.2848f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.707103747f,-1.2246707216f,0.3757038174f,1.6225f,2e-10f,-0.9999936061f,-0.9202250927f,1.5701f,0.7071096523f,-1.2246606106f,0.3757007876f,0.9047f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.7071067812f,-5.524271728f,0f,6.0625f,0f,0f,-1.25f,1.1326f,0.7071067812f,-5.524271728f,0f,5.3125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1f,0f,0f,0f,0f,0f,-1.25f,1.125f,0f,7.9375f,0f,-6.9375f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1.4375f,0f,0f,-0.25f,0f,1f,0f,0f,0f,0f,1f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1.4375f,0f,0f,-0.25f,0f,1f,0f,-0.8125f,0f,0f,1f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1874933008f,-0.8660357177f,0f,0.875f,0.3247633941f,0.4999821354f,0f,0.3125f,0f,0f,0.75f,0.125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1874933007f,0.8660357178f,0f,0.125f,0.3247633942f,0.4999821351f,0f,0.3125f,0f,0f,-0.75f,0.875f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000204464f,-0.0000527727f,0.7499915797f,0.125f,0.3247561032f,0.5000045863f,-0.0000083339f,0.3125f,-0.1874975099f,0.8660162737f,0.0000589326f,0.125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000204464f,-0.0000527727f,-0.7499915797f,0.875f,0.3247561032f,0.5000045863f,0.0000083339f,0.3125f,0.1874975099f,-0.8660162737f,0.0000589326f,0.875f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1874932999f,-0.866035719f,0f,1.0625f,0.3247633946f,-0.4999821332f,0f,0.375f,0f,0f,0.75f,0.125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1874933007f,0.8660357178f,0f,-0.0625f,0.3247633942f,-0.4999821351f,0f,0.375f,0f,0f,-0.75f,0.875f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.0000072164f,-0.0000249963f,-0.7500036076f,0.875f,0.3247665189f,-0.4999321356f,-7e-10f,0.375f,-0.1874914961f,-0.8659574457f,0.0000180417f,1.0625f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.0000072164f,-0.0000249963f,0.7500036076f,0.125f,0.3247665189f,-0.4999321356f,7e-10f,0.375f,0.1874914961f,0.8659574457f,0.0000180417f,-0.0625f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325801169f,-0.6123717588f,0.5303329099f,0.6651f,0.3247609014f,-0.499993607f,0f,0.375f,0.1325815379f,0.6123782979f,0.5303272575f,-0.1629f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325800299f,0.6123721605f,-0.5303326999f,0.3999f,0.3247610079f,-0.4999929113f,0f,0.375f,-0.1325813279f,-0.6123782979f,-0.5303273233f,1.1629f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325801169f,-0.6123717588f,-0.5303329099f,1.1954f,0.3247609014f,-0.499993607f,0f,0.375f,-0.1325815379f,-0.6123782979f,0.5303272575f,0.6326f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325800299f,0.6123721605f,0.5303326999f,-0.1304f,0.3247610079f,-0.4999929113f,0f,0.375f,0.1325813279f,0.6123782979f,-0.5303273233f,0.3674f,0f,0f,0f,1f]}]}
#Center material that will be filled depending on where the block is installed. By def BARRIER
central-material: BARRIER
#Count of sides of the block. Can be set in the range from 1 to 360. By def 4
sides-count: 96
#Sounds of this block (list of sound-types can be found at https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html). Volume and pitch are set to 1 by default
sound:
#Break sound
break:
#Sound type. By def ITEM_LODESTONE_COMPASS_LOCK
sound-type: BLOCK_WOOD_BREAK
volume: 2.5
pitch: 0.6
#Place sound
place:
#Sound type. By def BLOCK_LODESTONE_PLACE
sound-type: BLOCK_BARREL_OPEN
volume: 1.7
pitch: 3
#Item of this block. Only material is a required field
item:
#Item material
material: PLAYER_HEAD
#Item name. By def the block name is selected
name: "&x&A&2&8&0&1&3R&x&9&C&7&B&1&2e&x&9&5&7&5&1&1a&x&8&F&7&0&1&0l&x&8&9&6&B&0&Fi&x&8&2&6&6&0&Es&x&7&C&6&0&0&Dt&x&7&6&5&B&0&Ci&x&6&F&5&6&0&Ac &x&6&3&4&B&0&8b&x&5&C&4&6&0&7a&x&5&6&4&1&0&6r&x&5&0&3&C&0&5r&x&4&9&3&6&0&4e&x&4&3&3&1&0&3l"
#Item enchantments, created as <enchantment name>: <level>.
enchantments:
LURE: 1
#item-flags of the item.
item-flags:
- HIDE_ENCHANTS
#Item lore
lore:
- "&9Barrel with a secret"
skullmeta:
url: http://textures.minecraft.net/texture/c67d5d37cd64ce3fb57377d25d6152aa4ac2e37954248d5d91f88fbd791f4766
#Interaction Entities of a given block. The field may be missing, then all parameters are given by default
interactions:
#Interactions name
interaction:
#Interaction Entity height.
height: 1.1
#Interaction Entity width.
width: 1.001
#Offset of this interaction entity relative to the central location of the custom block. Supports rotation-dependent offset changes
offset:
x: 0
y: 0
z: 0
#Command or commands that are called when the player interacts (right-clicks) with the Interaction Entity of this block. By def absent
command:
- /minecraft:playsound minecraft:ambient.cave player @s
#Command source (PLAYER who clicked on the interaction entity or CONSOLE). By def CONSOLE
command-source: PLAYER
#Temporary permissions that are granted before executing commands and are removed after executing (those that were missing)
granted-command-permission:
- minecraft.command.playsound
#Collision entities. Describes the collision entity parameters for this block.
collisions:
#Collision name
main:
#Size of the collision entity. **Works only on Minecraft 1.20.5 and above**, since the scale attribute used to set collision size was introduced in 1.20.5.
size: 0.8
#Offset of this collision entity relative to the central location of the custom block. Supports rotation-dependent offset changes.
offset:
x: 0
y: 0.01
z: 0
#If true, the collision entity will not be spawned on versions below 1.20.5 (before the scale attribute for collision size was added). By def false.
disable-below-1_20_5: true
Don't be overwhelmed by the number of available parameters.
To create a working custom block, only display.spawn-command and item.material are required.
Here’s a minimal example that you can copy and use as a template for your own blocks:
To create a Custom Block, navigate to the custom-blocks folder located in the plugin's main directory and create a file with the .yml extension, using a name that represents the block's name.
That's all, now you can get your block using the command /bdc custom-block give <custom block name>
Display Entities can be of any size, which allows you to create huge models. You can find a catalog of models on the block-display website
WorldGuard integration
The plugin has flags to control access to Custom Blocks in regions:
Commands
/cb <custom block name> <recipient> <count> – Gives a custom block to a player
/bdc custom-block give <custom block name> <recipient> <count> – Gives a custom block to a player
NOTE: Due to limitations of the used command library, in version 1.19.4 only the /bdc custom-block give command is available, on other versions all commands are available
/bdc custom-block place <block> <location> [attached-face] [direction] [options...] – Places a custom block at a specific location
/bdc reload <custom block name> – Reloads only a specific custom block
/bdc erasecbdata <x1> <y1> <z1> <x2> <y2> <z2> – Removes all Interaction Entities, Display Entities and Shulkers in the selected area and also clears the custom block data in each location of the selected area. Be careful with this command, it can be useful in rare cases where an error occurs while placing a custom block, or if a certain custom block has been removed from the file directory.
/bdc custom-block editfile <parameters...> – Edits custom block configuration files directly in-game
Permissions
blockdisplaycreator.blocks-destruction – Permission to destroy custom blocks, only needed if blocks-destruction is set to false.
blockdisplaycreator.blocks-placement – Permission to place custom blocks, only needed if blocks-placement is set to false.
blockdisplaycreator.blocks-interaction – Permission to interact (right-click) with custom blocks, only needed if blocks-interaction is set to false.
bdc.bypass.* – Grants full bypass for all plugin restrictions.
bdc.bypass.wg – Unrestricted access to Custom Blocks regardless of WorldGuard flags (default for admins).
bdc.bypass.skyblock – Unrestricted access to Custom Blocks on SuperiorSkyblock2 islands.
bdc.quickselect.creative – Allows using Quick Select feature in Creative mode.
Command permissions
bdc.command.* – Grants access to all BlockDisplayCreator commands.
bdc.command.reload – Permission to use /bdc reload.
bdc.command.erasecbdata – Permission to use /bdc erasecbdata.
bdc.command.custom-block.* – Grants access to all /bdc custom-block subcommands.
bdc.command.custom-block.give – Use /bdc custom-block give.
bdc.command.custom-block.place – Use /bdc custom-block place.
bdc.command.custom-block.break – Use /bdc custom-block break.
bdc.command.custom-block.editfile – Use /bdc custom-block editfile.
Prohibition of block destruction/placement/interaction
The config will have the following fields:
#If set to false, players without blockdisplaycreator.blocks-destruction permission are prohibited from destroying custom blocks. By def true
blocks-destruction: true
#If set to false, players without blockdisplaycreator.blocks-placement permission are prohibited from placing custom blocks. By def true
blocks-placement: true
#If set to false, players without blockdisplaycreator.blocks-interaction permission are prohibited from interacting with custom blocks. By def true
blocks-interaction: true
Placeholders:
The plugin provides a set of placeholders related to custom block data and interaction entities, which can be used within interaction command
Tags shared by all entities:
`custom-block`
`custom-block-name: *block name*`
`custom-block-location: *x,y,z*`
Display-specific tags:
`custom-block-display`
Interaction-specific tags:
`custom-block-interaction`
`custom-block-interaction-id: *interaction ID*`
Collision-specific tags:
`custom-block-collision`
`custom-block-collision-id: *collision ID*`
Plugin API
The plugin has events for tracking interactions with blocks
CustomBlockBreakEvent - Called when a custom block is destroyed
CustomBlockPlaceEvent - Called when a custom block is placed
CustomBlockInteractEvent - Called when interacting (right-clicking) with a custom block
Here is an archive containing several pre-made block files that you can download and try out!
If you find any bugs or have any questions, you can write to me on my discord: general_breddok
Send your ideas for blocks and leave feedback!
BlockDisplayCreator is a user-friendly plugin that allows you to create Custom Blocks with any display ( without using resource packs or mods), as well as support for interactions and collisions. The block display modeling is done via the BDEngine.
Display Entity is used for display, Interaction Entity is used for interaction, Shulkers is used for collisions.
Examples of some custom blocks
Placing custom blocks
Full customization of the custom block is done in its own file,
It is possible to prohibit destruction/placement/interactions of blocks and
permissions for their destruction/placement/interactions.
Plugin works on versions 1.19.4 - Latest version
Creating a Custom Block
We will demonstrate how to create a custom block using a barrel as an example. Here's what the completed custom block looks like in the configuration file and in-game:
Code (Text):
#To create a custom block you only need to have the display.spawn-command and item.material parameters filled in
#Display Entities of a given block.
display:
#Command to create entities for block display (models must be created on the https://block-display.com/bdengine). When creating a block, you must specify the command to display
spawn-command:
- /summon block_display ~-0.5 ~-0.5 ~-0.5 {Passengers:[{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000601733f,1.7320588474f,0.5312243317f,-1.1191f,-0.0000085105f,0.9999688777f,-0.9201562637f,0.375f,-0.9999914024f,0.0000808251f,0.0000443638f,1f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000241794f,1.7321268631f,-0.5313050334f,-0.5816f,-1e-10f,-1.0000550782f,-0.920232991f,1.5625f,-0.9999978017f,0.0000380747f,-0.0000093431f,1f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-1f,0f,0f,1f,0f,0.9999344907f,-0.9201720835f,0.375f,0f,-1.7320886278f,-0.5312151982f,2.1191f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-1f,0f,0f,1f,0f,-1.0000050776f,-0.9202370365f,1.5625f,0f,-1.732047876f,0.5313026977f,1.5816f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000601733f,-1.7320588474f,-0.5312243317f,2.1035f,0.0000085105f,0.9999688777f,-0.9201562637f,0.375f,0.9999914024f,0.0000808251f,0.0000443638f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000241794f,-1.7321268631f,0.5313050334f,1.566f,1e-10f,-1.0000550782f,-0.920232991f,1.5625f,0.9999978017f,0.0000380747f,-0.0000093431f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.7071038239f,1.2246710981f,0.3757035385f,-0.2848f,3.767e-7f,0.9999936961f,-0.9202251756f,0.3826f,-0.7071096842f,-1.2246604546f,-0.3757009031f,2.0026f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.707103747f,1.2246707216f,-0.3757038174f,0.0953f,-2e-10f,-0.9999936061f,-0.9202250927f,1.5701f,-0.7071096523f,-1.2246606106f,0.3757007876f,1.6225f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071031011f,1.2246726043f,0.3757038933f,-0.9919f,3.764e-7f,0.9999920534f,-0.9202257557f,0.3826f,-0.7071105033f,1.2246604925f,0.3756994164f,-0.3096f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071036746f,1.2246707215f,-0.3757043074f,-0.6118f,2e-10f,-0.9999947522f,-0.9202248441f,1.5701f,-0.7071098829f,1.2246599488f,-0.3757009906f,0.0705f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071031011f,-1.2246726043f,-0.3757038933f,1.3096f,-3.764e-7f,0.9999920534f,-0.9202257557f,0.3826f,0.7071105033f,1.2246604925f,0.3756994164f,-0.9919f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071036746f,-1.2246707215f,0.3757043074f,0.9295f,-2e-10f,-0.9999947522f,-0.9202248441f,1.5701f,0.7071098829f,1.2246599488f,-0.3757009906f,-0.6118f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325794424f,-0.6123720888f,0.5303334748f,0.5325f,0.3247612919f,0.4999919687f,3.429e-7f,0.3125f,-0.1325813604f,0.6123794408f,0.5303267353f,-0.0303f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325800794f,0.6123720659f,-0.5303327289f,0.5325f,0.3247610434f,0.4999929659f,-3.428e-7f,0.3125f,0.1325812084f,-0.6123785264f,-0.5303273933f,1.0303f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325800794f,0.6123720659f,0.5303327289f,0.0021f,0.3247610434f,0.4999929659f,3.428e-7f,0.3125f,-0.1325812084f,0.6123785264f,-0.5303273933f,0.5f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325794424f,-0.6123720888f,-0.5303334748f,1.0628f,0.3247612919f,0.4999919687f,-3.429e-7f,0.3125f,0.1325813604f,-0.6123794408f,0.5303267353f,0.5f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1f,0f,0f,0f,0f,0.999934491f,-0.9201720834f,0.375f,0f,1.7320886276f,0.5312151983f,-1.1f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1f,0f,0f,0f,0f,-1.0000050774f,-0.9202370366f,1.5625f,0f,1.7320478761f,-0.5313026976f,-0.5625f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.7071067812f,-5.3033008589f,0f,5.125f,0f,0f,-1.25f,1.125f,0.7071067812f,5.3033008589f,0f,-4.8125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0f,-7.9375f,0f,7.9375f,0f,0f,-1.25f,1.125f,1f,0f,0f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.7071038239f,-1.2246710981f,-0.3757035385f,2.0026f,-3.767e-7f,0.9999936961f,-0.9202251756f,0.3826f,0.7071096842f,-1.2246604546f,-0.3757009031f,1.2848f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.707103747f,-1.2246707216f,0.3757038174f,1.6225f,2e-10f,-0.9999936061f,-0.9202250927f,1.5701f,0.7071096523f,-1.2246606106f,0.3757007876f,0.9047f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.7071067812f,-5.524271728f,0f,6.0625f,0f,0f,-1.25f,1.1326f,0.7071067812f,-5.524271728f,0f,5.3125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1f,0f,0f,0f,0f,0f,-1.25f,1.125f,0f,7.9375f,0f,-6.9375f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1.4375f,0f,0f,-0.25f,0f,1f,0f,0f,0f,0f,1f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[1.4375f,0f,0f,-0.25f,0f,1f,0f,-0.8125f,0f,0f,1f,0f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1874933008f,-0.8660357177f,0f,0.875f,0.3247633941f,0.4999821354f,0f,0.3125f,0f,0f,0.75f,0.125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1874933007f,0.8660357178f,0f,0.125f,0.3247633942f,0.4999821351f,0f,0.3125f,0f,0f,-0.75f,0.875f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000204464f,-0.0000527727f,0.7499915797f,0.125f,0.3247561032f,0.5000045863f,-0.0000083339f,0.3125f,-0.1874975099f,0.8660162737f,0.0000589326f,0.125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.0000204464f,-0.0000527727f,-0.7499915797f,0.875f,0.3247561032f,0.5000045863f,0.0000083339f,0.3125f,0.1874975099f,-0.8660162737f,0.0000589326f,0.875f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1874932999f,-0.866035719f,0f,1.0625f,0.3247633946f,-0.4999821332f,0f,0.375f,0f,0f,0.75f,0.125f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1874933007f,0.8660357178f,0f,-0.0625f,0.3247633942f,-0.4999821351f,0f,0.375f,0f,0f,-0.75f,0.875f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.0000072164f,-0.0000249963f,-0.7500036076f,0.875f,0.3247665189f,-0.4999321356f,-7e-10f,0.375f,-0.1874914961f,-0.8659574457f,0.0000180417f,1.0625f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.0000072164f,-0.0000249963f,0.7500036076f,0.125f,0.3247665189f,-0.4999321356f,7e-10f,0.375f,0.1874914961f,0.8659574457f,0.0000180417f,-0.0625f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325801169f,-0.6123717588f,0.5303329099f,0.6651f,0.3247609014f,-0.499993607f,0f,0.375f,0.1325815379f,0.6123782979f,0.5303272575f,-0.1629f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325800299f,0.6123721605f,-0.5303326999f,0.3999f,0.3247610079f,-0.4999929113f,0f,0.375f,-0.1325813279f,-0.6123782979f,-0.5303273233f,1.1629f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[-0.1325801169f,-0.6123717588f,-0.5303329099f,1.1954f,0.3247609014f,-0.499993607f,0f,0.375f,-0.1325815379f,-0.6123782979f,0.5303272575f,0.6326f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:polished_blackstone_button",Properties:{face:"ceiling",facing:"east",powered:"false"}},transformation:[0.1325800299f,0.6123721605f,0.5303326999f,-0.1304f,0.3247610079f,-0.4999929113f,0f,0.375f,0.1325813279f,0.6123782979f,-0.5303273233f,0.3674f,0f,0f,0f,1f]}]}
#Center material that will be filled depending on where the block is installed. By def BARRIER
central-material: BARRIER
#Count of sides of the block. Can be set in the range from 1 to 360. By def 4
sides-count: 96
#Sounds of this block (list of sound-types can be found at https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html). Volume and pitch are set to 1 by default
sound:
#Break sound
break:
#Sound type. By def ITEM_LODESTONE_COMPASS_LOCK
sound-type: BLOCK_WOOD_BREAK
volume: 2.5
pitch: 0.6
#Place sound
place:
#Sound type. By def BLOCK_LODESTONE_PLACE
sound-type: BLOCK_BARREL_OPEN
volume: 1.7
pitch: 3
#Item of this block. Only material is a required field
item:
#Item material
material: PLAYER_HEAD
#Item name. By def the block name is selected
name: "&x&A&2&8&0&1&3R&x&9&C&7&B&1&2e&x&9&5&7&5&1&1a&x&8&F&7&0&1&0l&x&8&9&6&B&0&Fi&x&8&2&6&6&0&Es&x&7&C&6&0&0&Dt&x&7&6&5&B&0&Ci&x&6&F&5&6&0&Ac &x&6&3&4&B&0&8b&x&5&C&4&6&0&7a&x&5&6&4&1&0&6r&x&5&0&3&C&0&5r&x&4&9&3&6&0&4e&x&4&3&3&1&0&3l"
#Item enchantments, created as <enchantment name>: <level>.
enchantments:
LURE: 1
#item-flags of the item.
item-flags:
- HIDE_ENCHANTS
#Item lore
lore:
- "&9Barrel with a secret"
skullmeta:
url: http://textures.minecraft.net/texture/c67d5d37cd64ce3fb57377d25d6152aa4ac2e37954248d5d91f88fbd791f4766
#Interaction Entities of a given block. The field may be missing, then all parameters are given by default
interactions:
#Interactions name
interaction:
#Interaction Entity height.
height: 1.1
#Interaction Entity width.
width: 1.001
#Offset of this interaction entity relative to the central location of the custom block. Supports rotation-dependent offset changes
offset:
x: 0
y: 0
z: 0
#Command or commands that are called when the player interacts (right-clicks) with the Interaction Entity of this block. By def absent
command:
- /minecraft:playsound minecraft:ambient.cave player @s
#Command source (PLAYER who clicked on the interaction entity or CONSOLE). By def CONSOLE
command-source: PLAYER
#Temporary permissions that are granted before executing commands and are removed after executing (those that were missing)
granted-command-permission:
- minecraft.command.playsound
#Collision entities. Describes the collision entity parameters for this block.
collisions:
#Collision name
main:
#Size of the collision entity. **Works only on Minecraft 1.20.5 and above**, since the scale attribute used to set collision size was introduced in 1.20.5.
size: 0.8
#Offset of this collision entity relative to the central location of the custom block. Supports rotation-dependent offset changes.
offset:
x: 0
y: 0.01
z: 0
#If true, the collision entity will not be spawned on versions below 1.20.5 (before the scale attribute for collision size was added). By def false.
disable-below-1_20_5: true
Don't be overwhelmed by the number of available parameters.
To create a working custom block, only display.spawn-command and item.material are required.
Here’s a minimal example that you can copy and use as a template for your own blocks:
Code (Text):
display:
spawn-command:
- /summon block_display ~-0.5 ~-0.5 ~-0.5 {Passengers:[{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_fence",Properties:{}},transformation:[0.9849713623f,-0.172387051f,0.0106827019f,0.0985f,0.1699099536f,0.9782111383f,0.1193045538f,-0.1885f,-0.0310164982f,-0.1156964715f,0.9928002333f,0.0816f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:wheat",Properties:{age:"7"}},transformation:[-0.9849713669f,0.1723870248f,0.0106827019f,0.8356f,-0.1699099278f,-0.9782111439f,0.1193045445f,1.3876f,0.0310164935f,0.1156964632f,0.9928002345f,-0.1156f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:hay_block",Properties:{axis:"y"}},transformation:[0.9849713623f,-0.172387051f,0.0106827019f,-0.0524f,0.1699099536f,0.9782111383f,0.1193045538f,0.6675f,-0.0310164982f,-0.1156964715f,0.9928002333f,-0.0196f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_fence",Properties:{}},transformation:[-0.1723882178f,-0.9849711378f,0.0106858245f,0.1108f,0.9782087565f,-0.1699101459f,0.1193239193f,0.8216f,-0.1157149853f,0.0310230032f,0.9927978725f,-0.0398f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_fence",Properties:{}},transformation:[-0.1723882178f,-0.9849711378f,0.0106858245f,1.7113f,0.9782087565f,-0.1699101459f,0.1193239193f,1.0977f,-0.1157149853f,0.0310230032f,0.9927978725f,-0.0902f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:carved_pumpkin",Properties:{facing:"north"}},transformation:[0.9067784484f,-0.4098715028f,-0.0987835829f,-0.1519f,0.417333344f,0.8393225004f,0.3483828635f,1.1898f,-0.0598809244f,-0.3571317554f,0.9321325999f,-0.1296f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.711493673f,0.7026925768f,0.000031732f,0.3877f,-0.4899167757f,0.496020465f,0.7168998779f,-0.2572f,0.503744391f,-0.5100853111f,0.6971762148f,-0.1143f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.0406936697f,0.6144924104f,0.7878704558f,0.0634f,-0.9312463774f,0.3090926377f,-0.1929756123f,0.4752f,-0.3621062858f,-0.7258501773f,0.5848240354f,0.2403f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.358070988f,0.8742221514f,-0.3279007943f,0.2817f,-0.7155816326f,0.0313565044f,-0.6978229575f,0.6334f,-0.5997718133f,0.4845096314f,0.6368069825f,0.5208f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.3506188325f,0.9041967191f,-0.2439155981f,0.6149f,-0.9312590075f,0.309053622f,-0.1929834629f,0.4752f,-0.0991119908f,0.294812227f,0.9504012684f,0.2403f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[-0.8989097752f,0.3214565773f,-0.2977026738f,1.1074f,-0.3432401366f,-0.0943853046f,0.934493243f,-0.4122f,0.2723002418f,0.9422086189f,0.1951806742f,0.3838f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:yellow_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833099048f,-0.7051741338f,-0.1889920976f,1.3659f,-0.0000057704f,0.2588159725f,-0.9659202794f,2.6851f,0.7301287838f,0.6599582078f,0.1768649618f,-0.4868f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.7682f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.551f,0.7301221846f,0.1768692797f,-0.6599634281f,0.1582f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.6828f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.551f,0.7301221846f,0.1768692797f,-0.6599634281f,0.0669f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.5946f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.5833f,0.7301221846f,0.1768692797f,-0.6599634281f,0.1494f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.6801f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.5833f,0.7301221846f,0.1768692797f,-0.6599634281f,0.2407f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,1.1239f,0f,0f,-1f,2.5533f,0.7301201151f,0.6833188257f,0f,-0.0892f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,1.0385f,0f,0f,-1f,2.5533f,0.7301201151f,0.6833188257f,0f,-0.1804f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,0.9531f,0f,0f,-1f,2.5533f,0.7301201151f,0.6833188257f,0f,-0.2717f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,0.9958f,0f,0f,-1f,2.4283f,0.7301201151f,0.6833188257f,0f,-0.2261f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,1.0812f,0f,0f,-1f,2.4283f,0.7301201151f,0.6833188257f,0f,-0.1348f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833118552f,0.6322947993f,0.3650864746f,0.3968f,-0.000010619f,-0.500022991f,0.8660119617f,1.7408f,0.7301265966f,-0.5917600905f,-0.3416648772f,0.5058f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833118552f,0.6322947993f,0.3650864746f,0.3113f,-0.000010619f,-0.500022991f,0.8660119617f,1.7408f,0.7301265966f,-0.5917600905f,-0.3416648772f,0.4145f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:white_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.1890427035f,0.1281177211f,0.7051771996f,0.8207f,0.9659087592f,-0.0000053873f,-0.2588637185f,1.941f,-0.1768785253f,0.136902245f,-0.6599398548f,0.521f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:white_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.1890912788f,-0.1281207059f,-0.7051367528f,1.7012f,0.9658928389f,0.0000151432f,0.2588827806f,1.6868f,-0.1768656788f,-0.1368967702f,0.6599666576f,0.0736f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:yellow_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,0f,-0.7301201151f,1.2667f,0f,1f,0f,1.6783f,0.7301201151f,0f,0.6833188257f,-0.394f,0f,0f,0f,1f]}]}
item:
material: HAY_BLOCK
spawn-command:
- /summon block_display ~-0.5 ~-0.5 ~-0.5 {Passengers:[{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_fence",Properties:{}},transformation:[0.9849713623f,-0.172387051f,0.0106827019f,0.0985f,0.1699099536f,0.9782111383f,0.1193045538f,-0.1885f,-0.0310164982f,-0.1156964715f,0.9928002333f,0.0816f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:wheat",Properties:{age:"7"}},transformation:[-0.9849713669f,0.1723870248f,0.0106827019f,0.8356f,-0.1699099278f,-0.9782111439f,0.1193045445f,1.3876f,0.0310164935f,0.1156964632f,0.9928002345f,-0.1156f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:hay_block",Properties:{axis:"y"}},transformation:[0.9849713623f,-0.172387051f,0.0106827019f,-0.0524f,0.1699099536f,0.9782111383f,0.1193045538f,0.6675f,-0.0310164982f,-0.1156964715f,0.9928002333f,-0.0196f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_fence",Properties:{}},transformation:[-0.1723882178f,-0.9849711378f,0.0106858245f,0.1108f,0.9782087565f,-0.1699101459f,0.1193239193f,0.8216f,-0.1157149853f,0.0310230032f,0.9927978725f,-0.0398f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:spruce_fence",Properties:{}},transformation:[-0.1723882178f,-0.9849711378f,0.0106858245f,1.7113f,0.9782087565f,-0.1699101459f,0.1193239193f,1.0977f,-0.1157149853f,0.0310230032f,0.9927978725f,-0.0902f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:carved_pumpkin",Properties:{facing:"north"}},transformation:[0.9067784484f,-0.4098715028f,-0.0987835829f,-0.1519f,0.417333344f,0.8393225004f,0.3483828635f,1.1898f,-0.0598809244f,-0.3571317554f,0.9321325999f,-0.1296f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.711493673f,0.7026925768f,0.000031732f,0.3877f,-0.4899167757f,0.496020465f,0.7168998779f,-0.2572f,0.503744391f,-0.5100853111f,0.6971762148f,-0.1143f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.0406936697f,0.6144924104f,0.7878704558f,0.0634f,-0.9312463774f,0.3090926377f,-0.1929756123f,0.4752f,-0.3621062858f,-0.7258501773f,0.5848240354f,0.2403f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.358070988f,0.8742221514f,-0.3279007943f,0.2817f,-0.7155816326f,0.0313565044f,-0.6978229575f,0.6334f,-0.5997718133f,0.4845096314f,0.6368069825f,0.5208f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[0.3506188325f,0.9041967191f,-0.2439155981f,0.6149f,-0.9312590075f,0.309053622f,-0.1929834629f,0.4752f,-0.0991119908f,0.294812227f,0.9504012684f,0.2403f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:stone_button",Properties:{face:"floor",facing:"east",powered:"false"}},transformation:[-0.8989097752f,0.3214565773f,-0.2977026738f,1.1074f,-0.3432401366f,-0.0943853046f,0.934493243f,-0.4122f,0.2723002418f,0.9422086189f,0.1951806742f,0.3838f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:yellow_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833099048f,-0.7051741338f,-0.1889920976f,1.3659f,-0.0000057704f,0.2588159725f,-0.9659202794f,2.6851f,0.7301287838f,0.6599582078f,0.1768649618f,-0.4868f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.7682f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.551f,0.7301221846f,0.1768692797f,-0.6599634281f,0.1582f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.6828f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.551f,0.7301221846f,0.1768692797f,-0.6599634281f,0.0669f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.5946f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.5833f,0.7301221846f,0.1768692797f,-0.6599634281f,0.1494f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833166139f,-0.1889945565f,0.7051666435f,0.6801f,-0.00000718f,-0.9659183771f,-0.2588209512f,2.5833f,0.7301221846f,0.1768692797f,-0.6599634281f,0.2407f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,1.1239f,0f,0f,-1f,2.5533f,0.7301201151f,0.6833188257f,0f,-0.0892f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,1.0385f,0f,0f,-1f,2.5533f,0.7301201151f,0.6833188257f,0f,-0.1804f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,0.9531f,0f,0f,-1f,2.5533f,0.7301201151f,0.6833188257f,0f,-0.2717f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,0.9958f,0f,0f,-1f,2.4283f,0.7301201151f,0.6833188257f,0f,-0.2261f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,-0.7301201151f,0f,1.0812f,0f,0f,-1f,2.4283f,0.7301201151f,0.6833188257f,0f,-0.1348f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833118552f,0.6322947993f,0.3650864746f,0.3968f,-0.000010619f,-0.500022991f,0.8660119617f,1.7408f,0.7301265966f,-0.5917600905f,-0.3416648772f,0.5058f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:black_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833118552f,0.6322947993f,0.3650864746f,0.3113f,-0.000010619f,-0.500022991f,0.8660119617f,1.7408f,0.7301265966f,-0.5917600905f,-0.3416648772f,0.4145f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:white_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.1890427035f,0.1281177211f,0.7051771996f,0.8207f,0.9659087592f,-0.0000053873f,-0.2588637185f,1.941f,-0.1768785253f,0.136902245f,-0.6599398548f,0.521f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:white_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.1890912788f,-0.1281207059f,-0.7051367528f,1.7012f,0.9658928389f,0.0000151432f,0.2588827806f,1.6868f,-0.1768656788f,-0.1368967702f,0.6599666576f,0.0736f,0f,0f,0f,1f]},{id:"minecraft:block_display",block_state:{Name:"minecraft:yellow_candle",Properties:{candles:"1",lit:"false"}},transformation:[0.6833188257f,0f,-0.7301201151f,1.2667f,0f,1f,0f,1.6783f,0.7301201151f,0f,0.6833188257f,-0.394f,0f,0f,0f,1f]}]}
item:
material: HAY_BLOCK
To create a Custom Block, navigate to the custom-blocks folder located in the plugin's main directory and create a file with the .yml extension, using a name that represents the block's name.
display:
Represents the Display Entities of a given block
spawn-command:
Command to create a block display model.
This parameter can be specified as a /summon command, as a BDEngine model identifier, or as an animation creation function.
To create a model you must:
1. Go to the website BDEngine and create a model using various Display Entities. The origin of the virtual scene will represent the center of your block where the entities will be displayed. The front side will be indicated when increasing along the Z-axis.
2. Click Export to Minecraft and copy the commands to summon entities (or the BDEngine model ID, or the animation creation function.)
3. Paste the copied command into spawn-command
You can also paste multiple commands if needed
glowing:
Setting the Display Entities glow
glow-color-override:
The glow color of the Entities Display in named format (e.g., RED, BLUE), decimal ABGR (e.g., 234543), or hexadecimal (e.g., 3134F5, c8c4c2).
view-range:
View range of these Display Entities
billboard:
Billboard of these Display Entities
shadow-radius:
Shadow radius for Displays
shadow-strength:
Controls the opacity of shadows based on the distance to the block below.
translation with parameters x, y, z, yaw, pitch:
Control the displacement of the Display to the specified coordinates. Unlike offset, this transformation does not take the block's rotation into account.
Example:
spawn-command-1_19_4 and spawn-command-1_20-1_20_4 are special parameters used to define display spawn commands that will only be executed on specific Minecraft versions — 1.19.4 and 1.20–1.20.4 respectively. These parameters are primarily intended for models using custom player heads, as their rendering behavior may vary between versions. By configuring version-specific commands, you can ensure that your custom blocks display correctly and consistently across different Minecraft versions.
Represents the Display Entities of a given block
spawn-command:
Command to create a block display model.
This parameter can be specified as a /summon command, as a BDEngine model identifier, or as an animation creation function.
To create a model you must:
1. Go to the website BDEngine and create a model using various Display Entities. The origin of the virtual scene will represent the center of your block where the entities will be displayed. The front side will be indicated when increasing along the Z-axis.
2. Click Export to Minecraft and copy the commands to summon entities (or the BDEngine model ID, or the animation creation function.)
3. Paste the copied command into spawn-command
You can also paste multiple commands if needed
glowing:
Setting the Display Entities glow
glow-color-override:
The glow color of the Entities Display in named format (e.g., RED, BLUE), decimal ABGR (e.g., 234543), or hexadecimal (e.g., 3134F5, c8c4c2).
view-range:
View range of these Display Entities
billboard:
Billboard of these Display Entities
shadow-radius:
Shadow radius for Displays
shadow-strength:
Controls the opacity of shadows based on the distance to the block below.
translation with parameters x, y, z, yaw, pitch:
Control the displacement of the Display to the specified coordinates. Unlike offset, this transformation does not take the block's rotation into account.
Example:
Code (Text):
display:
translation:
yaw: 180
pitch: -45
x: 1
y: 0.4
z: -9.12
translation:
yaw: 180
pitch: -45
x: 1
y: 0.4
z: -9.12
spawn-command-1_19_4 and spawn-command-1_20-1_20_4 are special parameters used to define display spawn commands that will only be executed on specific Minecraft versions — 1.19.4 and 1.20–1.20.4 respectively. These parameters are primarily intended for models using custom player heads, as their rendering behavior may vary between versions. By configuring version-specific commands, you can ensure that your custom blocks display correctly and consistently across different Minecraft versions.
sides-count:
Count of sides of the block. Can be set in the range from 1 to 360.
![[IMG]](//proxy.spigotmc.org/a4f964de7fa18731593d2597229c2e08596f8b8c/68747470733a2f2f6d65646961342e67697068792e636f6d2f6d656469612f76312e59326c6b505463354d4749334e6a4578643267335a7a67325a3368705932356d656a5274626d6f335a58686965576b32616e646f616d673363586468646a5268656e426f65695a6c634431324d563970626e526c636d35686246396e61575a66596e6c666157516d593351395a772f3042795647436d5174686b745a69766b51722f67697068792e676966)
Custom block with sides-count of 16.
Count of sides of the block. Can be set in the range from 1 to 360.
Custom block with sides-count of 16.
central-material:
The center material for the block you installed, default is BARRIER
For example, if you want your block to glow, simply set the center material to LIGHT.
The center material for the block you installed, default is BARRIER
For example, if you want your block to glow, simply set the center material to LIGHT.
item:
Represents your block's item
material: Required field, represents the material of your item
name: The name of your item, defaults to the block name (you can use gradient)
You can also set lore, item-flags, enchantments
Represents your block's item
material: Required field, represents the material of your item
name: The name of your item, defaults to the block name (you can use gradient)
You can also set lore, item-flags, enchantments
You can also set the texture for items with the PLAYER_HEAD material. To do this you need:
1. To go to the minecraft-heads website and select a head.
2. Copy the Minecraft URL or the base64 Value.
3. Add skullmeta.url selection to the item and paste the URL into this field
Example:
item:
material: player_head
name: "&rOld TV"
skullmeta:
url: http://textures.minecraft.net/texture/f2ce11a259d5417f4143a8233de3064dedcc88729e471d179cde32b969693639
You can also give the head a texture by name using
skullmeta.name
1. To go to the minecraft-heads website and select a head.
2. Copy the Minecraft URL or the base64 Value.
3. Add skullmeta.url selection to the item and paste the URL into this field
Example:
Code (Text):
item:
material: player_head
name: "&rOld TV"
skullmeta:
url: http://textures.minecraft.net/texture/f2ce11a259d5417f4143a8233de3064dedcc88729e471d179cde32b969693639
interactions:
These are Interaction Entities to interact with a block
![[IMG]](https://www.spigotmc.org/attachments/newinteractionsformatexample-png.882006/)
Interactions are highlighted in blue.
To create a new interaction, you must add a subsection under interactions and assign it a name. WARNING! Be cautious: if you rename an Interaction linked to a command, it may disrupt the functionality of existing Custom Blocks, as their commands are stored in association with the Interaction name.
height:
Interaction Entity Height, default 1.001
width:
Interaction Entity Width, default 1.001
command:
The command or commands that is called when the player interacts (right-clicks) with the Interaction Entity of this block, default absent
command-source:
command source (PLAYER who clicked on the interaction entity or CONSOLE), default CONSOLE
cooldown:
Adjusts the cooldown (in ticks) between sending commands on click, default 0
granted-command-permission:
Adjusts the temporary permissions that are granted before executing commands and are removed after executing (those that were missing)
offset with parameters x, y, z:
Specifies the positional offset applied to the interaction after it spawns. The offset is adjusted according to the block’s rotation and updates dynamically with it.
These are Interaction Entities to interact with a block
Interactions are highlighted in blue.
To create a new interaction, you must add a subsection under interactions and assign it a name. WARNING! Be cautious: if you rename an Interaction linked to a command, it may disrupt the functionality of existing Custom Blocks, as their commands are stored in association with the Interaction name.
height:
Interaction Entity Height, default 1.001
width:
Interaction Entity Width, default 1.001
command:
The command or commands that is called when the player interacts (right-clicks) with the Interaction Entity of this block, default absent
command-source:
command source (PLAYER who clicked on the interaction entity or CONSOLE), default CONSOLE
cooldown:
Adjusts the cooldown (in ticks) between sending commands on click, default 0
granted-command-permission:
Adjusts the temporary permissions that are granted before executing commands and are removed after executing (those that were missing)
offset with parameters x, y, z:
Specifies the positional offset applied to the interaction after it spawns. The offset is adjusted according to the block’s rotation and updates dynamically with it.
These are entities based on shulkers that can be used to add physical solidity to your custom block.
![[IMG]](//proxy.spigotmc.org/150a70d0bce9981f5e255fc70dfef90a0502d1d6/68747470733a2f2f6d656469612e67697068792e636f6d2f6d656469612f65723363714a324265436d775051526634692f67697068792e676966)
Collisions are highlighted in red.
To create a new collision, you must add a subsection under collisions and assign it a name. Important note: due to Minecraft limitations, the shulker head cannot be made invisible on versions prior to 1.21.2 without resource packs, which may be visually distracting.
size:
Defines the three-dimensional diameter of the collision. This parameter relies on the entity size attribute and is therefore only supported in Minecraft versions 1.20.5 and above.
offset with parameters x, y, z:
Define the displacement applied to the Interaction Entity after spawning. Adjust according to the block’s rotation and change dynamically with it.
disable-below-1_20_5: boolean flag that disables the collision for Minecraft versions below 1.20.5. This is essential to avoid incorrect collision sizes on older versions where the size parameter is not supported. Default value is false .
invisible: boolean parameter that determines whether the collision entity is visible or not. This can be useful during configuration and debugging of the collision’s size and offset. Default value is true
color: Sets the color of the collision when it is visible. Accepts one of the 16 predefined dye colors. A full list of available values can be found here.
Collisions are highlighted in red.
To create a new collision, you must add a subsection under collisions and assign it a name. Important note: due to Minecraft limitations, the shulker head cannot be made invisible on versions prior to 1.21.2 without resource packs, which may be visually distracting.
size:
Defines the three-dimensional diameter of the collision. This parameter relies on the entity size attribute and is therefore only supported in Minecraft versions 1.20.5 and above.
offset with parameters x, y, z:
Define the displacement applied to the Interaction Entity after spawning. Adjust according to the block’s rotation and change dynamically with it.
disable-below-1_20_5: boolean flag that disables the collision for Minecraft versions below 1.20.5. This is essential to avoid incorrect collision sizes on older versions where the size parameter is not supported. Default value is false .
invisible: boolean parameter that determines whether the collision entity is visible or not. This can be useful during configuration and debugging of the collision’s size and offset. Default value is true
color: Sets the color of the collision when it is visible. Accepts one of the 16 predefined dye colors. A full list of available values can be found here.
Configures the sound played when a custom block is placed (
place) or broken (
break).
Each sound type includes the following settings:
sound-type:
The type of sound to play. A full list of available sound types can be found in the Spigot documentation
volume:
Volume of the sound.
pitch:
Pitch of the sound.
Example:
Each sound type includes the following settings:
sound-type:
The type of sound to play. A full list of available sound types can be found in the Spigot documentation
volume:
Volume of the sound.
pitch:
Pitch of the sound.
Example:
Code (Text):
sound:
break:
sound-type: BLOCK_IRON_HIT
volume: 2
pitch: 0.5
place:
sound-type: ENTITY_ZOMBIE_INFECT
volume: 1.5
pitch: 3
break:
sound-type: BLOCK_IRON_HIT
volume: 2
pitch: 0.5
place:
sound-type: ENTITY_ZOMBIE_INFECT
volume: 1.5
pitch: 3
This section defines which permissions a player must have to interact with a custom block. You can specify separate permission lists for the following actions:
Permission example:
If a permission list is omitted for a certain action, the plugin will not restrict that action.
- place — placing the block
- break — breaking the block
- interact — interacting with the block (right-click)
Permission example:
Code (Text):
permission:
place:
- "yourplugin.block.place"
break:
- "yourplugin.block.break"
interact:
- "yourplugin.block.interact"
place:
- "yourplugin.block.place"
break:
- "yourplugin.block.break"
interact:
- "yourplugin.block.interact"
Special settings for block placement and breaking.
Placement options
You can configure how and where a block may be placed using the parameter:
stage-settings.place.placement-mode
Available modes:
- default — place on any face (top, bottom, sides).
- vertical_only — only top/bottom faces; side faces are blocked.
- horizontal_only — only side faces; top/bottom are blocked.
- vertical_with_horizontal — side placements behave as vertical.
- horizontal_with_vertical — vertical placements behave as horizontal.
Example:
![[IMG]](//proxy.spigotmc.org/3677d63ca75e1632fe5dcf7f153edd6a9a5cbe3c/68747470733a2f2f6d65646961312e67697068792e636f6d2f6d656469612f76312e59326c6b505463354d4749334e6a457865574a6c616e5230617a4271597a5268626e6335617a4d775a4731344d6a6b775a47646a4e3342704d3255305a7a51795a6d6b774d695a6c634431324d563970626e526c636d35686246396e61575a66596e6c666157516d593351395a772f6144736e6c6c796741467032306a6b6a6f582f67697068792e676966)
Breaking options
You can configure how a block drops when broken using:
stage-settings.break.drop-mode
Available modes:
- on_ground — default; item drops at the block location.
- inventory — item goes directly into the player's inventory (if full, drops at the player’s feet).
Example:
![[IMG]](//proxy.spigotmc.org/5a595a7041ba96fbab3b6a688fa8487bcdf558d1/68747470733a2f2f6d65646961322e67697068792e636f6d2f6d656469612f76312e59326c6b505463354d4749334e6a457862444e35626e6b35636e4a6f596e5a355a3349344d44563164575177656a5670597a5a74597a526e627a5133645841316158683165435a6c634431324d563970626e526c636d35686246396e61575a66596e6c666157516d593351395a772f765563464254484f683943434b69576d6c662f67697068792e676966)
Commands
You can set place (executed AFTER the block is placed) and break (executed BEFORE destruction) commands.
They work the same way as in interactions, except without cooldowns.
Placement options
You can configure how and where a block may be placed using the parameter:
stage-settings.place.placement-mode
Available modes:
- default — place on any face (top, bottom, sides).
- vertical_only — only top/bottom faces; side faces are blocked.
- horizontal_only — only side faces; top/bottom are blocked.
- vertical_with_horizontal — side placements behave as vertical.
- horizontal_with_vertical — vertical placements behave as horizontal.
Example:
Code (YAML):
stage-settings:
place:
placement-mode : vertical_with_horizontal
place:
placement-mode : vertical_with_horizontal
Breaking options
You can configure how a block drops when broken using:
stage-settings.break.drop-mode
Available modes:
- on_ground — default; item drops at the block location.
- inventory — item goes directly into the player's inventory (if full, drops at the player’s feet).
Example:
Code (YAML):
stage-settings:
break:
drop-mode : inventory
break:
drop-mode : inventory
Commands
You can set place (executed AFTER the block is placed) and break (executed BEFORE destruction) commands.
They work the same way as in interactions, except without cooldowns.
That's all, now you can get your block using the command /bdc custom-block give <custom block name>
Display Entities can be of any size, which allows you to create huge models. You can find a catalog of models on the block-display website
WorldGuard integration
The plugin has flags to control access to Custom Blocks in regions:
- place-cb – Controls the right to place a custom block in a region
- break-cb – Controls the right to break a custom block in a region
- interact-cb – Controls the right to interact with custom block in a region (Don't forget about the interact flag!)
Commands
/cb <custom block name> <recipient> <count> – Gives a custom block to a player
/bdc custom-block give <custom block name> <recipient> <count> – Gives a custom block to a player
NOTE: Due to limitations of the used command library, in version 1.19.4 only the /bdc custom-block give command is available, on other versions all commands are available
/bdc custom-block place <block> <location> [attached-face] [direction] [options...] – Places a custom block at a specific location
- <block> – Custom block name
- <location> – Placement location (x,y,z or look-at)
- [attached-face] – Attachment face (north, south, east, west, up, down)
- [direction] – Block rotation in degrees (0–360), relevant only for up/down faces
- [options] – Optional flags: replace_custom_block, load_chunk, break_solid_material, silent_place
- <location> – Target location (x,y,z or look-at)
- [options] – Optional flags: drop_item, silent_break
/bdc reload <custom block name> – Reloads only a specific custom block
/bdc erasecbdata <x1> <y1> <z1> <x2> <y2> <z2> – Removes all Interaction Entities, Display Entities and Shulkers in the selected area and also clears the custom block data in each location of the selected area. Be careful with this command, it can be useful in rare cases where an error occurs while placing a custom block, or if a certain custom block has been removed from the file directory.
/bdc custom-block editfile <parameters...> – Edits custom block configuration files directly in-game
Code (Text):
General:
/bdc custom-block editfile <block> central-material <material>
/bdc custom-block editfile <block> sides-count <1–360>
/bdc custom-block editfile <block> save-system {yaml-file|item}
Display settings:
/bdc custom-block editfile <block> display spawn-command <command|model-id>
/bdc custom-block editfile <block> display spawn-command-1_19_4 <command|model-id>
/bdc custom-block editfile <block> display spawn-command-1_20-1_20_4 <command|model-id>
/bdc custom-block editfile <block> display billboard <billboard-type>
/bdc custom-block editfile <block> display brightness block <value>
/bdc custom-block editfile <block> display brightness sky <value>
/bdc custom-block editfile <block> display glow-color-override <named-color|decimal-ABGR|hexadecimal>
/bdc custom-block editfile <block> display glowing <true|false>
/bdc custom-block editfile <block> display shadow-radius <value>
/bdc custom-block editfile <block> display shadow-strength <value>
/bdc custom-block editfile <block> display view-range <value>
/bdc custom-block editfile <block> display translation {x|y|z|yaw|pitch} <value>
/bdc custom-block editfile <block> display use-placeholder <true|false>
Item settings:
/bdc custom-block editfile <block> item material <item-material>
/bdc custom-block editfile <block> item name <name...>
/bdc custom-block editfile <block> item lore <lore lines separated by ">
/bdc custom-block editfile <block> item enchantments <enchantment:level...>
/bdc custom-block editfile <block> item item-flags <flags...>
/bdc custom-block editfile <block> item skullmeta url <skin-url>
/bdc custom-block editfile <block> item skullmeta name <skin-owner-name>
Interaction settings:
/bdc custom-block editfile <block> interactions <interaction-name> command <command>
/bdc custom-block editfile <block> interactions <interaction-name> command-source <console|player>
/bdc custom-block editfile <block> interactions <interaction-name> granted-command-permission <permissions...>
/bdc custom-block editfile <block> interactions <interaction-name> height <value>
/bdc custom-block editfile <block> interactions <interaction-name> width <value>
/bdc custom-block editfile <block> interactions <interaction-name> offset {x|y|z} <value>
Collision settings:
/bdc custom-block editfile <block> collisions <collision-name> size <value>
/bdc custom-block editfile <block> collisions <collision-name> offset {x|y|z} <value>
/bdc custom-block editfile <block> collisions <collision-name> disable-below-1_20_5 <true|false>
/bdc custom-block editfile <block> collisions <collision-name> invisible <true|false>
/bdc custom-block editfile <block> collisions <collision-name> color <color-name>
Sound settings:
/bdc custom-block editfile <block> sound <break|place> sound-type <sound-name>
/bdc custom-block editfile <block> sound <break|place> volume <value>
/bdc custom-block editfile <block> sound <break|place> pitch <value>
Stage settings:
/bdc custom-block editfile <block> stage-settings <break|place> command <command>
/bdc custom-block editfile <block> stage-settings <break|place> command-source <console|player>
/bdc custom-block editfile <block> stage-settings <break|place> granted-command-permission <permissions...>
/bdc custom-block editfile <block> stage-settings <place> placement-mode <mode>
/bdc custom-block editfile <block> stage-settings <break> drop-mode <mode>
/bdc custom-block editfile <block> central-material <material>
/bdc custom-block editfile <block> sides-count <1–360>
/bdc custom-block editfile <block> save-system {yaml-file|item}
Display settings:
/bdc custom-block editfile <block> display spawn-command <command|model-id>
/bdc custom-block editfile <block> display spawn-command-1_19_4 <command|model-id>
/bdc custom-block editfile <block> display spawn-command-1_20-1_20_4 <command|model-id>
/bdc custom-block editfile <block> display billboard <billboard-type>
/bdc custom-block editfile <block> display brightness block <value>
/bdc custom-block editfile <block> display brightness sky <value>
/bdc custom-block editfile <block> display glow-color-override <named-color|decimal-ABGR|hexadecimal>
/bdc custom-block editfile <block> display glowing <true|false>
/bdc custom-block editfile <block> display shadow-radius <value>
/bdc custom-block editfile <block> display shadow-strength <value>
/bdc custom-block editfile <block> display view-range <value>
/bdc custom-block editfile <block> display translation {x|y|z|yaw|pitch} <value>
/bdc custom-block editfile <block> display use-placeholder <true|false>
Item settings:
/bdc custom-block editfile <block> item material <item-material>
/bdc custom-block editfile <block> item name <name...>
/bdc custom-block editfile <block> item lore <lore lines separated by ">
/bdc custom-block editfile <block> item enchantments <enchantment:level...>
/bdc custom-block editfile <block> item item-flags <flags...>
/bdc custom-block editfile <block> item skullmeta url <skin-url>
/bdc custom-block editfile <block> item skullmeta name <skin-owner-name>
Interaction settings:
/bdc custom-block editfile <block> interactions <interaction-name> command <command>
/bdc custom-block editfile <block> interactions <interaction-name> command-source <console|player>
/bdc custom-block editfile <block> interactions <interaction-name> granted-command-permission <permissions...>
/bdc custom-block editfile <block> interactions <interaction-name> height <value>
/bdc custom-block editfile <block> interactions <interaction-name> width <value>
/bdc custom-block editfile <block> interactions <interaction-name> offset {x|y|z} <value>
Collision settings:
/bdc custom-block editfile <block> collisions <collision-name> size <value>
/bdc custom-block editfile <block> collisions <collision-name> offset {x|y|z} <value>
/bdc custom-block editfile <block> collisions <collision-name> disable-below-1_20_5 <true|false>
/bdc custom-block editfile <block> collisions <collision-name> invisible <true|false>
/bdc custom-block editfile <block> collisions <collision-name> color <color-name>
Sound settings:
/bdc custom-block editfile <block> sound <break|place> sound-type <sound-name>
/bdc custom-block editfile <block> sound <break|place> volume <value>
/bdc custom-block editfile <block> sound <break|place> pitch <value>
Stage settings:
/bdc custom-block editfile <block> stage-settings <break|place> command <command>
/bdc custom-block editfile <block> stage-settings <break|place> command-source <console|player>
/bdc custom-block editfile <block> stage-settings <break|place> granted-command-permission <permissions...>
/bdc custom-block editfile <block> stage-settings <place> placement-mode <mode>
/bdc custom-block editfile <block> stage-settings <break> drop-mode <mode>
Permissions
blockdisplaycreator.blocks-destruction – Permission to destroy custom blocks, only needed if blocks-destruction is set to false.
blockdisplaycreator.blocks-placement – Permission to place custom blocks, only needed if blocks-placement is set to false.
blockdisplaycreator.blocks-interaction – Permission to interact (right-click) with custom blocks, only needed if blocks-interaction is set to false.
bdc.bypass.* – Grants full bypass for all plugin restrictions.
bdc.bypass.wg – Unrestricted access to Custom Blocks regardless of WorldGuard flags (default for admins).
bdc.bypass.skyblock – Unrestricted access to Custom Blocks on SuperiorSkyblock2 islands.
bdc.quickselect.creative – Allows using Quick Select feature in Creative mode.
Command permissions
bdc.command.* – Grants access to all BlockDisplayCreator commands.
bdc.command.reload – Permission to use /bdc reload.
bdc.command.erasecbdata – Permission to use /bdc erasecbdata.
bdc.command.custom-block.* – Grants access to all /bdc custom-block subcommands.
bdc.command.custom-block.give – Use /bdc custom-block give.
bdc.command.custom-block.place – Use /bdc custom-block place.
bdc.command.custom-block.break – Use /bdc custom-block break.
bdc.command.custom-block.editfile – Use /bdc custom-block editfile.
Prohibition of block destruction/placement/interaction
The config will have the following fields:
Code (Text):
#If set to false, players without blockdisplaycreator.blocks-destruction permission are prohibited from destroying custom blocks. By def true
blocks-destruction: true
#If set to false, players without blockdisplaycreator.blocks-placement permission are prohibited from placing custom blocks. By def true
blocks-placement: true
#If set to false, players without blockdisplaycreator.blocks-interaction permission are prohibited from interacting with custom blocks. By def true
blocks-interaction: true
Placeholders:
The plugin provides a set of placeholders related to custom block data and interaction entities, which can be used within interaction command
- %customblock_name% — Inserts the name of the block
- %customblock_x% — Inserts the X coordinate of the block
- %customblock_y% — Inserts the Y coordinate of the block
- %customblock_z% — Inserts the Z coordinate of the block
- %interaction_x% — Inserts the X coordinate of the interaction entity
- %interaction_y% — Inserts the Y coordinate of the interaction entity
- %interaction_z% — Inserts the Z coordinate of the interaction entity
Tags shared by all entities:
`custom-block`
`custom-block-name: *block name*`
`custom-block-location: *x,y,z*`
Display-specific tags:
`custom-block-display`
Interaction-specific tags:
`custom-block-interaction`
`custom-block-interaction-id: *interaction ID*`
Collision-specific tags:
`custom-block-collision`
`custom-block-collision-id: *collision ID*`
Plugin API
The plugin has events for tracking interactions with blocks
CustomBlockBreakEvent - Called when a custom block is destroyed
CustomBlockPlaceEvent - Called when a custom block is placed
CustomBlockInteractEvent - Called when interacting (right-clicking) with a custom block
Here is an archive containing several pre-made block files that you can download and try out!
If you find any bugs or have any questions, you can write to me on my discord: general_breddok
Send your ideas for blocks and leave feedback!
Resource Information
Author:
----------
Total Downloads:
1,253
First Release:
Feb 2, 2024
Last Update:
Aug 6, 2025
Category:
---------------
All-Time Rating:
8 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings