@occultus/toolkit 0.22.4 → 0.23.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@occultus/toolkit",
-  "version": "0.22.4",
+  "version": "0.23.1",
   "repository": {
     "type": "git",
     "url": "https://codeberg.org/TeamOccultus/StarTenonAPI"
@@ -30,7 +30,7 @@
     "@occultus/common": "0.20.0"
   },
   "devDependencies": {
-    "typedoc": "^0.28.15"
+    "typedoc": "^0.28.16"
   },
   "scripts": {
     "test": "tsc"

package/src/index.ts

@@ -5,4 +5,5 @@ export * from "./entity/EntitiesUtils";
 export * from "./entity/entityUtils";
 export * from "./item/item";
 export * from "./item/container";
-export * from "./identifier/namespace";
+export * from "./identifier/namespace";
+export * from "./item/cooldown";

package/src/item/cooldown.ts

@@ -0,0 +1,26 @@
+import { ItemStack, Player } from "@minecraft/server";
+
+/**
+ * 返回物品是否处于冷却状态
+ * @param item 要检查的物品
+ * @param player 持有物品的玩家
+ * @return 是否处于冷却状态
+ */
+export function isInCooldown(item: ItemStack, player: Player): boolean {
+  const cooldown = item.getComponent("minecraft:cooldown");
+  if (!cooldown) return false;
+  return cooldown.getCooldownTicksRemaining(player) !== 0;
+}
+
+/**
+ * 让物品开始冷却
+ * @param item 要执行冷却操作的物品
+ * @param player 持有物品的玩家
+ * @return 是否成功执行冷却操作，若物品不支持冷却则返回`false`
+ */
+export function startCooldown(item: ItemStack, player: Player): boolean {
+  const cooldown = item.getComponent("minecraft:cooldown");
+  if (!cooldown) return false;
+  cooldown.startCooldown(player);
+  return true;
+}