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), 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
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 analyze the creation of a custom block using the example of barrel
This is what the finished custom block will look like in the file and in the 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.5565381278f,-0.0000085105f,0.9999688777f,-0.9201562637f,0.3751854127f,-0.9999914024f,0.0000808251f,0.0000443638f,0.4921875f,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.0190381278f,-1e-10f,-1.0000550782f,-0.920232991f,1.5626854127f,-0.9999978017f,0.0000380747f,-0.0000093431f,0.4921875f,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,0.5625618722f,0f,0.9999344907f,-0.9201720835f,0.3751854127f,0f,-1.7320886278f,-0.5312151982f,1.6112875f,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,0.5625618722f,0f,-1.0000050776f,-0.9202370365f,1.5626854127f,0f,-1.732047876f,0.5313026977f,1.0737875f,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,1.6660618722f,0.0000085105f,0.9999688777f,-0.9201562637f,0.3751854127f,0.9999914024f,0.0000808251f,0.0000443638f,-0.5078125f,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.1285618722f,1e-10f,-1.0000550782f,-0.920232991f,1.5626854127f,0.9999978017f,0.0000380747f,-0.0000093431f,-0.5078125f,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.7222381278f,3.767e-7f,0.9999936961f,-0.9202251756f,0.3827854127f,-0.7071096842f,-1.2246604546f,-0.3757009031f,1.4947875f,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.3421381278f,-2e-10f,-0.9999936061f,-0.9202250927f,1.5702854127f,-0.7071096523f,-1.2246606106f,0.3757007876f,1.1146875f,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.4293381278f,3.764e-7f,0.9999920534f,-0.9202257557f,0.3827854127f,-0.7071105033f,1.2246604925f,0.3756994164f,-0.8174125f,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,-1.0492381278f,2e-10f,-0.9999947522f,-0.9202248441f,1.5702854127f,-0.7071098829f,1.2246599488f,-0.3757009906f,-0.4373125f,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.8721618722f,-3.764e-7f,0.9999920534f,-0.9202257557f,0.3827854127f,0.7071105033f,1.2246604925f,0.3756994164f,-1.4997125f,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.4920618722f,-2e-10f,-0.9999947522f,-0.9202248441f,1.5702854127f,0.7071098829f,1.2246599488f,-0.3757009906f,-1.1196125f,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.0950618722f,0.3247612919f,0.4999919687f,3.429e-7f,0.3126854127f,-0.1325813604f,0.6123794408f,0.5303267353f,-0.5381125f,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.0950618722f,0.3247610434f,0.4999929659f,-3.428e-7f,0.3126854127f,0.1325812084f,-0.6123785264f,-0.5303273933f,0.5224875f,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.4353381278f,0.3247610434f,0.4999929659f,3.428e-7f,0.3126854127f,-0.1325812084f,0.6123785264f,-0.5303273933f,-0.0078125f,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.6253618722f,0.3247612919f,0.4999919687f,-3.429e-7f,0.3126854127f,0.1325813604f,-0.6123794408f,0.5303267353f,-0.0078125f,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,-0.4374381278f,0f,0.999934491f,-0.9201720834f,0.3751854127f,0f,1.7320886276f,0.5312151983f,-1.6078125f,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,-0.4374381278f,0f,-1.0000050774f,-0.9202370366f,1.5626854127f,0f,1.7320478761f,-0.5313026976f,-1.0703125f,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,4.6875618722f,0f,0f,-1.25f,1.1251854127f,0.7071067812f,5.3033008589f,0f,-5.3203125f,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.5000618722f,0f,0f,-1.25f,1.1251854127f,1f,0f,0f,-0.5078125f,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,1.5651618722f,-3.767e-7f,0.9999936961f,-0.9202251756f,0.3827854127f,0.7071096842f,-1.2246604546f,-0.3757009031f,0.7769875f,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.1850618722f,2e-10f,-0.9999936061f,-0.9202250927f,1.5702854127f,0.7071096523f,-1.2246606106f,0.3757007876f,0.3968875f,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,5.6250618722f,0f,0f,-1.25f,1.1327854127f,0.7071067812f,-5.524271728f,0f,4.8046875f,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,-0.4374381278f,0f,0f,-1.25f,1.1251854127f,0f,7.9375f,0f,-7.4453125f,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.6874381278f,0f,1f,0f,0.0001854127f,0f,0f,1f,-0.5078125f,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.6874381278f,0f,1f,0f,-0.8123145873f,0f,0f,1f,-0.5078125f,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.4375618722f,0.3247633941f,0.4999821354f,0f,0.3126854127f,0f,0f,0.75f,-0.3828125f,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.3124381278f,0.3247633942f,0.4999821351f,0f,0.3126854127f,0f,0f,-0.75f,0.3671875f,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.3124381278f,0.3247561032f,0.5000045863f,-0.0000083339f,0.3126854127f,-0.1874975099f,0.8660162737f,0.0000589326f,-0.3828125f,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.4375618722f,0.3247561032f,0.5000045863f,0.0000083339f,0.3126854127f,0.1874975099f,-0.8660162737f,0.0000589326f,0.3671875f,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,0.6250618722f,0.3247633946f,-0.4999821332f,0f,0.3751854127f,0f,0f,0.75f,-0.3828125f,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.4999381278f,0.3247633942f,-0.4999821351f,0f,0.3751854127f,0f,0f,-0.75f,0.3671875f,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.4375618722f,0.3247665189f,-0.4999321356f,-7e-10f,0.3751854127f,-0.1874914961f,-0.8659574457f,0.0000180417f,0.5546875f,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.3124381278f,0.3247665189f,-0.4999321356f,7e-10f,0.3751854127f,0.1874914961f,0.8659574457f,0.0000180417f,-0.5703125f,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.2276618722f,0.3247609014f,-0.499993607f,0f,0.3751854127f,0.1325815379f,0.6123782979f,0.5303272575f,-0.6707125f,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.0375381278f,0.3247610079f,-0.4999929113f,0f,0.3751854127f,-0.1325813279f,-0.6123782979f,-0.5303273233f,0.6550875f,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.7579618722f,0.3247609014f,-0.499993607f,0f,0.3751854127f,-0.1325815379f,-0.6123782979f,0.5303272575f,0.1247875f,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.5678381278f,0.3247610079f,-0.4999929113f,0f,0.3751854127f,0.1325813279f,0.6123782979f,-0.5303273233f,-0.1404125f,0f,0f,0f,1f]}]}
#On/off the glow of display entities
glowing: false
#Glow color of displayed entities in decimal format ABGR, nominal-color, or hex-color
glow-color-override: 3134F5
#Billboard used for all displays of the custom block
billboard: fixed
#Brightness used for all displays of the custom block
brightness:
block: 13
sky: 7
#Shadow radius used for all displays of the custom block
shadow-radius: 0
#Shadow strength used for all displays of the custom block
shadow-strength: 0
#View range used for all displays of the custom block
view-range: 1.1
#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. By def 0
height: 1.1
#Interaction Entity width. By def 0
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 on 1.20.5+ only.
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
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>
Displayed objects 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
/bdc custom-block give <custom block name> <recipient> <count> - Returns a block by name
/bdc reload - Reloads the config
/bdc reload <custom block name> - Reloads a specific block
/bdc killcbentities <x1> <y1> <z1> <x2> <y2> <z2> - Kills the Display Entity and Interaction Entity in the selected area, needed to clear the world of unused block entities, if, for example, you accidentally deleted one in the config some custom block
/bdc custom-block editfile <parameters...> - Configures custom block files directly through in-game commands.
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.wg - Permission allowing unrestricted access to Custom Blocks regardless of region flags. By default, this permission is granted to administrators.
bdc.command.custom-block - Permission to use /bdc custom-block command
bdc.command.reload - Permission to use /bdc reload command
bdc.command.killcbentities - Permission to use /bdc killcbentities command
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
Scoreboard Tags
For convenient integration with datapacks, the plugin uses various scoreboard tags. Some tags serve as markers to identify entities related to custom blocks, while others store dynamic block data such as location (e.g., custom-block-location:9.12,65,904.0).
In addition, each block-related entity has its own specific tags. The full list includes:
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), 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
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 analyze the creation of a custom block using the example of barrel
This is what the finished custom block will look like in the file and in the 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.5565381278f,-0.0000085105f,0.9999688777f,-0.9201562637f,0.3751854127f,-0.9999914024f,0.0000808251f,0.0000443638f,0.4921875f,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.0190381278f,-1e-10f,-1.0000550782f,-0.920232991f,1.5626854127f,-0.9999978017f,0.0000380747f,-0.0000093431f,0.4921875f,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,0.5625618722f,0f,0.9999344907f,-0.9201720835f,0.3751854127f,0f,-1.7320886278f,-0.5312151982f,1.6112875f,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,0.5625618722f,0f,-1.0000050776f,-0.9202370365f,1.5626854127f,0f,-1.732047876f,0.5313026977f,1.0737875f,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,1.6660618722f,0.0000085105f,0.9999688777f,-0.9201562637f,0.3751854127f,0.9999914024f,0.0000808251f,0.0000443638f,-0.5078125f,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.1285618722f,1e-10f,-1.0000550782f,-0.920232991f,1.5626854127f,0.9999978017f,0.0000380747f,-0.0000093431f,-0.5078125f,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.7222381278f,3.767e-7f,0.9999936961f,-0.9202251756f,0.3827854127f,-0.7071096842f,-1.2246604546f,-0.3757009031f,1.4947875f,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.3421381278f,-2e-10f,-0.9999936061f,-0.9202250927f,1.5702854127f,-0.7071096523f,-1.2246606106f,0.3757007876f,1.1146875f,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.4293381278f,3.764e-7f,0.9999920534f,-0.9202257557f,0.3827854127f,-0.7071105033f,1.2246604925f,0.3756994164f,-0.8174125f,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,-1.0492381278f,2e-10f,-0.9999947522f,-0.9202248441f,1.5702854127f,-0.7071098829f,1.2246599488f,-0.3757009906f,-0.4373125f,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.8721618722f,-3.764e-7f,0.9999920534f,-0.9202257557f,0.3827854127f,0.7071105033f,1.2246604925f,0.3756994164f,-1.4997125f,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.4920618722f,-2e-10f,-0.9999947522f,-0.9202248441f,1.5702854127f,0.7071098829f,1.2246599488f,-0.3757009906f,-1.1196125f,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.0950618722f,0.3247612919f,0.4999919687f,3.429e-7f,0.3126854127f,-0.1325813604f,0.6123794408f,0.5303267353f,-0.5381125f,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.0950618722f,0.3247610434f,0.4999929659f,-3.428e-7f,0.3126854127f,0.1325812084f,-0.6123785264f,-0.5303273933f,0.5224875f,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.4353381278f,0.3247610434f,0.4999929659f,3.428e-7f,0.3126854127f,-0.1325812084f,0.6123785264f,-0.5303273933f,-0.0078125f,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.6253618722f,0.3247612919f,0.4999919687f,-3.429e-7f,0.3126854127f,0.1325813604f,-0.6123794408f,0.5303267353f,-0.0078125f,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,-0.4374381278f,0f,0.999934491f,-0.9201720834f,0.3751854127f,0f,1.7320886276f,0.5312151983f,-1.6078125f,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,-0.4374381278f,0f,-1.0000050774f,-0.9202370366f,1.5626854127f,0f,1.7320478761f,-0.5313026976f,-1.0703125f,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,4.6875618722f,0f,0f,-1.25f,1.1251854127f,0.7071067812f,5.3033008589f,0f,-5.3203125f,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.5000618722f,0f,0f,-1.25f,1.1251854127f,1f,0f,0f,-0.5078125f,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,1.5651618722f,-3.767e-7f,0.9999936961f,-0.9202251756f,0.3827854127f,0.7071096842f,-1.2246604546f,-0.3757009031f,0.7769875f,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.1850618722f,2e-10f,-0.9999936061f,-0.9202250927f,1.5702854127f,0.7071096523f,-1.2246606106f,0.3757007876f,0.3968875f,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,5.6250618722f,0f,0f,-1.25f,1.1327854127f,0.7071067812f,-5.524271728f,0f,4.8046875f,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,-0.4374381278f,0f,0f,-1.25f,1.1251854127f,0f,7.9375f,0f,-7.4453125f,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.6874381278f,0f,1f,0f,0.0001854127f,0f,0f,1f,-0.5078125f,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.6874381278f,0f,1f,0f,-0.8123145873f,0f,0f,1f,-0.5078125f,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.4375618722f,0.3247633941f,0.4999821354f,0f,0.3126854127f,0f,0f,0.75f,-0.3828125f,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.3124381278f,0.3247633942f,0.4999821351f,0f,0.3126854127f,0f,0f,-0.75f,0.3671875f,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.3124381278f,0.3247561032f,0.5000045863f,-0.0000083339f,0.3126854127f,-0.1874975099f,0.8660162737f,0.0000589326f,-0.3828125f,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.4375618722f,0.3247561032f,0.5000045863f,0.0000083339f,0.3126854127f,0.1874975099f,-0.8660162737f,0.0000589326f,0.3671875f,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,0.6250618722f,0.3247633946f,-0.4999821332f,0f,0.3751854127f,0f,0f,0.75f,-0.3828125f,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.4999381278f,0.3247633942f,-0.4999821351f,0f,0.3751854127f,0f,0f,-0.75f,0.3671875f,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.4375618722f,0.3247665189f,-0.4999321356f,-7e-10f,0.3751854127f,-0.1874914961f,-0.8659574457f,0.0000180417f,0.5546875f,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.3124381278f,0.3247665189f,-0.4999321356f,7e-10f,0.3751854127f,0.1874914961f,0.8659574457f,0.0000180417f,-0.5703125f,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.2276618722f,0.3247609014f,-0.499993607f,0f,0.3751854127f,0.1325815379f,0.6123782979f,0.5303272575f,-0.6707125f,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.0375381278f,0.3247610079f,-0.4999929113f,0f,0.3751854127f,-0.1325813279f,-0.6123782979f,-0.5303273233f,0.6550875f,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.7579618722f,0.3247609014f,-0.499993607f,0f,0.3751854127f,-0.1325815379f,-0.6123782979f,0.5303272575f,0.1247875f,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.5678381278f,0.3247610079f,-0.4999929113f,0f,0.3751854127f,0.1325813279f,0.6123782979f,-0.5303273233f,-0.1404125f,0f,0f,0f,1f]}]}
#On/off the glow of display entities
glowing: false
#Glow color of displayed entities in decimal format ABGR, nominal-color, or hex-color
glow-color-override: 3134F5
#Billboard used for all displays of the custom block
billboard: fixed
#Brightness used for all displays of the custom block
brightness:
block: 13
sky: 7
#Shadow radius used for all displays of the custom block
shadow-radius: 0
#Shadow strength used for all displays of the custom block
shadow-strength: 0
#View range used for all displays of the custom block
view-range: 1.1
#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. By def 0
height: 1.1
#Interaction Entity width. By def 0
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 on 1.20.5+ only.
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
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:
The view range of these Display Entities
billboard:
Controls whether Display entities should face the player during rendering. It can be set to fixed (both vertical and horizontal angles remain static), vertical (orients toward the player around the vertical axis), horizontal (rotates around the horizontal axis), or center (rotates around the central point). The default setting is fixed.
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:
Control the displacement of the Display to the specified coordinates. Unlike offset, this transformation does not take the block's rotation into account.
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:
The view range of these Display Entities
billboard:
Controls whether Display entities should face the player during rendering. It can be set to fixed (both vertical and horizontal angles remain static), vertical (orients toward the player around the vertical axis), horizontal (rotates around the horizontal axis), or center (rotates around the central point). The default setting is fixed.
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:
Control the displacement of the Display to the specified coordinates. Unlike offset, this transformation does not take the block's rotation into account.
sides-count:
Count of sides of the block. Can be set in the range from 1 to 360.
Count of sides of the block. Can be set in the range from 1 to 360.
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
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
Code (Text):
skullmeta:
url: http://textures.minecraft.net/texture/3459c7b2430cbc2cbb52b39b994d82bf1ea9da0cbf44cc3f16cf0959740801ff
url: http://textures.minecraft.net/texture/3459c7b2430cbc2cbb52b39b994d82bf1ea9da0cbf44cc3f16cf0959740801ff
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.
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.
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.
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 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.
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 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.
break or
place sounds of this block
sound-type:
Type of sound played, all types can be found at spigotmc
volume:
Sound volume
pitch:
Sound pitch
sound-type:
Type of sound played, all types can be found at spigotmc
volume:
Sound volume
pitch:
Sound pitch
permission
is define permissions for accessing a block and customize messages in messages.yml.
Example of permissions
Code (Text):
permission:
break:
- "perm1"
- "perm2"
place:
- "perm1"
- "perm2"
interact:
- "perm1"
- "perm2"
break:
- "perm1"
- "perm2"
place:
- "perm1"
- "perm2"
interact:
- "perm1"
- "perm2"
Special settings for block placement and breaking
For now, you can set place(executed AFTER the block is placed) and break (executed BEFORE destruction) commands
(have the same settings as in interactions, except for cooldown)
![[IMG]](https://www.spigotmc.org/attachments/upload_2025-4-23_1-19-6-png.891417/)
For now, you can set place(executed AFTER the block is placed) and break (executed BEFORE destruction) commands
(have the same settings as in interactions, except for cooldown)
That's all, now you can get your block using the command /bdc custom-block give <custom block name>
Displayed objects 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 place a custom block in a region
- interact-cb – Controls the right to interact with custom block in a region
Commands
/bdc custom-block give <custom block name> <recipient> <count> - Returns a block by name
/bdc reload - Reloads the config
/bdc reload <custom block name> - Reloads a specific block
/bdc killcbentities <x1> <y1> <z1> <x2> <y2> <z2> - Kills the Display Entity and Interaction Entity in the selected area, needed to clear the world of unused block entities, if, for example, you accidentally deleted one in the config some custom block
/bdc custom-block editfile <parameters...> - Configures custom block files directly through in-game commands.
Code (Text):
General:
/bdc custom-block editfile <block> central-material <material>
/bdc custom-block editfile <block> sides-count <1–360>
Display settings:
/bdc custom-block editfile <block> display spawn-command <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} <value>
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>
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> central-material <material>
/bdc custom-block editfile <block> sides-count <1–360>
Display settings:
/bdc custom-block editfile <block> display spawn-command <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} <value>
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>
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...>
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.wg - Permission allowing unrestricted access to Custom Blocks regardless of region flags. By default, this permission is granted to administrators.
bdc.command.custom-block - Permission to use /bdc custom-block command
bdc.command.reload - Permission to use /bdc reload command
bdc.command.killcbentities - Permission to use /bdc killcbentities command
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 custom 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
Scoreboard Tags
For convenient integration with datapacks, the plugin uses various scoreboard tags. Some tags serve as markers to identify entities related to custom blocks, while others store dynamic block data such as location (e.g., custom-block-location:9.12,65,904.0).
In addition, each block-related entity has its own specific tags. The full list includes:
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:
924
First Release:
Feb 2, 2024
Last Update:
Yesterday at 3:52 PM
Category:
---------------
All-Time Rating:
8 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings