@occultus/toolkit 0.22.3 → 0.23.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@occultus/toolkit",
-  "version": "0.22.3",
+  "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/entity/entityUtils.ts

@@ -11,6 +11,7 @@ import {
 } from "@minecraft/server";
 import { EffectData, effectGroupMap, EffectGroups } from "@occultus/common";
 import { OccultusSDKError } from "@occultus/core";
+import { ensureNoNamespace } from "../identifier/namespace";
 
 /**
  * 尝试对实体进行操作
@@ -189,7 +190,7 @@ export function addEffect(
   for (const effect of effects) {
     if (duration === "infinite") {
       entity.runCommand(
-        `effect @s ${effect} infinite ${options?.amplifier ?? 0} ${options?.showParticles ?? false}`
+        `effect @s ${ensureNoNamespace(effect)} infinite ${options?.amplifier ?? 0} ${options?.showParticles ?? false}`
       );
       return;
     }

package/src/identifier/namespace.ts

@@ -0,0 +1,24 @@
+
+/**
+ * 确保命名空间存在，若不存在则自动加上`minecraft:`命名空间
+ * @param identifier 要检查的标识符
+ * @return 存在命名空间的标识符
+ */
+export function ensureNamespace(identifier: string): string {
+  if (identifier.includes(":")) {
+    return identifier;
+  }
+  return `minecraft:${identifier}`;
+}
+
+/**
+ * 确保命名空间**不**存在，若存在则自动去掉命名空间
+ * @param identifier 要检查的标识符
+ * @return 不存在命名空间的标识符
+ */
+export function ensureNoNamespace(identifier: string): string {
+  if (identifier.includes(":")) {
+    return identifier.split(":")[1];
+  }
+  return identifier;
+}

package/src/index.ts

@@ -5,3 +5,5 @@ export * from "./entity/EntitiesUtils";
 export * from "./entity/entityUtils";
 export * from "./item/item";
 export * from "./item/container";
+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;
+}