simplified-mojang-api 0.0.7 → 0.0.10

package/dist/events/afterEventsSimplifiedManager.d.ts

@@ -18,6 +18,12 @@ declare class AfterEventsSimplified {
      * @param {(args: mc.EntityDieAfterEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @example
+     * ```ts
+     * afterEventsSimplified.onEntityDie((event) => {
+     *   console.warn(`La entidad ${args.entity.typeId} murio en ${args.location}`);
+     * });
+     * ```
      */
     onEntityDie(callback: (args: mc.EntityDieAfterEvent) => void): void;
     /**
@@ -25,6 +31,12 @@ declare class AfterEventsSimplified {
      * @param {(args: mc.PlayerSpawnAfterEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @example
+     * ```ts
+     * afterEventsSimplified.onPlayerSpawns((args) => {
+     *   console.warn(`El Jugador ${args.player.name} spawneo en ${args.player.location}`);
+     * });
+     * ```
      */
     onPlayerSpawns(callback: (args: mc.PlayerSpawnAfterEvent) => void): void;
     /**
@@ -32,6 +44,12 @@ declare class AfterEventsSimplified {
      * @param {(args: mc.WorldLoadAfterEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @example
+     * ```ts
+     * afterEventsSimplified.onWorldReady(() => {
+     *   console.warn(`El mundo se ha cargado correctamente`);
+     * });
+     * ```
      */
     onWorldReady(callback: (args: mc.WorldLoadAfterEvent) => void): void;
 }

package/dist/events/afterEventsSimplifiedManager.js

@@ -20,6 +20,12 @@ class AfterEventsSimplified {
      * @param {(args: mc.EntityDieAfterEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @example
+     * ```ts
+     * afterEventsSimplified.onEntityDie((event) => {
+     *   console.warn(`La entidad ${args.entity.typeId} murio en ${args.location}`);
+     * });
+     * ```
      */
     onEntityDie(callback) {
         this.entityDieManager.register(callback);
@@ -29,6 +35,12 @@ class AfterEventsSimplified {
      * @param {(args: mc.PlayerSpawnAfterEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @example
+     * ```ts
+     * afterEventsSimplified.onPlayerSpawns((args) => {
+     *   console.warn(`El Jugador ${args.player.name} spawneo en ${args.player.location}`);
+     * });
+     * ```
      */
     onPlayerSpawns(callback) {
         this.playerSpawnManager.register(callback);
@@ -38,6 +50,12 @@ class AfterEventsSimplified {
      * @param {(args: mc.WorldLoadAfterEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @example
+     * ```ts
+     * afterEventsSimplified.onWorldReady(() => {
+     *   console.warn(`El mundo se ha cargado correctamente`);
+     * });
+     * ```
      */
     onWorldReady(callback) {
         this.worldLoadManager.register(callback);

package/dist/events/beforeEventsSimplifiedManager.d.ts

@@ -19,6 +19,13 @@ declare class BeforeEventsSimplified {
      * @param {(args: mc.StartupEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @beforeEvent Es un evento que se ejecuta antes de que pase dicho evento en concreto.
+     * @example
+     * ```ts
+     * beforeEventsSimplified.onAddonStarts((args) => {
+     *   console.warn('El addon esta iniciando');
+     * });
+     * ```
     */
     onAddonStarts(callback: (args: mc.StartupEvent) => void): void;
     /**
@@ -26,6 +33,13 @@ declare class BeforeEventsSimplified {
      * @param {(args: mc.ShutdownEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @beforeEvent Es un evento que se ejecuta antes de que pase dicho evento en concreto.
+     * @example
+     * ```ts
+     * beforeEventsSimplified.onAddonStops((args) => {
+     *   console.warn('El addon se esta detendiendo');
+     * });
+     * ```
     */
     onAddonStops(callback: (args: mc.ShutdownEvent) => void): void;
     /**
@@ -33,6 +47,13 @@ declare class BeforeEventsSimplified {
     * @param {(args: mc.PlayerInteractWithBlockBeforeEvent) => void} callback Los argumentos del evento y su logica.
     * @author HaJuegos - 11-03-2026
     * @public
+    * @beforeEvent Es un evento que se ejecuta antes de que pase dicho evento en concreto.
+    * @example
+    * ```ts
+    * beforeEventsSimplified.onInteractBlock((args) => {
+    *   console.warn(`Se esta interactuando con el bloque ${args.block.typeId}`);
+    * });
+    * ```
    */
     onInteractBlock(callback: (args: mc.PlayerInteractWithBlockBeforeEvent) => void): void;
 }

package/dist/events/beforeEventsSimplifiedManager.js

@@ -21,6 +21,13 @@ class BeforeEventsSimplified {
      * @param {(args: mc.StartupEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @beforeEvent Es un evento que se ejecuta antes de que pase dicho evento en concreto.
+     * @example
+     * ```ts
+     * beforeEventsSimplified.onAddonStarts((args) => {
+     *   console.warn('El addon esta iniciando');
+     * });
+     * ```
     */
     onAddonStarts(callback) {
         this.startUpManager.register(callback);
@@ -30,6 +37,13 @@ class BeforeEventsSimplified {
      * @param {(args: mc.ShutdownEvent) => void} callback Los argumentos del evento y su logica.
      * @author HaJuegos - 11-03-2026
      * @public
+     * @beforeEvent Es un evento que se ejecuta antes de que pase dicho evento en concreto.
+     * @example
+     * ```ts
+     * beforeEventsSimplified.onAddonStops((args) => {
+     *   console.warn('El addon se esta detendiendo');
+     * });
+     * ```
     */
     onAddonStops(callback) {
         this.shutDownManager.register(callback);
@@ -39,6 +53,13 @@ class BeforeEventsSimplified {
     * @param {(args: mc.PlayerInteractWithBlockBeforeEvent) => void} callback Los argumentos del evento y su logica.
     * @author HaJuegos - 11-03-2026
     * @public
+    * @beforeEvent Es un evento que se ejecuta antes de que pase dicho evento en concreto.
+    * @example
+    * ```ts
+    * beforeEventsSimplified.onInteractBlock((args) => {
+    *   console.warn(`Se esta interactuando con el bloque ${args.block.typeId}`);
+    * });
+    * ```
    */
     onInteractBlock(callback) {
         this.interactBlockManager.register(callback);

package/dist/events/fakePlysManagerSimplififed.d.ts

@@ -0,0 +1,38 @@
+import * as mc from "@minecraft/server";
+import * as gametest from "@minecraft/server-gametest";
+/**
+ * Clase hijo que controla los eventos simplificados sobre jugadores falsos por medio de scripts.
+ * @author HaJuegos - 13-03-2026
+ */
+declare class FakePlysManager {
+    /**
+     * Variable privada que contiene la informacion de un gametest command generado.
+     * @type {?gametest.Test}
+     * @author HaJuegos - 14-03-2026
+     * @private
+     */
+    private testContext?;
+    /**
+     * Eventos iniciales de la clase cuando es inicializada o llamada.
+     * @constructor
+     */
+    constructor();
+    /**
+     * Metodo auxiliar que crea un nuevo tipo de jugador falso para metodos de pruebas.
+     * @param {string} namePly Nombre a asignar al jugador de pruebas.
+     * @param {mc.GameMode} gamemodePly El modo de juego que tendra el jugador de pruebas.
+     * @param {?mc.Vector3} [defaultSpawnLocation] (Opcional) Coordenadas donde aparecera el jugador de pruebas. Por defecto, ira a un jugador aleatorio
+     * @returns {gametest.SimulatedPlayer} Los datos del jugador falso generado.
+     * @author HaJuegos - 13-03-2026
+     * @gametestEvent Es un metodo gametest, usando estructuras de pruebas por medio del comando /gametest run.
+     * @public
+     * @example
+     * ```ts
+     * // Esto genera un jugador de pruebas con sus respectivos datos para usar.
+     * const fakePly = fakePlysSimplified.createFakePly('Jugador Prueba', mc.GameMode.Survival);
+     * ```
+     */
+    createFakePly(namePly: string, gamemodePly: mc.GameMode, defaultSpawnLocation?: mc.Vector3): gametest.SimulatedPlayer | undefined;
+}
+export declare const fakePlysSimplified: FakePlysManager;
+export {};

package/dist/events/fakePlysManagerSimplififed.js

@@ -0,0 +1,50 @@
+import * as gametest from "@minecraft/server-gametest";
+/**
+ * Clase hijo que controla los eventos simplificados sobre jugadores falsos por medio de scripts.
+ * @author HaJuegos - 13-03-2026
+ */
+class FakePlysManager {
+    /**
+     * Eventos iniciales de la clase cuando es inicializada o llamada.
+     * @constructor
+     */
+    constructor() {
+        gametest.register('ha', 'fakeplys', (test) => {
+            this.testContext = test;
+        })
+            .maxTicks(99999999)
+            .maxAttempts(1)
+            .structureName('ha:void');
+    }
+    /**
+     * Metodo auxiliar que crea un nuevo tipo de jugador falso para metodos de pruebas.
+     * @param {string} namePly Nombre a asignar al jugador de pruebas.
+     * @param {mc.GameMode} gamemodePly El modo de juego que tendra el jugador de pruebas.
+     * @param {?mc.Vector3} [defaultSpawnLocation] (Opcional) Coordenadas donde aparecera el jugador de pruebas. Por defecto, ira a un jugador aleatorio
+     * @returns {gametest.SimulatedPlayer} Los datos del jugador falso generado.
+     * @author HaJuegos - 13-03-2026
+     * @gametestEvent Es un metodo gametest, usando estructuras de pruebas por medio del comando /gametest run.
+     * @public
+     * @example
+     * ```ts
+     * // Esto genera un jugador de pruebas con sus respectivos datos para usar.
+     * const fakePly = fakePlysSimplified.createFakePly('Jugador Prueba', mc.GameMode.Survival);
+     * ```
+     */
+    createFakePly(namePly, gamemodePly, defaultSpawnLocation) {
+        if (this.testContext) {
+            const fakePly = this.testContext.spawnSimulatedPlayer({ x: 0, y: 1, z: 0 }, namePly, gamemodePly);
+            if (defaultSpawnLocation) {
+                fakePly.teleport(defaultSpawnLocation);
+            }
+            else {
+                fakePly.runCommand(`tp @r[name=!"${fakePly.name}"]`);
+            }
+            return fakePly;
+        }
+        else {
+            throw new Error(`No se pudo generar el jugador de pruebas ${namePly}`);
+        }
+    }
+}
+export const fakePlysSimplified = new FakePlysManager();

package/dist/events/worldToolsSimplifiedManager.d.ts

@@ -10,11 +10,70 @@ declare class WorldToolsSimplified {
      * @constructor
      */
     constructor();
+    /**
+     * Metodo auxiliar que establece una serie de eventos con un pequeño retraso determinado. Luego de terminar el retraso, elimina la tarea para no dejarlo en memoria.
+     * @param {() => void} callback Los eventos en cuestion a ejecutar.
+     * @param {number} ticksDelay Los tiempos en ticks que se tardara para ejecutarse.
+     * @returns {Promise<void>}
+     * @author HaJuegos - 13-03-2026
+     * @async Es un metodo asincrono, debido a que se limpia despues de la ejecucion.
+     * @systemEvent Este metodo usa los eventos system donde posiblemente puede ser beforeEvent, permitiendo la ejecucion antes de que pase.
+     * @public
+     * @example
+     * ```ts
+     * worldToolsSimplified.setDelay(() => {
+     *    console.warn('Este evento se ejecutara despues de 5 segundos');
+     * } worldToolsSimplified.convertSecondsToTicks(5))
+     * ```
+     */
+    setDelay(callback: () => void, ticksDelay: number): Promise<void>;
+    /**
+     * Metodo auxiliar que establece una serie de eventos en concreto que se mantendran en loop.
+     * @param {() => void} callback Los eventos en concreto.
+     * @param {number} loopTicks El numero en ticks que se repetira este loop.
+     * @returns {number} Devuelve el ID de la memoria, del proceso loop creado.
+     * @author HaJuegos - 13-03-2026
+     * @systemEvent Este metodo usa los eventos system donde posiblemente puede ser beforeEvent, permitiendo la ejecucion antes de que pase.
+     * @public
+     * @example
+     * ```ts
+     * worldToolsSimplified.setLoop(() => {
+     *    console.warn('Este evento se ejecutara cada 1 segundo');
+     * } worldToolsSimplified.convertSecondsToTicks(1))
+     * ```
+     */
+    setLoop(callback: () => void, loopTicks: number): number;
+    /**
+     * Metodo auxiliar que detiene un proceso looping creado previamente por medio de su ID generado en memoria.
+     * @param {number} runID ID del proceso generado.
+     * @author HaJuegos - 13-03-2026
+     * @systemEvent Este metodo usa los eventos system donde posiblemente puede ser beforeEvent, permitiendo la ejecucion antes de que pase.
+     * @public
+     * @example
+     * ```ts
+     * // Se crea el evento primero, generado su ID en memoria.
+     * const idLoop = worldToolsSimplified.setLoop(() => {
+     *   console.warn('este evento se esta repitiendo cada 1 segundo');
+     * } worldToolsSimplified.convertSecondsToTicks(1))
+     *
+     * // Con el ID generado en memoria, lo usamos para detenerlo cuando queramos.
+     * worldToolsSimplified.stopLoop(idLoop);
+     * ```
+     */
+    stopLoop(runID: number): void;
     /**
      * Metodo auxiliar que envia un mensaje global al mundo en formato string o rawmessage.
      * @public
      * @param {(string | mc.RawMessage)} message Mensaje o RawMessage en concreto a enviar.
      * @author HaJuegos - 12-03-2026
+     * @example
+     * ```ts
+     * // Este es un mensaje simple
+     * worldToolsSimplified.sendMessageGlobal('hola soy un mensaje');
+     *
+     * // Este es un mensaje RawText
+     * worldToolsSimplified.sendMessageGlobal({ rawtext: 'chat.test.message' });
+     * ```
      */
     sendMessageGlobal(message: string | mc.RawMessage): void;
     /**
@@ -23,6 +82,11 @@ declare class WorldToolsSimplified {
      * @param {number} seconds Los segundos a convertir.
      * @returns {number} Los ticks convertidos.
      * @author HaJuegos - 12-03-2026
+     * @example
+     * ```ts
+     * // 15 segundos son 300 ticks (20 ticks por segundo)
+     * const ticks = worldToolsSimplified.convertSecondsToTicks(15); // 300
+     * ```
      */
     convertSecondsToTicks(seconds: number): number;
     /**
@@ -31,6 +95,11 @@ declare class WorldToolsSimplified {
      * @param {number} ticks Los ticks a convertir.
      * @returns {number} Los segundos convertidos.
      * @author HaJuegos - 12-03-2026
+     * @example
+     * ```ts
+     * // 300 ticks son 15 segundos (20 ticks por segundo)
+     * const seconds = worldToolsSimplified.convertTicksToSeconds(300); // 15
+     * ```
      */
     convertTicksToSeconds(ticks: number): number;
 }

package/dist/events/worldToolsSimplifiedManager.js

@@ -10,11 +10,84 @@ class WorldToolsSimplified {
      * @constructor
      */
     constructor() { }
+    /**
+     * Metodo auxiliar que establece una serie de eventos con un pequeño retraso determinado. Luego de terminar el retraso, elimina la tarea para no dejarlo en memoria.
+     * @param {() => void} callback Los eventos en cuestion a ejecutar.
+     * @param {number} ticksDelay Los tiempos en ticks que se tardara para ejecutarse.
+     * @returns {Promise<void>}
+     * @author HaJuegos - 13-03-2026
+     * @async Es un metodo asincrono, debido a que se limpia despues de la ejecucion.
+     * @systemEvent Este metodo usa los eventos system donde posiblemente puede ser beforeEvent, permitiendo la ejecucion antes de que pase.
+     * @public
+     * @example
+     * ```ts
+     * worldToolsSimplified.setDelay(() => {
+     *    console.warn('Este evento se ejecutara despues de 5 segundos');
+     * } worldToolsSimplified.convertSecondsToTicks(5))
+     * ```
+     */
+    async setDelay(callback, ticksDelay) {
+        return new Promise((resolve) => {
+            const currentJob = mc.system.runTimeout(() => {
+                callback();
+                mc.system.clearRun(currentJob);
+                resolve();
+            }, ticksDelay);
+        });
+    }
+    ;
+    /**
+     * Metodo auxiliar que establece una serie de eventos en concreto que se mantendran en loop.
+     * @param {() => void} callback Los eventos en concreto.
+     * @param {number} loopTicks El numero en ticks que se repetira este loop.
+     * @returns {number} Devuelve el ID de la memoria, del proceso loop creado.
+     * @author HaJuegos - 13-03-2026
+     * @systemEvent Este metodo usa los eventos system donde posiblemente puede ser beforeEvent, permitiendo la ejecucion antes de que pase.
+     * @public
+     * @example
+     * ```ts
+     * worldToolsSimplified.setLoop(() => {
+     *    console.warn('Este evento se ejecutara cada 1 segundo');
+     * } worldToolsSimplified.convertSecondsToTicks(1))
+     * ```
+     */
+    setLoop(callback, loopTicks) {
+        return mc.system.runInterval(callback, loopTicks);
+    }
+    ;
+    /**
+     * Metodo auxiliar que detiene un proceso looping creado previamente por medio de su ID generado en memoria.
+     * @param {number} runID ID del proceso generado.
+     * @author HaJuegos - 13-03-2026
+     * @systemEvent Este metodo usa los eventos system donde posiblemente puede ser beforeEvent, permitiendo la ejecucion antes de que pase.
+     * @public
+     * @example
+     * ```ts
+     * // Se crea el evento primero, generado su ID en memoria.
+     * const idLoop = worldToolsSimplified.setLoop(() => {
+     *   console.warn('este evento se esta repitiendo cada 1 segundo');
+     * } worldToolsSimplified.convertSecondsToTicks(1))
+     *
+     * // Con el ID generado en memoria, lo usamos para detenerlo cuando queramos.
+     * worldToolsSimplified.stopLoop(idLoop);
+     * ```
+     */
+    stopLoop(runID) {
+        mc.system.clearRun(runID);
+    }
     /**
      * Metodo auxiliar que envia un mensaje global al mundo en formato string o rawmessage.
      * @public
      * @param {(string | mc.RawMessage)} message Mensaje o RawMessage en concreto a enviar.
      * @author HaJuegos - 12-03-2026
+     * @example
+     * ```ts
+     * // Este es un mensaje simple
+     * worldToolsSimplified.sendMessageGlobal('hola soy un mensaje');
+     *
+     * // Este es un mensaje RawText
+     * worldToolsSimplified.sendMessageGlobal({ rawtext: 'chat.test.message' });
+     * ```
      */
     sendMessageGlobal(message) {
         mc.world.sendMessage(message);
@@ -25,6 +98,11 @@ class WorldToolsSimplified {
      * @param {number} seconds Los segundos a convertir.
      * @returns {number} Los ticks convertidos.
      * @author HaJuegos - 12-03-2026
+     * @example
+     * ```ts
+     * // 15 segundos son 300 ticks (20 ticks por segundo)
+     * const ticks = worldToolsSimplified.convertSecondsToTicks(15); // 300
+     * ```
      */
     convertSecondsToTicks(seconds) {
         return mc.TicksPerSecond * seconds;
@@ -35,6 +113,11 @@ class WorldToolsSimplified {
      * @param {number} ticks Los ticks a convertir.
      * @returns {number} Los segundos convertidos.
      * @author HaJuegos - 12-03-2026
+     * @example
+     * ```ts
+     * // 300 ticks son 15 segundos (20 ticks por segundo)
+     * const seconds = worldToolsSimplified.convertTicksToSeconds(300); // 15
+     * ```
      */
     convertTicksToSeconds(ticks) {
         return ticks / mc.TicksPerSecond;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "simplified-mojang-api",
-    "version": "0.0.7",
+    "version": "0.0.10",
     "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",
@@ -14,22 +14,13 @@
     },
     "homepage": "https://github.com/HaJuegos/simplified-mojang-API#readme",
     "files": [
-        "dist"
+        "dist",
+        "structures"
     ],
     "scripts": {
         "build": "tsc",
         "prepare": "npm run build"
     },
-    "peerDependencies": {
-        "@minecraft/debug-utilities": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/gameplay-utilities": "^1.3.0",
-        "@minecraft/server": "^2.6.0-beta.1.26.0-stable",
-        "@minecraft/server-gametest": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/server-graphics": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/server-net": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/server-ui": "^2.1.0-beta.1.26.0-stable",
-        "@minecraft/vanilla-data": "^1.26.2"
-    },
     "author": "HaJuegos",
     "license": "MIT",
     "keywords": [
@@ -43,15 +34,19 @@
         "mojang"
     ],
     "devDependencies": {
-        "@minecraft/debug-utilities": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/gameplay-utilities": "^1.3.0",
-        "@minecraft/server": "^2.6.0-beta.1.26.0-stable",
-        "@minecraft/server-gametest": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/server-graphics": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/server-net": "^1.0.0-beta.1.26.0-stable",
-        "@minecraft/server-ui": "^2.1.0-beta.1.26.0-stable",
-        "@minecraft/vanilla-data": "^1.26.2",
         "@types/node": "^25.4.0",
+        "esbuild": "^0.27.3",
+        "nodemon": "^3.1.14",
         "typescript": "^5.9.3"
+    },
+    "dependencies": {
+        "@minecraft/debug-utilities": "1.0.0-beta.1.26.0-stable",
+        "@minecraft/gameplay-utilities": "1.3.0",
+        "@minecraft/server": "2.6.0-beta.1.26.0-stable",
+        "@minecraft/server-gametest": "1.0.0-beta.1.26.0-stable",
+        "@minecraft/server-graphics": "1.0.0-beta.1.26.0-stable",
+        "@minecraft/server-net": "1.0.0-beta.1.26.0-stable",
+        "@minecraft/server-ui": "2.1.0-beta.1.26.0-stable",
+        "@minecraft/vanilla-data": "1.26.2"
     }
 }