simplified-mojang-api 0.0.13 → 0.0.15

package/dist/events/afterEventsSimplifiedManager.d.ts

@@ -9,6 +9,7 @@ declare class AfterEventsSimplified {
     private playerSpawnManager;
     private worldLoadManager;
     private chatSendManager;
+    private itemUseManager;
     /**
      * Eventos que se inicializan cuando la clase es llamada o inicializada.
      * @constructor
@@ -57,7 +58,7 @@ declare class AfterEventsSimplified {
      */
     onWorldReady(callback: (args: mc.WorldLoadAfterEvent) => void): void;
     /**
-     * Metodo auxiliar que recibe los mensajes enviados por el chat.
+     * Metodo auxiliar que ejecuta los eventos relacionados cuando se recibe un mensaje en el chat de forma simplificada.
      * @param {(args: mc.ChatSendAfterEvent) => void} callback Los argumentos y logica a ejecutar en el evento.
      * @author HaJuegos - 14-03-2026
      * @public
@@ -70,6 +71,20 @@ declare class AfterEventsSimplified {
      * ```
      */
     onSendMessageChat(callback: (args: mc.ChatSendAfterEvent) => void): void;
+    /**
+     * Metodo auxiliar que ejecuta los eventos relacionados cuando ya se usa el item de forma simplificada.
+     * @param {(args: mc.ItemUseAfterEvent) => void} callback Los eventos relacionados a ejecutar.
+     * @author HaJuegos - 15-03-2026
+     * @public
+     * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
+     * @example
+     * ```ts
+     * afterEventsSimplified.onUseItem((args) => {
+     *   console.warn(`Se ha usado el item ${args.itemStack.typeId}.`);
+     * });
+     * ```
+     */
+    onUseItem(callback: (args: mc.ItemUseAfterEvent) => void): void;
 }
 export declare const afterEventsSimplified: AfterEventsSimplified;
 export {};

package/dist/events/afterEventsSimplifiedManager.js

@@ -15,6 +15,7 @@ class AfterEventsSimplified {
         this.playerSpawnManager = new BaseEventManager(mc.world.afterEvents.playerSpawn, "AfterPlayerSpawn");
         this.worldLoadManager = new BaseEventManager(mc.world.afterEvents.worldLoad, "AfterWorldLoad");
         this.chatSendManager = new BaseEventManager(mc.world.afterEvents.chatSend, "AfterChatSend");
+        this.itemUseManager = new BaseEventManager(mc.world.afterEvents.itemUse, "AfterItemUse");
     }
     /**
      * Metodo auxiliar que ejecuta los eventos relacionado cuando una entidad muere de forma simplificada.
@@ -65,7 +66,7 @@ class AfterEventsSimplified {
         this.worldLoadManager.register(callback);
     }
     /**
-     * Metodo auxiliar que recibe los mensajes enviados por el chat.
+     * Metodo auxiliar que ejecuta los eventos relacionados cuando se recibe un mensaje en el chat de forma simplificada.
      * @param {(args: mc.ChatSendAfterEvent) => void} callback Los argumentos y logica a ejecutar en el evento.
      * @author HaJuegos - 14-03-2026
      * @public
@@ -80,5 +81,21 @@ class AfterEventsSimplified {
     onSendMessageChat(callback) {
         this.chatSendManager.register(callback);
     }
+    /**
+     * Metodo auxiliar que ejecuta los eventos relacionados cuando ya se usa el item de forma simplificada.
+     * @param {(args: mc.ItemUseAfterEvent) => void} callback Los eventos relacionados a ejecutar.
+     * @author HaJuegos - 15-03-2026
+     * @public
+     * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
+     * @example
+     * ```ts
+     * afterEventsSimplified.onUseItem((args) => {
+     *   console.warn(`Se ha usado el item ${args.itemStack.typeId}.`);
+     * });
+     * ```
+     */
+    onUseItem(callback) {
+        this.itemUseManager.register(callback);
+    }
 }
 export const afterEventsSimplified = new AfterEventsSimplified();

package/dist/events/beforeEventsSimplifiedManager.d.ts

@@ -10,6 +10,7 @@ declare class BeforeEventsSimplified {
     private shutDownManager;
     private interactBlockManager;
     private chatSendManager;
+    private itemUseManager;
     /**
      * Eventos que se inicializan cuando la clase es llamada o inicializada.
      * @constructor
@@ -72,6 +73,21 @@ declare class BeforeEventsSimplified {
      * ```
      */
     chatManager(callback: (args: mc.ChatSendBeforeEvent) => void): void;
+    /**
+     * Metodo auxiliar que ejecuta los eventos relacionados cuando antes de usar un item forma simplificada.
+     * @param {(args: mc.ItemUseBeforeEvent) => void} callback Los eventos relacionados a ejecutar.
+     * @author HaJuegos - 15-03-2026
+     * @public
+     * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
+     * @example
+     * ```ts
+     * beforeEventsSimplified.onUseItem((args) => {
+     *   console.warn(`Se esta usando el item ${args.itemStack.typeId}.`);
+     *   args.cancel = true;
+     * });
+     * ```
+     */
+    onUseItem(callback: (args: mc.ItemUseBeforeEvent) => void): void;
 }
 export declare const beforeEventsSimplified: BeforeEventsSimplified;
 export {};

package/dist/events/beforeEventsSimplifiedManager.js

@@ -16,6 +16,7 @@ class BeforeEventsSimplified {
         this.shutDownManager = new BaseEventManager(mc.system.beforeEvents.shutdown, "BeforeShutdown");
         this.interactBlockManager = new BaseEventManager(mc.world.beforeEvents.playerInteractWithBlock, "BeforeInteractBlock");
         this.chatSendManager = new BaseEventManager(mc.world.beforeEvents.chatSend, "BeforeChatSend");
+        this.itemUseManager = new BaseEventManager(mc.world.beforeEvents.itemUse, "BeforeItemUse");
     }
     /**
      * Metodo auxiliar que ejecuta los eventos relacionados cuando el add-on se carga por primera vez
@@ -82,5 +83,22 @@ class BeforeEventsSimplified {
     chatManager(callback) {
         this.chatSendManager.register(callback);
     }
+    /**
+     * Metodo auxiliar que ejecuta los eventos relacionados cuando antes de usar un item forma simplificada.
+     * @param {(args: mc.ItemUseBeforeEvent) => void} callback Los eventos relacionados a ejecutar.
+     * @author HaJuegos - 15-03-2026
+     * @public
+     * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
+     * @example
+     * ```ts
+     * beforeEventsSimplified.onUseItem((args) => {
+     *   console.warn(`Se esta usando el item ${args.itemStack.typeId}.`);
+     *   args.cancel = true;
+     * });
+     * ```
+     */
+    onUseItem(callback) {
+        this.itemUseManager.register(callback);
+    }
 }
 export const beforeEventsSimplified = new BeforeEventsSimplified();

package/dist/events/customToolsManager.d.ts

@@ -0,0 +1,26 @@
+import * as mc from '@minecraft/server';
+/**
+ * Clase que contiene todos los metodos de mecanicas universales usadas en sus add-ons.
+ * @author HaJuegos - 15-03-2026
+ */
+declare class CustomEventsSimplified {
+    /**
+     * Eventos principales de la clase cuando es llamada o inicializada.
+     * @constructor
+     */
+    constructor();
+    /**
+     * Metodo auxiliar que simplifica la logica de los fast items, cuando usas tu item con tu tecla de interaccion, este cambiara a tu mano secundaria.
+     * @param {(mc.ItemStack[] | string[])} listOfItems La lista de items a validar para este sistema.
+     * @author HaJuegos - 15-03-2026
+     * @public
+     * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
+     * @example
+     * ```ts
+     * customEventsManager.fastItemsSystem(['totem']); // Ahora el totem es conciderado un fast item para cambiar a la mano secundaria con un click.
+     * ```
+     */
+    fastItemsSystem(listOfItems: mc.ItemStack[] | string[]): void;
+}
+export declare const customEventsManager: CustomEventsSimplified;
+export {};

package/dist/events/customToolsManager.js

@@ -0,0 +1,55 @@
+import * as mc from '@minecraft/server';
+import { beforeEventsSimplified } from './beforeEventsSimplifiedManager';
+/**
+ * Clase que contiene todos los metodos de mecanicas universales usadas en sus add-ons.
+ * @author HaJuegos - 15-03-2026
+ */
+class CustomEventsSimplified {
+    /**
+     * Eventos principales de la clase cuando es llamada o inicializada.
+     * @constructor
+     */
+    constructor() {
+    }
+    /**
+     * Metodo auxiliar que simplifica la logica de los fast items, cuando usas tu item con tu tecla de interaccion, este cambiara a tu mano secundaria.
+     * @param {(mc.ItemStack[] | string[])} listOfItems La lista de items a validar para este sistema.
+     * @author HaJuegos - 15-03-2026
+     * @public
+     * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
+     * @example
+     * ```ts
+     * customEventsManager.fastItemsSystem(['totem']); // Ahora el totem es conciderado un fast item para cambiar a la mano secundaria con un click.
+     * ```
+     */
+    fastItemsSystem(listOfItems) {
+        beforeEventsSimplified.onUseItem((args) => {
+            const ply = args.source;
+            const plyInv = ply.getComponent(mc.EntityComponentTypes.Inventory)?.container;
+            const plyArmor = ply.getComponent(mc.EntityComponentTypes.Equippable);
+            const item = args.itemStack;
+            const itemOffhand = plyArmor.getEquipment(mc.EquipmentSlot.Offhand);
+            const isItemValid = listOfItems.some((listItem) => {
+                if (typeof listItem == "string") {
+                    return item.typeId.includes(listItem);
+                }
+                else {
+                    return item.typeId == listItem.typeId;
+                }
+            });
+            if (isItemValid) {
+                if (itemOffhand) {
+                    plyArmor.setEquipment(mc.EquipmentSlot.Offhand, item);
+                    plyInv.setItem(ply.selectedSlotIndex, itemOffhand);
+                }
+                else {
+                    plyArmor.setEquipment(mc.EquipmentSlot.Offhand, item);
+                    plyInv.setItem(ply.selectedSlotIndex, undefined);
+                }
+                ply.playSound('armor.equip_generic');
+            }
+        });
+    }
+    ;
+}
+export const customEventsManager = new CustomEventsSimplified();

package/dist/events/debugToolsSimplified.d.ts

@@ -41,7 +41,7 @@ declare class DebugToolsSimplified {
     stopHitboxes(): void;
     /**
      * Metodo que altera el estado de activo o desactivado del watchDogTerminate, en caso de lag spikes con scripts, para permitir el cierre o no del mundo o servidor cuando pase. Esto es solo recomendable usarlo en testeos, no se recomienda desactivarlo en mundos/servidores casuales o normales.
-     * @param {boolean} turnOn El estado proximo a cambiar.
+     * @param {boolean} newState El estado proximo a cambiar.
      * @author HaJuegos - 14-03-2026
      * @public
      * @example
@@ -49,7 +49,7 @@ declare class DebugToolsSimplified {
      * debugToolsSimplified.watchDogState(false) // ya no habra cierre por lag spikes o problemas con scripts
      * ```
      */
-    watchDogState(turnOn: boolean): void;
+    watchDogState(newState: boolean): void;
 }
 export declare const debugToolsSimplified: DebugToolsSimplified;
 export {};

package/dist/events/debugToolsSimplified.js

@@ -26,7 +26,7 @@ class DebugToolsSimplified {
      */
     showHitboxes(ply, maxRadiusHitboxs = 50) {
         const activeBoxes = new Map();
-        worldToolsSimplified.setLoop(() => {
+        this.idLoopHitboxes = worldToolsSimplified.setLoop(() => {
             const nearbyMobs = ply.dimension.getEntities({
                 location: ply.location,
                 maxDistance: maxRadiusHitboxs
@@ -102,7 +102,7 @@ class DebugToolsSimplified {
     }
     /**
      * Metodo que altera el estado de activo o desactivado del watchDogTerminate, en caso de lag spikes con scripts, para permitir el cierre o no del mundo o servidor cuando pase. Esto es solo recomendable usarlo en testeos, no se recomienda desactivarlo en mundos/servidores casuales o normales.
-     * @param {boolean} turnOn El estado proximo a cambiar.
+     * @param {boolean} newState El estado proximo a cambiar.
      * @author HaJuegos - 14-03-2026
      * @public
      * @example
@@ -110,9 +110,9 @@ class DebugToolsSimplified {
      * debugToolsSimplified.watchDogState(false) // ya no habra cierre por lag spikes o problemas con scripts
      * ```
      */
-    watchDogState(turnOn) {
+    watchDogState(newState) {
         mc.system.beforeEvents.watchdogTerminate.subscribe((arg) => {
-            arg.cancel = turnOn;
+            arg.cancel = newState;
         });
     }
 }

package/dist/index.d.ts

@@ -4,3 +4,4 @@ export * from "./events/beforeEventsSimplifiedManager";
 export * from "./events/worldToolsSimplifiedManager";
 export * from "./events/debugToolsSimplified";
 export * from "./events/fakePlysManagerSimplififed";
+export * from './events/customToolsManager';

package/dist/index.js

@@ -8,3 +8,5 @@ export * from "./events/worldToolsSimplifiedManager";
 export * from "./events/debugToolsSimplified";
 // @minecraft/gametest events
 export * from "./events/fakePlysManagerSimplififed";
+// Custom events
+export * from './events/customToolsManager';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "simplified-mojang-api",
-    "version": "0.0.13",
+    "version": "0.0.15",
     "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",