simplified-mojang-api 0.0.25 → 0.0.26

package/dist/events/customToolsManager.d.ts

@@ -35,19 +35,23 @@ declare class CustomEventsSimplified {
      */
     manualDamageItem(ply: mc.Player, item: mc.ItemStack): void;
     /**
-     * Metodo auxiliar que simplifica la logica de detectar en el inventario del jugador, si tiene uno o varios items en concreto.
+     * Metodo auxiliar que simplifica la logica de detectar en el inventario del jugador, si tiene uno o varios items en concreto de forma explicita o no.
      * @param {mc.Player} plySource Jugador en cuestion.
      * @param {(string | string[] | vanilla.MinecraftItemTypes | vanilla.MinecraftItemTypes[] )} itemsToDetect Item o items a buscar.
+     * @param {boolean?} exactItems (Opcional) Busca explicitamente el nombre del item palabra por palabra. Por defecto esta apagado, entonces buscara items sin importar si tienen diferencias. Por ej: Si se busca 'diamond'; minecraft:diamond y minecraft:diamond_sword serian true.
      * @returns {boolean} Devuelve true en caso de tener ese item, sino, sera false.
      * @author HaJuegos - 18-03-2026
      * @public
      * @example
      * ```ts
-     * // Esto es true si el jugador tiene un item en su inventario.
-     * customEventsManager.plyHasItems(player, vanilla.MinecraftItemTypes.TotemOfUndying);
+     * // Esto es true si el jugador tiene un item llamado totem o mas de forma no explicita.
+     * customEventsManager.plyHasItems(player, 'totem');
+     *
+     * // Esto es true si el jugador tiene un totem de la inmortalidad de forma explicita.
+     * customEventsManager.plyHasItems(player, vanilla.MinecraftItemTypes.TotemOfUndying, true);
      * ```
      */
-    plyHasItems(plySource: mc.Player, itemsToDetect: string | string[] | vanilla.MinecraftItemTypes | vanilla.MinecraftItemTypes[]): boolean;
+    plyHasItems(plySource: mc.Player, itemsToDetect: string | string[] | vanilla.MinecraftItemTypes | vanilla.MinecraftItemTypes[], exactItems?: boolean): boolean;
     /**
      * Metodo auxiliar que simplifica loa logica al detectar el uso de un totem en un jugaodor, ejecutando los eventos relacionados.
      * @param {(ply: mc.Player) => void} callback Los eventos relacionados a ejecutar.

package/dist/events/customToolsManager.js

@@ -69,6 +69,8 @@ class CustomEventsSimplified {
      * ```
      */
     manualDamageItem(ply, item) {
+        if (ply.getGameMode() != (mc.GameMode.Adventure || mc.GameMode.Survival))
+            return;
         const invPly = ply.getComponent(mc.EntityComponentTypes.Inventory)?.container;
         const slot = ply.selectedSlotIndex;
         const newItem = item.clone();
@@ -94,27 +96,34 @@ class CustomEventsSimplified {
     }
     ;
     /**
-     * Metodo auxiliar que simplifica la logica de detectar en el inventario del jugador, si tiene uno o varios items en concreto.
+     * Metodo auxiliar que simplifica la logica de detectar en el inventario del jugador, si tiene uno o varios items en concreto de forma explicita o no.
      * @param {mc.Player} plySource Jugador en cuestion.
      * @param {(string | string[] | vanilla.MinecraftItemTypes | vanilla.MinecraftItemTypes[] )} itemsToDetect Item o items a buscar.
+     * @param {boolean?} exactItems (Opcional) Busca explicitamente el nombre del item palabra por palabra. Por defecto esta apagado, entonces buscara items sin importar si tienen diferencias. Por ej: Si se busca 'diamond'; minecraft:diamond y minecraft:diamond_sword serian true.
      * @returns {boolean} Devuelve true en caso de tener ese item, sino, sera false.
      * @author HaJuegos - 18-03-2026
      * @public
      * @example
      * ```ts
-     * // Esto es true si el jugador tiene un item en su inventario.
-     * customEventsManager.plyHasItems(player, vanilla.MinecraftItemTypes.TotemOfUndying);
+     * // Esto es true si el jugador tiene un item llamado totem o mas de forma no explicita.
+     * customEventsManager.plyHasItems(player, 'totem');
+     *
+     * // Esto es true si el jugador tiene un totem de la inmortalidad de forma explicita.
+     * customEventsManager.plyHasItems(player, vanilla.MinecraftItemTypes.TotemOfUndying, true);
      * ```
      */
-    plyHasItems(plySource, itemsToDetect) {
+    plyHasItems(plySource, itemsToDetect, exactItems = false) {
         const invPly = plySource.getComponent(mc.EntityComponentTypes.Inventory)?.container;
         const armorPly = plySource.getComponent(mc.EntityComponentTypes.Equippable);
         const targetItems = Array.isArray(itemsToDetect) ? itemsToDetect : [itemsToDetect];
         if (invPly) {
             for (let i = 0; i < invPly.size; i++) {
                 const item = invPly.getItem(i);
-                if (item && targetItems.some((target) => item.typeId.includes(target))) {
-                    return true;
+                if (item) {
+                    const itemFound = !exactItems ? targetItems.some((target) => item.typeId.includes(target)) : targetItems.some((target) => item.typeId == target);
+                    if (itemFound) {
+                        return true;
+                    }
                 }
             }
         }
@@ -128,8 +137,11 @@ class CustomEventsSimplified {
             ];
             for (const slot of equipmentSlots) {
                 const item = armorPly.getEquipment(slot);
-                if (item && targetItems.some((target) => item.typeId.includes(target))) {
-                    return true;
+                if (item) {
+                    const itemFound = !exactItems ? targetItems.some((target) => item.typeId.includes(target)) : targetItems.some((target) => item.typeId == target);
+                    if (itemFound) {
+                        return true;
+                    }
                 }
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "simplified-mojang-api",
-    "version": "0.0.25",
+    "version": "0.0.26",
     "description": "About Public repository to simplify the event logic of Mojang's Script API, for informal or professional use",
     "type": "module",
     "main": "dist/index.js",