1.5.4.0 | Async Loading, Quick Select, SuperiorSkyblock2 Support

📦 BlockDisplayCreator 1.5.4.0 | Async Loading, Quick Select, SuperiorSkyblock2 Support

🚀 New features

🔀 Asynchronous block loading

• All custom blocks now load asynchronously from their files. This ensures smooth and invisible performance on your server.

---

👆 Quick Select feature (Minecraft 1.21.4+)

Works just like in vanilla Minecraft — simply middle-click a custom block to get it in your hand.

• Works only with installed PasketEvents
• In Creative mode you can obtain blocks even if they are not in your inventory.
• Permission for this creative feature: bdc.quickselect.creative.

---

✨ New Block Parameters

• stage-settings.place.placement-mode - Control where and how a block may be placed. There are 5 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 — prefers vertical behavior even when placed on a side; treats side placement as if vertical for visuals/logic.
  • horizontal_with_vertical — prefers horizontal behavior even when placed on top/bottom; treats vertical placement as if horizontal for visuals/logic.

  Example:

  stage-settings:
    place:
      placement-mode: vertical_with_horizontal

  

• stage-settings.break.drop-mode - Choose how the block drops its item on break:

  • on_ground — default; drop at the block location.
  • inventory — give directly to the player’s inventory; if full, drop at player location.

  Example:

  stage-settings:
    break:
      drop-mode: inventory

  

• ✅ All of the above parameters can now be configured via /bdc custom-block editfile

---

🏝️ SuperiorSkyblock2 integration

Island privileges to control access to custom blocks:

• place_cb — place custom blocks
• break_cb — break custom blocks
• interact_cb — interact with custom blocks

You can expose these in permissions.yml → items (SSB2) to make them toggleable in the island UI.
For unrestricted island access use bdc.bypass.skyblock or superior.skyblock.bypass permissions.
Message settings are made in messages.yml

---

📂^{↳📁↳📁} Subfolder loading for custom blocks

Custom blocks can now be organized inside any subfolders of the custom-blocks directory. Perfect for keeping things tidy and organized.

---

🔑 New permission system

• Separate permissions for each major subcommand
• Wildcard permissions with *
• Full list:

  bdc.quickselect.creative
  bdc.bypass.*
  bdc.bypass.wg
  bdc.bypass.skyblock
  bdc.command.*
  bdc.command.reload
  bdc.command.erasecbdata
  bdc.command.custom-block.*
  bdc.command.custom-block.give
  bdc.command.custom-block.place
  bdc.command.custom-block.break
  bdc.command.custom-block.editfile
  

---

📨 Expanded messages.yml

The message system has been greatly expanded. Most messages related to commands and custom blocks are now configurable, and each message supports helpful placeholders so you can fully control how feedback looks in chat.

What’s new:

• Many more message keys covering common actions & errors.
• Easy‑to‑read placeholders (e.g., block names, locations, players, reasons).
• Consistent formatting across commands and block events.

---

✨ Improved

• Block names can now safely contain special characters — automatically wrapped in quotes inside commands.
• Sound handling in /bdc editfile: when setting a sound to a block, it now correctly plays for the player.
• Improved filtering of block names and sound names in commands.
• Documentation improvements.

---

🔄 Changed

• Command /bdc killcbentities has been renamed to:

  /bdc erasecbdata
  

  It now fully matches its functionality: removing all interaction entities, display entities, shulkers, and clearing block data in the selected area.

---

🐞 Fixed

• Bug with incorrect rendering of barrel.yml.
• Bug with wrong block rotation when using small sides-count.
• Bug causing duplicate custom blocks.
• Bug where block service data was missing at its location.
• Bug with enchantment loading.
• Bug with null interaction command

---

Full Changelog: 1.5.3.0...1.5.4.0

1.5.3.0 | Place & Break Commands, bStats Integration, Vanilla Mechanics

📦 BlockDisplayCreator 1.5.3.0 — Place & Break Commands, bStats Integration, Vanilla Mechanics

🚀 New Features

🔨 Placement and Breaking Commands

New commands have been added to place and break custom blocks directly via console or command blocks.

/bdc custom-block place <block> <location> [attached-face] [direction] [options...]

Places a custom block at the specified location.

• <block> — The name of the custom block to place.
• <location> — The exact location where the block should be placed.
• [attached-face] — The face the block is attached to: north, south, east, west, up, down.
• [direction] — The horizontal direction (rotation in degrees, 0–360). Relevant only for attached-face: up/down.
• [options...] — Optional placement modifiers:
  • replace_custom_block — Replaces an existing custom block at the target location.
  • load_chunk — Loads the chunk before placing the block, if needed.
  • break_solid_material — Destroys a solid vanilla block at the target location, if present.
  • silent_place — Suppresses block placement sounds.

/bdc custom-block break <location> [options...]

Breaks a custom block at the specified location.

• <location> — The target location of the custom block.
• [options...] — Optional breaking modifiers:
  • drop_item — Drops the corresponding item upon breaking.
  • silent_break — Suppresses block breaking sounds.

Tip: When targeting a block in-game, the command will automatically fill in the correct location based on the player's line of sight.

---

📊 Metrics Integration (bStats)

• bStats support has been added to the plugin.
• In addition to general plugin usage, the system tracks the total number of custom blocks on all servers.
• 📈 View live statistics: bStats – BlockDisplayCreator

---

🔔 Update Checker

• A new automatic update checker is now included.
• Server console will notify you when a newer version is available.

---

🛠 Fixes and Improvements

• Fixed setter bugs in block configuration.
• Corrected entity rotation when offset was set to zero.
• Fixed placement issues on unloaded chunks.
• Resolved compatibility issues with sound loading on different Minecraft versions.
• Fixed improper handling of colors and enchantments in item settings.
• Fixed collisions that could not be removed or broken.

---

🌿 Vanilla Block Mechanics Compatibility

• Custom blocks placed on or inside fragile vanilla blocks (like grass or leaves) will now correctly replace them, emulating standard Minecraft behavior and improving game realism.

---

Full Changelog: 1.5.2.0...1.5.3.0

1.5.2.0 | Version adaptation update

📦 BlockDisplayCreator v1.5.2.0

This release introduces extended version support for display commands, enhancements to display rotation and collision handling, several bug fixes, and internal improvements.

---

✨ New Block Parameters

• display.spawn-command-1_19_4 — A version-specific spawn command used only in Minecraft 1.19.4. This is helpful for ensuring proper rendering of models using custom heads.

• display.spawn-command-1_20-1_20_4 — A version-specific spawn command used only in Minecraft 1.20–1.20.4. Also intended for compatibility of custom head models across versions.

• display.translation.yaw & display.translation.pitch — These new rotation offsets allow you to fine-tune display entity orientation in both horizontal (yaw) and vertical (pitch) angles. Supports both positive and negative values.

  display:
    translation:
      yaw: 180
      pitch: -45

• collisions.<name>.disable-below-1_20_5 — A new boolean flag that disables the collision entry 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.

  collisions:
    example-collision:
      disable-below-1_20_5: true

• ✅ All of the above parameters can now be configured via /bdc custom-block editfile

---

🛠 Fixes

• Fixed sound loading issues in newer Minecraft versions.
• Fixed a bug where items could drop in spectator mode.
• Fixed loading failure when a command consisted of a single line.
• Optimized block and command loading performance.

---

🧱 API & Behavior Changes

• Added a new version package containing classes for internal version management.
• CustomBlockInteractEvent now exposes the interaction that was clicked.
• Players in Adventure Mode can no longer break custom blocks.

---

Full Changelog: 1.5.1.0...1.5.2.0

1.5.1.0 | Full migration of commands to CommandAPI

Added command /bdc custom-block editfile allowing to change parameters of block file

Full Changelog: 1.5.0.0...1.5.1.0

1.5.0.0 | First public release

BlockDisplayCreator is a versatile plugin designed to work with bdengine, allowing you to create highly customizable custom blocks for decorating Minecraft server.