V1.5

.editorconfig

@@ -0,0 +1,22 @@
+# http://editorconfig.org/
+root = yes
+
+[*]
+indent_size = 4
+indent_style = tab
+charset = utf-8
+end_of_line = LF
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[composer.json]
+indent_size = 4
+
+[{*.json,*.yml,*.yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+indent_style = space
+indent_size = 2

.gitattributes

@@ -0,0 +1,4 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+*.php text eol=lf
+*.txt text eol=lf

README.md

@@ -8,13 +8,15 @@ A PocketMine-MP plugin that implements support for custom blocks, items and enti
 
 <a href="https://discord.gg/Tm6wGxWqgh"><img src="https://img.shields.io/discord/989466131305754625?label=discord&color=7289DA&logo=discord" alt="Discord" /></a>
 
-Official Discord community chat for socializing, receiving help with the plugin, and sharing creations. Join in on the
-fun!
+Official Discord community chat for socializing, receiving help with the plugin, and sharing creations. Join in on the fun!
 
 ## Usage
 
 The usage guides have been moved to the [Customies Wiki](https://github.com/CustomiesDevs/Customies/wiki)!
 
+[![Mojang Item Docs](https://img.shields.io/badge/📖-Microsoft_Docs-blue)](https://learn.microsoft.com/en-us/minecraft/creator/reference/content/itemreference/examples/itemcomponentlist?view=minecraft-bedrock-stable)
+[![Mojang Block Docs](https://img.shields.io/badge/📖-Microsoft_Docs-blue)](https://learn.microsoft.com/en-us/minecraft/creator/reference/content/blockreference/examples/blockcomponents/blockcomponentslist?view=minecraft-bedrock-stable)
+
 ## Important Contributors
 
 | Name                                                  | Contribution                                                                                 |

plugin.yml

@@ -3,13 +3,13 @@ description: A PocketMine-MP plugin that implements support for custom blocks, i
 
 main: customiesdevs\customies\Customies
 src-namespace-prefix: customiesdevs\customies
-version: 1.4.0
-api: 5.1.3
+version: 1.5.0
+api: 5.37.0
 
 authors:
   - DenielWorld
   - TwistedAsylumMC
 contributors:
   - JackNoordhuis
   - Unickorn
-  - abimek
+  - abimek

src/Customies.php

@@ -6,17 +6,22 @@
 use customiesdevs\customies\block\CustomiesBlockFactory;
 use pocketmine\plugin\PluginBase;
 use pocketmine\scheduler\ClosureTask;
+use pocketmine\utils\SingletonTrait;
 
 final class Customies extends PluginBase {
+	use SingletonTrait;
+
+	public function onLoad(): void{
+		self::setInstance($this);
+	}
 
 	protected function onEnable(): void {
 		$this->getServer()->getPluginManager()->registerEvents(new CustomiesListener(), $this);
 
-		$cachePath = $this->getDataFolder() . "idcache";
-		$this->getScheduler()->scheduleDelayedTask(new ClosureTask(static function () use ($cachePath): void {
+		$this->getScheduler()->scheduleDelayedTask(new ClosureTask(static function (): void {
 			// This task is scheduled with a 0-tick delay so it runs as soon as the server has started. Plugins should
-			// register their custom blocks and entities in onEnable() before this is executed.
-			CustomiesBlockFactory::getInstance()->addWorkerInitHook($cachePath);
+			// register their custom blocks and entities in onEnable() before this is executed
+			CustomiesBlockFactory::getInstance()->addWorkerInitHook();
 		}), 0);
 	}
-}
+}

src/CustomiesListener.php

@@ -13,31 +13,33 @@
 use function count;
 
 final class CustomiesListener implements Listener {
+
 	/** @var BlockPaletteEntry[] */
 	private array $cachedBlockPalette = [];
 	private Experiments $experiments;
 
 	public function __construct() {
 		$this->experiments = new Experiments([
-			// "data_driven_items" is required for custom blocks to render in-game. With this disabled, they will be
-			// shown as the UPDATE texture block.
+			// "data_driven_items" is required for custom blocks to render in-game.
+			// With this disabled, custom blocks will appear as the UPDATE texture block.
 			"data_driven_items" => true,
+			"upcoming_creator_features" => true
 		], true);
 	}
 
 	public function onDataPacketSend(DataPacketSendEvent $event): void {
 		foreach($event->getPackets() as $packet){
-			if($packet instanceof StartGamePacket) {
-				if(count($this->cachedBlockPalette) === 0) {
+			if($packet instanceof StartGamePacket){
+				if(count($this->cachedBlockPalette) === 0){
 					// Wait for the data to be needed before it is actually cached. Allows for all blocks and items to be
 					// registered before they are cached for the rest of the runtime.
 					$this->cachedBlockPalette = CustomiesBlockFactory::getInstance()->getBlockPaletteEntries();
 				}
 				$packet->levelSettings->experiments = $this->experiments;
 				$packet->blockPalette = $this->cachedBlockPalette;
-			} elseif($packet instanceof ResourcePackStackPacket) {
+			}elseif($packet instanceof ResourcePackStackPacket) {
 				$packet->experiments = $this->experiments;
 			}
 		}
 	}
-}
+}

src/block/BlockPalette.php

@@ -45,13 +45,15 @@ public function __construct() {
 	}
 
 	/**
+	 * Returns all block states in the palette.
 	 * @return BlockStateDictionaryEntry[]
 	 */
 	public function getStates(): array {
 		return $this->states;
 	}
 
 	/**
+	 * Returns all custom block states.
 	 * @return BlockStateDictionaryEntry[]
 	 */
 	public function getCustomStates(): array {
@@ -60,6 +62,9 @@ public function getCustomStates(): array {
 
 	/**
 	 * Inserts the provided state in to the correct position of the palette.
+	 * @param CompoundTag $state
+	 * @param int $meta
+	 * @return void
 	 */
 	public function insertState(CompoundTag $state, int $meta = 0): void {
 		if(($name = $state->getString(BlockStateData::TAG_NAME, "")) === "") {
@@ -74,6 +79,8 @@ public function insertState(CompoundTag $state, int $meta = 0): void {
 
 	/**
 	 * Sorts the palette's block states in the correct order, also adding the provided state to the array.
+	 * @param BlockStateDictionaryEntry $newState
+	 * @return void
 	 */
 	private function sortWith(BlockStateDictionaryEntry $newState): void {
 		// To sort the block palette we first have to split the palette up in to groups of states. We only want to sort
@@ -112,4 +119,4 @@ private function sortWith(BlockStateDictionaryEntry $newState): void {
 			throw new AssumptionFailedError(BlockTypeNames::INFO_UPDATE . " should always exist")
 		);
 	}
-}
+}