simplified-mojang-api 0.0.6 → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,6 +7,7 @@ import * as mc from "@minecraft/server";
7
7
  declare class AfterEventsSimplified {
8
8
  private entityDieManager;
9
9
  private playerSpawnManager;
10
+ private worldLoadManager;
10
11
  /**
11
12
  * Eventos que se inicializan cuando la clase es llamada o inicializada.
12
13
  * @constructor
@@ -26,6 +27,13 @@ declare class AfterEventsSimplified {
26
27
  * @public
27
28
  */
28
29
  onPlayerSpawns(callback: (args: mc.PlayerSpawnAfterEvent) => void): void;
30
+ /**
31
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un mundo se termino de cargar de forma simplificada.
32
+ * @param {(args: mc.WorldLoadAfterEvent) => void} callback Los argumentos del evento y su logica.
33
+ * @author HaJuegos - 11-03-2026
34
+ * @public
35
+ */
36
+ onWorldReady(callback: (args: mc.WorldLoadAfterEvent) => void): void;
29
37
  }
30
38
  export declare const afterEventsSimplified: AfterEventsSimplified;
31
39
  export {};
@@ -13,6 +13,7 @@ class AfterEventsSimplified {
13
13
  constructor() {
14
14
  this.entityDieManager = new BaseEventManager(mc.world.afterEvents.entityDie, "AfterEntityDie");
15
15
  this.playerSpawnManager = new BaseEventManager(mc.world.afterEvents.playerSpawn, "AfterPlayerSpawn");
16
+ this.worldLoadManager = new BaseEventManager(mc.world.afterEvents.worldLoad, "AfterWorldLoad");
16
17
  }
17
18
  /**
18
19
  * Metodo auxiliar que ejecuta los eventos relacionado cuando una entidad muere de forma simplificada.
@@ -32,5 +33,14 @@ class AfterEventsSimplified {
32
33
  onPlayerSpawns(callback) {
33
34
  this.playerSpawnManager.register(callback);
34
35
  }
36
+ /**
37
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un mundo se termino de cargar de forma simplificada.
38
+ * @param {(args: mc.WorldLoadAfterEvent) => void} callback Los argumentos del evento y su logica.
39
+ * @author HaJuegos - 11-03-2026
40
+ * @public
41
+ */
42
+ onWorldReady(callback) {
43
+ this.worldLoadManager.register(callback);
44
+ }
35
45
  }
36
46
  export const afterEventsSimplified = new AfterEventsSimplified();
@@ -1,3 +1,4 @@
1
+ import * as mc from "@minecraft/server";
1
2
  /**
2
3
  * Clase principal que maneja los eventos before de forma simplificada para mejor manejo de errores.
3
4
  * @class BeforeEventsSimplified
@@ -5,11 +6,35 @@
5
6
  * @export
6
7
  */
7
8
  declare class BeforeEventsSimplified {
9
+ private startUpManager;
10
+ private shutDownManager;
11
+ private interactBlockManager;
8
12
  /**
9
13
  * Eventos que se inicializan cuando la clase es llamada o inicializada.
10
14
  * @constructor
11
15
  */
12
16
  constructor();
17
+ /**
18
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando el add-on se carga por primera vez
19
+ * @param {(args: mc.StartupEvent) => void} callback Los argumentos del evento y su logica.
20
+ * @author HaJuegos - 11-03-2026
21
+ * @public
22
+ */
23
+ onAddonStarts(callback: (args: mc.StartupEvent) => void): void;
24
+ /**
25
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un mundo o servidor se cierra de forma simplificada.
26
+ * @param {(args: mc.ShutdownEvent) => void} callback Los argumentos del evento y su logica.
27
+ * @author HaJuegos - 11-03-2026
28
+ * @public
29
+ */
30
+ onAddonStops(callback: (args: mc.ShutdownEvent) => void): void;
31
+ /**
32
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando se interactua con un bloque antes de que pase de forma simplificada.
33
+ * @param {(args: mc.PlayerInteractWithBlockBeforeEvent) => void} callback Los argumentos del evento y su logica.
34
+ * @author HaJuegos - 11-03-2026
35
+ * @public
36
+ */
37
+ onInteractBlock(callback: (args: mc.PlayerInteractWithBlockBeforeEvent) => void): void;
13
38
  }
14
39
  export declare const beforeEventsSimplified: BeforeEventsSimplified;
15
40
  export {};
@@ -1,3 +1,5 @@
1
+ import { BaseEventManager } from "../core/eventsManager";
2
+ import * as mc from "@minecraft/server";
1
3
  /**
2
4
  * Clase principal que maneja los eventos before de forma simplificada para mejor manejo de errores.
3
5
  * @class BeforeEventsSimplified
@@ -9,6 +11,37 @@ class BeforeEventsSimplified {
9
11
  * Eventos que se inicializan cuando la clase es llamada o inicializada.
10
12
  * @constructor
11
13
  */
12
- constructor() { }
14
+ constructor() {
15
+ this.startUpManager = new BaseEventManager(mc.system.beforeEvents.startup, "BeforeStartup");
16
+ this.shutDownManager = new BaseEventManager(mc.system.beforeEvents.shutdown, "BeforeShutdown");
17
+ this.interactBlockManager = new BaseEventManager(mc.world.beforeEvents.playerInteractWithBlock, "BeforeInteractBlock");
18
+ }
19
+ /**
20
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando el add-on se carga por primera vez
21
+ * @param {(args: mc.StartupEvent) => void} callback Los argumentos del evento y su logica.
22
+ * @author HaJuegos - 11-03-2026
23
+ * @public
24
+ */
25
+ onAddonStarts(callback) {
26
+ this.startUpManager.register(callback);
27
+ }
28
+ /**
29
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un mundo o servidor se cierra de forma simplificada.
30
+ * @param {(args: mc.ShutdownEvent) => void} callback Los argumentos del evento y su logica.
31
+ * @author HaJuegos - 11-03-2026
32
+ * @public
33
+ */
34
+ onAddonStops(callback) {
35
+ this.shutDownManager.register(callback);
36
+ }
37
+ /**
38
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando se interactua con un bloque antes de que pase de forma simplificada.
39
+ * @param {(args: mc.PlayerInteractWithBlockBeforeEvent) => void} callback Los argumentos del evento y su logica.
40
+ * @author HaJuegos - 11-03-2026
41
+ * @public
42
+ */
43
+ onInteractBlock(callback) {
44
+ this.interactBlockManager.register(callback);
45
+ }
13
46
  }
14
47
  export const beforeEventsSimplified = new BeforeEventsSimplified();
@@ -10,6 +10,32 @@ declare class WorldToolsSimplified {
10
10
  * @constructor
11
11
  */
12
12
  constructor();
13
+ /**
14
+ * 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.
15
+ * @param {() => void} callback Los eventos en cuestion a ejecutar.
16
+ * @param {number} ticksDelay Los tiempos en ticks que se tardara para ejecutarse.
17
+ * @returns {Promise<void>}
18
+ * @author HaJuegos - 13-03-2026
19
+ * @async Es un metodo asincrono, debido a que se limpia despues de la ejecucion.
20
+ * @public
21
+ */
22
+ setDelay(callback: () => void, ticksDelay: number): Promise<void>;
23
+ /**
24
+ * Metodo auxiliar que establece una serie de eventos en concreto que se mantendran en loop.
25
+ * @param {() => void} callback Los eventos en concreto.
26
+ * @param {number} loopTicks El numero en ticks que se repetira este loop.
27
+ * @returns {number} Devuelve el ID de la memoria, del proceso loop creado.
28
+ * @author HaJuegos - 13-03-2026
29
+ * @public
30
+ */
31
+ setLoop(callback: () => void, loopTicks: number): number;
32
+ /**
33
+ * Metodo auxiliar que detiene un proceso looping creado previamente por medio de su ID generado en memoria.
34
+ * @param {number} runID ID del proceso generado.
35
+ * @author HaJuegos - 13-03-2026
36
+ * @public
37
+ */
38
+ stopLoop(runID: number): void;
13
39
  /**
14
40
  * Metodo auxiliar que envia un mensaje global al mundo en formato string o rawmessage.
15
41
  * @public
@@ -10,6 +10,46 @@ class WorldToolsSimplified {
10
10
  * @constructor
11
11
  */
12
12
  constructor() { }
13
+ /**
14
+ * 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.
15
+ * @param {() => void} callback Los eventos en cuestion a ejecutar.
16
+ * @param {number} ticksDelay Los tiempos en ticks que se tardara para ejecutarse.
17
+ * @returns {Promise<void>}
18
+ * @author HaJuegos - 13-03-2026
19
+ * @async Es un metodo asincrono, debido a que se limpia despues de la ejecucion.
20
+ * @public
21
+ */
22
+ async setDelay(callback, ticksDelay) {
23
+ return new Promise((resolve) => {
24
+ const currentJob = mc.system.runTimeout(() => {
25
+ callback();
26
+ mc.system.clearRun(currentJob);
27
+ resolve();
28
+ }, ticksDelay);
29
+ });
30
+ }
31
+ ;
32
+ /**
33
+ * Metodo auxiliar que establece una serie de eventos en concreto que se mantendran en loop.
34
+ * @param {() => void} callback Los eventos en concreto.
35
+ * @param {number} loopTicks El numero en ticks que se repetira este loop.
36
+ * @returns {number} Devuelve el ID de la memoria, del proceso loop creado.
37
+ * @author HaJuegos - 13-03-2026
38
+ * @public
39
+ */
40
+ setLoop(callback, loopTicks) {
41
+ return mc.system.runInterval(callback, loopTicks);
42
+ }
43
+ ;
44
+ /**
45
+ * Metodo auxiliar que detiene un proceso looping creado previamente por medio de su ID generado en memoria.
46
+ * @param {number} runID ID del proceso generado.
47
+ * @author HaJuegos - 13-03-2026
48
+ * @public
49
+ */
50
+ stopLoop(runID) {
51
+ mc.system.clearRun(runID);
52
+ }
13
53
  /**
14
54
  * Metodo auxiliar que envia un mensaje global al mundo en formato string o rawmessage.
15
55
  * @public
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "simplified-mojang-api",
3
- "version": "0.0.6",
3
+ "version": "0.0.8",
4
4
  "description": "About Public repository to simplify the event logic of Mojang's Script API, for informal or professional use",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",