simplified-mojang-api 0.0.21 → 0.0.22

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.
@@ -16,6 +16,12 @@ declare class AfterEventsSimplified {
16
16
  private onHitEntityManager;
17
17
  private onEntityHurtManager;
18
18
  private onHealthEntityChangeManager;
19
+ private onChangeDimensionManager;
20
+ private interactEntityManager;
21
+ private interactBlockManager;
22
+ private entitySpawnsManager;
23
+ private effectAddManager;
24
+ private placeBlockManager;
19
25
  /**
20
26
  * Eventos que se inicializan cuando la clase es llamada o inicializada.
21
27
  * @constructor
@@ -193,6 +199,100 @@ declare class AfterEventsSimplified {
193
199
  * ```
194
200
  */
195
201
  onHealthEntityChange(callback: (args: mc.EntityHealthChangedAfterEvent) => void): void;
202
+ /**
203
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador cambia de dimension de forma simplificada.
204
+ * @param {(args: mc.PlayerDimensionChangeAfterEvent) => void} callback Los eventos relacionados a ejecutar.
205
+ * @author HaJuegos - 20-03-2026
206
+ * @public
207
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
208
+ * @example
209
+ * ```ts
210
+ * afterEventsSimplified.onChangeDimension((args) => {
211
+ * const ply = args.player;
212
+ * const fromDime = args.fromDimension;
213
+ * const toDime = args.toDimension;
214
+ *
215
+ * console.warn(`${ply.name} estaba en el ${fromDime.id} y ahora esta en ${toDime.id}.`);
216
+ * });
217
+ * ```
218
+ */
219
+ onChangeDimension(callback: (args: mc.PlayerDimensionChangeAfterEvent) => void): void;
220
+ /**
221
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador interactuo con una entidad de forma simplificada.
222
+ * @param {(args: mc.PlayerInteractWithEntityAfterEvent) => void} callback Los eventos relacionados a ejecutar.
223
+ * @author HaJuegos - 20-03-2026
224
+ * @public
225
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
226
+ * @example
227
+ * ```ts
228
+ * afterEventsSimplified.onInteractEntity((args) => {
229
+ * const ply = args.player;
230
+ * const hitEntity = args.target;
231
+ *
232
+ * console.warn(`${ply.name} interactuo con ${hitEntity.typeId}.`);
233
+ * });
234
+ * ```
235
+ */
236
+ onInteractEntity(callback: (args: mc.PlayerInteractWithEntityAfterEvent) => void): void;
237
+ /**
238
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador interactuo con un bloque de forma simplificada.
239
+ * @param {(args: mc.PlayerInteractWithBlockAfterEvent) => void} callback Los eventos relacionados a ejecutar.
240
+ * @author HaJuegos - 20-03-2026
241
+ * @public
242
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
243
+ * @example
244
+ * ```ts
245
+ * afterEventsSimplified.onInteractBlock((args) => {
246
+ * const ply = args.player;
247
+ * const block = args.block;
248
+ *
249
+ * console.warn(`${ply.name} interactuo con el bloque ${block.typeId}.`);
250
+ * });
251
+ * ```
252
+ */
253
+ onInteractBlock(callback: (args: mc.PlayerInteractWithBlockAfterEvent) => void): void;
254
+ /**
255
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando una entidad spawnea de forma simplificada.
256
+ * @param {(args: mc.EntitySpawnAfterEvent) => void} callback Los eventos relacionados.
257
+ * @author HaJuegos - 20-03-2026
258
+ * @public
259
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
260
+ * @example
261
+ * ```ts
262
+ * afterEventsSimplified.onEntitySpawns((args) => {
263
+ * console.warn(`${args.entity.typeId} ha spawneado en el mundo`);
264
+ * });
265
+ * ```
266
+ */
267
+ onEntitySpawns(callback: (args: mc.EntitySpawnAfterEvent) => void): void;
268
+ /**
269
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un efecto es añadido en una entidad o jugador de forma simplificada.
270
+ * @param {(args: mc.EffectAddAfterEvent) => void} callback Los eventos relacionados.
271
+ * @author HaJuegos - 20-03-2026
272
+ * @public
273
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
274
+ * @example
275
+ * ```ts
276
+ * afterEventsSimplified.onAddsEffect((args) => {
277
+ * console.warn(`${args.entity.typeId} ahora tiene el efecto ${args.effect.displayName}.`);
278
+ * });
279
+ * ```
280
+ */
281
+ onAddsEffect(callback: (args: mc.EffectAddAfterEvent) => void): void;
282
+ /**
283
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un bloque es colocando de forma simplificada.
284
+ * @param {(args: mc.PlayerPlaceBlockAfterEvent) => void} callback Los eventos relacionados.
285
+ * @author HaJuegos - 20-03-2026
286
+ * @public
287
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
288
+ * @example
289
+ * ```ts
290
+ * afterEventsSimplified.onPlaceBlock((args) => {
291
+ * console.warn(`${args.player.name} coloco el bloque ${args.block.typeId}.`);
292
+ * });
293
+ * ```
294
+ */
295
+ onPlaceBlock(callback: (args: mc.PlayerPlaceBlockAfterEvent) => void): void;
196
296
  }
197
297
  export declare const afterEventsSimplified: AfterEventsSimplified;
198
298
  export {};
@@ -22,6 +22,12 @@ class AfterEventsSimplified {
22
22
  this.onHitEntityManager = new BaseEventManager(mc.world.afterEvents.entityHitEntity, "AfterHitEntity");
23
23
  this.onEntityHurtManager = new BaseEventManager(mc.world.afterEvents.entityHurt, "AfterHurtEntity");
24
24
  this.onHealthEntityChangeManager = new BaseEventManager(mc.world.afterEvents.entityHealthChanged, "AfterHealthChangeEntity");
25
+ this.onChangeDimensionManager = new BaseEventManager(mc.world.afterEvents.playerDimensionChange, "AfterChangeDimension");
26
+ this.interactEntityManager = new BaseEventManager(mc.world.afterEvents.playerInteractWithEntity, "AfterInteractEntity");
27
+ this.interactBlockManager = new BaseEventManager(mc.world.afterEvents.playerInteractWithBlock, "AfterInteractBlock");
28
+ this.entitySpawnsManager = new BaseEventManager(mc.world.afterEvents.entitySpawn, "AfterEntitySpawns");
29
+ this.effectAddManager = new BaseEventManager(mc.world.afterEvents.effectAdd, "AfterEffectAdd");
30
+ this.placeBlockManager = new BaseEventManager(mc.world.afterEvents.playerPlaceBlock, "AfterPlaceBlock");
25
31
  }
26
32
  /**
27
33
  * Metodo auxiliar que ejecuta los eventos relacionado cuando una entidad muere de forma simplificada.
@@ -217,5 +223,112 @@ class AfterEventsSimplified {
217
223
  onHealthEntityChange(callback) {
218
224
  this.onHealthEntityChangeManager.register(callback);
219
225
  }
226
+ /**
227
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador cambia de dimension de forma simplificada.
228
+ * @param {(args: mc.PlayerDimensionChangeAfterEvent) => void} callback Los eventos relacionados a ejecutar.
229
+ * @author HaJuegos - 20-03-2026
230
+ * @public
231
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
232
+ * @example
233
+ * ```ts
234
+ * afterEventsSimplified.onChangeDimension((args) => {
235
+ * const ply = args.player;
236
+ * const fromDime = args.fromDimension;
237
+ * const toDime = args.toDimension;
238
+ *
239
+ * console.warn(`${ply.name} estaba en el ${fromDime.id} y ahora esta en ${toDime.id}.`);
240
+ * });
241
+ * ```
242
+ */
243
+ onChangeDimension(callback) {
244
+ this.onChangeDimensionManager.register(callback);
245
+ }
246
+ ;
247
+ /**
248
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador interactuo con una entidad de forma simplificada.
249
+ * @param {(args: mc.PlayerInteractWithEntityAfterEvent) => void} callback Los eventos relacionados a ejecutar.
250
+ * @author HaJuegos - 20-03-2026
251
+ * @public
252
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
253
+ * @example
254
+ * ```ts
255
+ * afterEventsSimplified.onInteractEntity((args) => {
256
+ * const ply = args.player;
257
+ * const hitEntity = args.target;
258
+ *
259
+ * console.warn(`${ply.name} interactuo con ${hitEntity.typeId}.`);
260
+ * });
261
+ * ```
262
+ */
263
+ onInteractEntity(callback) {
264
+ this.interactEntityManager.register(callback);
265
+ }
266
+ /**
267
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador interactuo con un bloque de forma simplificada.
268
+ * @param {(args: mc.PlayerInteractWithBlockAfterEvent) => void} callback Los eventos relacionados a ejecutar.
269
+ * @author HaJuegos - 20-03-2026
270
+ * @public
271
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
272
+ * @example
273
+ * ```ts
274
+ * afterEventsSimplified.onInteractBlock((args) => {
275
+ * const ply = args.player;
276
+ * const block = args.block;
277
+ *
278
+ * console.warn(`${ply.name} interactuo con el bloque ${block.typeId}.`);
279
+ * });
280
+ * ```
281
+ */
282
+ onInteractBlock(callback) {
283
+ this.interactBlockManager.register(callback);
284
+ }
285
+ /**
286
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando una entidad spawnea de forma simplificada.
287
+ * @param {(args: mc.EntitySpawnAfterEvent) => void} callback Los eventos relacionados.
288
+ * @author HaJuegos - 20-03-2026
289
+ * @public
290
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
291
+ * @example
292
+ * ```ts
293
+ * afterEventsSimplified.onEntitySpawns((args) => {
294
+ * console.warn(`${args.entity.typeId} ha spawneado en el mundo`);
295
+ * });
296
+ * ```
297
+ */
298
+ onEntitySpawns(callback) {
299
+ this.entitySpawnsManager.register(callback);
300
+ }
301
+ /**
302
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un efecto es añadido en una entidad o jugador de forma simplificada.
303
+ * @param {(args: mc.EffectAddAfterEvent) => void} callback Los eventos relacionados.
304
+ * @author HaJuegos - 20-03-2026
305
+ * @public
306
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
307
+ * @example
308
+ * ```ts
309
+ * afterEventsSimplified.onAddsEffect((args) => {
310
+ * console.warn(`${args.entity.typeId} ahora tiene el efecto ${args.effect.displayName}.`);
311
+ * });
312
+ * ```
313
+ */
314
+ onAddsEffect(callback) {
315
+ this.effectAddManager.register(callback);
316
+ }
317
+ /**
318
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un bloque es colocando de forma simplificada.
319
+ * @param {(args: mc.PlayerPlaceBlockAfterEvent) => void} callback Los eventos relacionados.
320
+ * @author HaJuegos - 20-03-2026
321
+ * @public
322
+ * @afterEvent Metodo que detecta el evento despues de que suceda. Obteniendo la informacion sin permitir modificarla en su mayoria.
323
+ * @example
324
+ * ```ts
325
+ * afterEventsSimplified.onPlaceBlock((args) => {
326
+ * console.warn(`${args.player.name} coloco el bloque ${args.block.typeId}.`);
327
+ * });
328
+ * ```
329
+ */
330
+ onPlaceBlock(callback) {
331
+ this.placeBlockManager.register(callback);
332
+ }
220
333
  }
221
334
  export const afterEventsSimplified = new AfterEventsSimplified();
@@ -12,6 +12,9 @@ declare class BeforeEventsSimplified {
12
12
  private chatSendManager;
13
13
  private itemUseManager;
14
14
  private explosionManager;
15
+ private interactEntityManager;
16
+ private effectAddManager;
17
+ private placeBlockManager;
15
18
  /**
16
19
  * Eventos que se inicializan cuando la clase es llamada o inicializada.
17
20
  * @constructor
@@ -108,6 +111,55 @@ declare class BeforeEventsSimplified {
108
111
  * ```
109
112
  */
110
113
  onExplosion(callback: (args: mc.ExplosionBeforeEvent) => void): void;
114
+ /**
115
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador va a interactuar con una entidad de forma simplificada.
116
+ * @param {(args: mc.PlayerInteractWithEntityBeforeEvent) => void} callback Los eventos relacionados a ejecutar.
117
+ * @author HaJuegos - 20-03-2026
118
+ * @public
119
+ * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
120
+ * @example
121
+ * ```ts
122
+ * beforeEventsSimplified.onInteractEntity((args) => {
123
+ * const ply = args.player;
124
+ * const hitEntity = args.target;
125
+ *
126
+ * console.warn(`${ply.name} esta interactuando con ${hitEntity.typeId}.`);
127
+ *
128
+ * args.cancel = true; // ya no se puede.
129
+ * });
130
+ * ```
131
+ */
132
+ onInteractEntity(callback: (args: mc.PlayerInteractWithEntityBeforeEvent) => void): void;
133
+ /**
134
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un efecto esta apunto de darse a una entidad de forma simplificada.
135
+ * @param {(args: mc.EffectAddBeforeEvent) => void} callback Los eventos relacionados.
136
+ * @author HaJuegos - 20-03-2026
137
+ * @public
138
+ * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
139
+ * @example
140
+ * ```ts
141
+ * beforeEventsSimplified.onEffectAdds((args) => {
142
+ * console.warn(`${args.entity.typeId} tendra el efecto ${args.effect.displayName}.`);
143
+ * args.cancel = true; // Ahora ya no sucede.
144
+ * });
145
+ * ```
146
+ */
147
+ onEffectAdds(callback: (args: mc.EffectAddBeforeEvent) => void): void;
148
+ /**
149
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador va a colocar un bloque de forma simplificada.
150
+ * @param {(args: mc.PlayerPlaceBlockBeforeEvent) => void} callback Los eventos relacionados.
151
+ * @author HaJuegos - 20-03-2026
152
+ * @public
153
+ * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
154
+ * @example
155
+ * ```ts
156
+ * beforeEventsSimplified.onPlaceBlock((args) => {
157
+ * console.warn(`${args.player.name} va a colocar el bloque ${args.block.typeId}.`);
158
+ * args.cancel = true; // Ahora ya no puede colocarlo
159
+ * });
160
+ * ```
161
+ */
162
+ onPlaceBlock(callback: (args: mc.PlayerPlaceBlockBeforeEvent) => void): void;
111
163
  /**
112
164
  * Metodo auxiliar que registra y ejecuta los eventos relacionados cuando se quiere registrar un custom component de un bloque.
113
165
  * @param {string} nameComponent Nombre del componente en cuestion a registrar.
@@ -18,6 +18,9 @@ class BeforeEventsSimplified {
18
18
  this.chatSendManager = new BaseEventManager(mc.world.beforeEvents.chatSend, "BeforeChatSend");
19
19
  this.itemUseManager = new BaseEventManager(mc.world.beforeEvents.itemUse, "BeforeItemUse");
20
20
  this.explosionManager = new BaseEventManager(mc.world.beforeEvents.explosion, "BeforeExplodes");
21
+ this.interactEntityManager = new BaseEventManager(mc.world.beforeEvents.playerInteractWithEntity, "BeforeInteractEntity");
22
+ this.effectAddManager = new BaseEventManager(mc.world.beforeEvents.effectAdd, "BeforeAddEffect");
23
+ this.placeBlockManager = new BaseEventManager(mc.world.beforeEvents.playerPlaceBlock, "BeforePlayerPlaceBlock");
21
24
  }
22
25
  /**
23
26
  * Metodo auxiliar que ejecuta los eventos relacionados cuando el add-on se carga por primera vez
@@ -122,6 +125,62 @@ class BeforeEventsSimplified {
122
125
  onExplosion(callback) {
123
126
  this.explosionManager.register(callback);
124
127
  }
128
+ /**
129
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador va a interactuar con una entidad de forma simplificada.
130
+ * @param {(args: mc.PlayerInteractWithEntityBeforeEvent) => void} callback Los eventos relacionados a ejecutar.
131
+ * @author HaJuegos - 20-03-2026
132
+ * @public
133
+ * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
134
+ * @example
135
+ * ```ts
136
+ * beforeEventsSimplified.onInteractEntity((args) => {
137
+ * const ply = args.player;
138
+ * const hitEntity = args.target;
139
+ *
140
+ * console.warn(`${ply.name} esta interactuando con ${hitEntity.typeId}.`);
141
+ *
142
+ * args.cancel = true; // ya no se puede.
143
+ * });
144
+ * ```
145
+ */
146
+ onInteractEntity(callback) {
147
+ this.interactEntityManager.register(callback);
148
+ }
149
+ /**
150
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un efecto esta apunto de darse a una entidad de forma simplificada.
151
+ * @param {(args: mc.EffectAddBeforeEvent) => void} callback Los eventos relacionados.
152
+ * @author HaJuegos - 20-03-2026
153
+ * @public
154
+ * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
155
+ * @example
156
+ * ```ts
157
+ * beforeEventsSimplified.onEffectAdds((args) => {
158
+ * console.warn(`${args.entity.typeId} tendra el efecto ${args.effect.displayName}.`);
159
+ * args.cancel = true; // Ahora ya no sucede.
160
+ * });
161
+ * ```
162
+ */
163
+ onEffectAdds(callback) {
164
+ this.effectAddManager.register(callback);
165
+ }
166
+ /**
167
+ * Metodo auxiliar que ejecuta los eventos relacionados cuando un jugador va a colocar un bloque de forma simplificada.
168
+ * @param {(args: mc.PlayerPlaceBlockBeforeEvent) => void} callback Los eventos relacionados.
169
+ * @author HaJuegos - 20-03-2026
170
+ * @public
171
+ * @beforeEvent Metodo que detecta el evento antes de que suceda. Permitiendo cancelar o personalizar el evento antes de que se vea en el juego.
172
+ * @example
173
+ * ```ts
174
+ * beforeEventsSimplified.onPlaceBlock((args) => {
175
+ * console.warn(`${args.player.name} va a colocar el bloque ${args.block.typeId}.`);
176
+ * args.cancel = true; // Ahora ya no puede colocarlo
177
+ * });
178
+ * ```
179
+ */
180
+ onPlaceBlock(callback) {
181
+ this.placeBlockManager.register(callback);
182
+ }
183
+ // Metodos no auxiliares
125
184
  /**
126
185
  * Metodo auxiliar que registra y ejecuta los eventos relacionados cuando se quiere registrar un custom component de un bloque.
127
186
  * @param {string} nameComponent Nombre del componente en cuestion a registrar.
@@ -91,7 +91,7 @@ declare class WorldToolsSimplified {
91
91
  /**
92
92
  * Metodo auxiliar que envia un mensaje global al mundo en formato string o rawmessage.
93
93
  * @public
94
- * @param {(string | mc.RawMessage)} message Mensaje o RawMessage en concreto a enviar.
94
+ * @param {string | mc.RawMessage | (string | mc.RawMessage)[]} message Mensaje o RawMessage en concreto a enviar.
95
95
  * @author HaJuegos - 12-03-2026
96
96
  * @example
97
97
  * ```ts
@@ -102,7 +102,7 @@ declare class WorldToolsSimplified {
102
102
  * worldToolsSimplified.sendMessageGlobal({ rawtext: 'chat.test.message' });
103
103
  * ```
104
104
  */
105
- sendMessageGlobal(message: string | mc.RawMessage): void;
105
+ sendMessageGlobal(message: string | mc.RawMessage | (string | mc.RawMessage)[]): void;
106
106
  /**
107
107
  * Metodo auxiliar que maneja la logica de los eventos cuando se ejecuta el comando scriptevent.
108
108
  * @param {((args: mc.ScriptEventCommandMessageAfterEvent) => void)} callback La logica del evento en concreto.
@@ -115,7 +115,7 @@ class WorldToolsSimplified {
115
115
  /**
116
116
  * Metodo auxiliar que envia un mensaje global al mundo en formato string o rawmessage.
117
117
  * @public
118
- * @param {(string | mc.RawMessage)} message Mensaje o RawMessage en concreto a enviar.
118
+ * @param {string | mc.RawMessage | (string | mc.RawMessage)[]} message Mensaje o RawMessage en concreto a enviar.
119
119
  * @author HaJuegos - 12-03-2026
120
120
  * @example
121
121
  * ```ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "simplified-mojang-api",
3
- "version": "0.0.21",
3
+ "version": "0.0.22",
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",