New Customies ItemComponent: ItemTaskComponent

Author: ImperaZim

changelogs/1.3.md

@@ -962,6 +962,7 @@ It is not compatible with plugins written for version 1.3.0 or lower, and plugin
 - `ShouldDespawnComponent`: Toggles item despawn mechanics for floating entities
 - `ShooterComponent`: Enables projectile launching (requires `UseModifiersComponent`)
 - `RecordComponent`: Adds music playback functionality to items
+- `ItemTaskComponent`: Creates a new ItemTaskComponent to define a task that checks for specific items in a player's inventory.
 
 ### Visual & Interaction
 - `HoverTextColorComponent`: Sets custom color for item name hover text

src/imperazim/vendor/customies/CustomiesManager.php

@@ -72,11 +72,18 @@ public static function init(PluginToolkit $plugin): array {
         new self()
       ],
       self::SCHEDULER_COMPONENT => [
-        'type' => 'delayed',
-        'class' => new ClosureTask(static function () use ($cachePath): void {
-          CustomiesBlockFactory::getInstance()->addWorkerInitHook($cachePath);
-        }),
-        'sleep' => 0
+        [
+          'type' => 'delayed',
+          'class' => new ClosureTask(static function () use ($cachePath): void {
+            CustomiesBlockFactory::getInstance()->addWorkerInitHook($cachePath);
+          }),
+          'sleep' => 0
+        ],
+        [
+          'type' => 'repeating',
+          'class' => new ItemTask(),
+          'sleep' => 20
+        ]
       ]
     ];
   }

src/imperazim/vendor/customies/item/component/ItemTaskComponent.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace imperazim\vendor\customies\item\component;
+
+use Closure;
+use pocketmine\player\Player;
+use pocketmine\item\Item;
+use imperazim\vendor\customies\item\ItemComponents;
+
+final class ItemTaskComponent implements ItemComponents {
+
+  public const FILTER_HAND = 'hand';
+  public const FILTER_INVENTORY = 'inventory';
+
+  private string $itemClass;
+  private Closure $callback;
+  private string $filter;
+
+  /**
+   * Creates a new ItemTaskComponent to define a task that checks for specific items in a player's inventory.
+   *
+   * @param string $itemClass The class of the item to check for (e.g., DiamondSword::class).
+   * @param Closure $callback The action to execute when the item is found. Receives the Player and Item as parameters.
+   * @param string $filter The location to check for the item. Use FILTER_HAND to check the main hand or FILTER_INVENTORY to check the entire inventory.
+   */
+  public function __construct(string $itemClass, Closure $callback, string $filter = self::FILTER_INVENTORY) {
+    $this->itemClass = $itemClass;
+    $this->callback = $callback;
+    $this->filter = $filter;
+  }
+
+  public function getName(): string {
+    return "minecraft:item_task";
+  }
+
+  public function getValue(): array {
+    return [
+      'item_class' => $this->itemClass,
+      'filter' => $this->filter,
+    ];
+  }
+
+  public function isProperty(): bool {
+    return false;
+  }
+
+  public function checkCondition(Player $player): ?Item {
+    $inventory = $player->getInventory();
+    switch ($this->filter) {
+      case self::FILTER_HAND:
+        $item = $inventory->getItemInHand();
+        return $item instanceof $this->itemClass ? $item : null;
+      default:
+        foreach ($inventory->getContents() as $item) {
+          if ($item instanceof $this->itemClass) {
+            return $item;
+          }
+        }
+        return null;
+    }
+  }
+
+  public function execute(Player $player, Item $item): void {
+    ($this->callback)($player, $item);
+  }
+}

src/imperazim/vendor/customies/task/ItemTask.php

@@ -0,0 +1,26 @@
+<?php
+declare(strict_types = 1);
+
+namespace imperazim\vendor\customies\task;
+
+use imperazim\vendor\customies\item\CustomiesItemFactory;
+use pocketmine\scheduler\Task;
+use pocketmine\Server;
+
+final class ItemTask extends Task {
+
+  public function onRun(): void {
+    foreach (Server::getInstance()->getOnlinePlayers() as $player) {
+      foreach (CustomiesItemFactory::getInstance()->getItemRegisteredList() as $itemData) {
+        $item = $itemData['item'];
+        if (!$item->hasComponent("minecraft:item_task")) continue;
+
+        /** @var \imperazim\vendor\customies\item\component\ItemTaskComponent $component */
+        $component = $item->getComponent("minecraft:item_task");
+        if ($itemInstance = $component->checkCondition($player)) {
+          $component->execute($player, $itemInstance);
+        }
+      }
+    }
+  }
+}