import * as mc from "@minecraft/server";
import * as vanilla from "@minecraft/vanilla-data";
import { CustomFloatingTextParams } from "../core/customTypes";
/**
 * Clase principal que otorga simplificaciones de las llamadas de world y sus utilidades de sus llamadas y/o variables.
 * @class WorldToolsSimplified
 * @author HaJuegos - 12-03-2026
 */
declare class WorldToolsSimplified {
    private scriptEventManager;
    /**
     * Eventos que se inicializan cuando la clase es llamada o inicializada.
     * @constructor
     */
    constructor();
    /**
     * Método auxiliar que programa la ejecución de una lógica para el siguiente tick del juego. Ideal principalmente para los eventos before para saltarse la ejecución restringida.
     * @param {() => void} callback Los eventos o lógica en cuestión a ejecutar.
     * @returns {Promise<void>}
     * @author HaJuegos - 15-03-2026
     * @async Es un método asíncrono, principalmente para terminar el flujo después de que ocurra los eventos.
     * @public
     * @systemEvent Método que usa los eventos del módulo "system" herramientas auxiliares fuera de los eventos sensores de "world".
     * @example
     * ```ts
     * beforeEventsSimplified.onUseItem((args) => {
     *    const ply = args.source;
     *    const item = args.itemStack;
     *    const plyArmor = ply.getComponent(EntityComponentTypes.Equippable)
     *
     *    worldToolsSimplified.setRun(() => {
     *        // Esto ya funciona porque pasa después de un tick y no hay restricciones.
     *        plyArmor.setEquipment(EquipmentSlot.Offhand, item);
     *    });
     * });
     * ```
     */
    setRun(callback: () => void): Promise<void>;
    /**
     * Método 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 cuestión a ejecutar.
     * @param {number} ticksDelay Los tiempos en ticks que se tardará para ejecutarse.
     * @returns {Promise<void>}
     * @author HaJuegos - 13-03-2026
     * @async Es un método asíncrono, debido a que se limpia después de la ejecución.
     * @public
     * @systemEvent Método que usa los eventos del módulo "system" herramientas auxiliares fuera de los eventos sensores de "world".
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * worldToolsSimplified.setDelay(() => {
     *    console.warn('Este evento se ejecutará después de 5 segundos');
     * } worldToolsSimplified.convertSecondsToTicks(5))
     * ```
     */
    setDelay(callback: () => void, ticksDelay: number): Promise<void>;
    /**
     * Método auxiliar que establece una serie de eventos en concreto que se mantendrán en loop.
     * @param {() => void} callback Los eventos en concreto.
     * @param {number} loopTicks El número en ticks que se repetirá este loop.
     * @returns {number} Devuelve el ID de la memoria, del proceso loop creado.
     * @author HaJuegos - 13-03-2026
     * @public
     * @systemEvent Método que usa los eventos del módulo "system" herramientas auxiliares fuera de los eventos sensores de "world".
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * worldToolsSimplified.setLoop(() => {
     *    console.warn('Este evento se ejecutará cada 1 segundo');
     * } worldToolsSimplified.convertSecondsToTicks(1))
     * ```
     */
    setLoop(callback: () => void, loopTicks: number): number;
    /**
     * Método 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
     * @public
     * @systemEvent Método que usa los eventos del módulo "system" herramientas auxiliares fuera de los eventos sensores de "world".
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @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;
    /**
     * Método auxiliar que envía un mensaje global al mundo en formato string o rawmessage.
     * @public
     * @param {string | mc.RawMessage | (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 | (string | mc.RawMessage)[]): void;
    /**
     * Método auxiliar que maneja la lógica de los eventos cuando se ejecuta el comando scriptevent.
     * @param {((args: mc.ScriptEventCommandMessageAfterEvent) => void)} callback La lógica del evento en concreto.
     * @author HaJuegos - 14-03-2026
     * @public
     * @systemEvent Método que usa los eventos del módulo "system" herramientas auxiliares fuera de los eventos sensores de "world".
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * worldToolsSimplified.listenerScriptEvents((args) => {
     *   console.warn(`Se ha ejecutado el comando /scriptevent con el ID ${args.id}`)
     * });
     * ```
     */
    listenerScriptEvents(callback: ((args: mc.ScriptEventCommandMessageAfterEvent) => void)): void;
    /**
     * Método auxiliar que obtiene un objective de scoreboard, en caso de no encontrarlo, pues lo crea. Para devolver el mismo objectivo de forma simplificada.
     * @param {string} idObj ID del objectivo a encontrar o crear en cuestión.
     * @param {?string} [nameDisplayObj] (Opcional) Nombre del objectivo a colocar cuando se cree.
     * @returns {(mc.ScoreboardObjective | undefined)} Devuelve el objectivo si todo salió correcto, sino será un error.
     * @author HaJuegos - 31-03-2026
     * @public
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * // Esto obtiene y crea el objectivo en caso de no estar creado.
     * const obj = worldToolsSimplified.getOrCreateScorebordObj('conteo', 'Conteo');
     * ```
     */
    getOrCreateScorebordObj(idObj: string, nameDisplayObj?: string): mc.ScoreboardObjective | undefined;
    /**
     * Método auxiliar que obtiene el score de un jugador en concreto de un objective de scoreboard. En caso de que el objective no esté creado, se creará. De forma simplificada.
     * @param {mc.Entity | mc.Player | string} targetEntity Target en concreto a obtener su score.
     * @param {string} idObj ID del objectivo el concreto a obtener el score.
     * @param {?string} [nameDisplayObj] (Opcional) Nombre del objectivo en caso de que el mismo no esté creado, a asignar.
     * @returns {number} Devuelve el score total que tiene el jugador si todo esta bien, sino siempre será 0.
     * @author HaJuegos - 31-03-2026
     * @public
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * // Esto crea el objective en caso de no estar creado y luego, obtiene el score que tiene el jugador, en este caso sería 0.
     * const score = worldToolsSimplified.getPlyScoreInObj(ply, 'conteo', 'Conteo');
     * ```
     */
    getScoreInObj(targetEntity: mc.Player | mc.Entity | string, idObj: string, nameDisplayObj?: string): number;
    /**
     * Método auxiliar que modifica el score de un jugador en concreto en un objectivo. En caso de que no esté creado el objectivo, se creará automáticamente. De forma simplificada.
     * @param {mc.Entity | mc.Player | string} targetEntity Target en concreto a modificar.
     * @param {string} idObj ID del objectivo en concreto.
     * @param {('set' | 'add')} changeMode Método específico a modificar del jugador. En caso de set, es que sería un valor no acumulable. Por ej: si antes tenía uno y se establece 2, pues será 2 sin más; Caso contrario con add, que es acumulativo y sirve fórmulas negativas. Por ej: Misma situación, donde tienes 1 y adicionas 1 más, pues dará 2.
     * @param {number} newScore El nuevo valor a añadir o cambiar.
     * @param {?string} [nameDisplayObj] (Opcional) Nombre del objectivo en caso de no estar creado.
     * @returns {(number | undefined)} El nuevo score cambiado del jugador si todo sale correcto, sino será un error.
     * @author HaJuegos - 31-03-2026
     * @public
     * @example
     * ```ts
     * // Este método realizará lo siguiente: En caso de que conteo no exista como objectivo, lo crea, luego, establece al jugador en concreto 1 en el objectivo y por último, devuelve dicho valor modificado.
     * const newScore = worldToolsSimplified.changePlyScoreInObj(player, 'conteo', 'set', 1, 'Conteo');
     * ```
     */
    changeScoreInObj(targetEntity: mc.Player | mc.Entity | string, idObj: string, changeMode: 'set' | 'add', newScore: number, nameDisplayObj?: string): number | undefined;
    /**
     * Método auxiliar que muestra un objective creado en concreto, en caso de no estar creado, lo hará; A una zona de la pantalla, ya sea como sidebar o list de forma simplificada.
     * @param {string} idObj ID del objective en cuestión a obtener o crear.
     * @param {mc.DisplaySlotId} displaySlot Slot donde se establecerá el objectivo.
     * @param {?string} [nameDisplayObj] (Opcional) Nombre del objectivo que tendrá en caso de que no esté creado.
     * @param {?mc.ObjectiveSortOrder} [order] (Opcional) Orden del mismo objectivo.
     * @author HaJuegos - 31-03-2026
     * @public
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * // Esto mostrará a conteo en el sidebar de la pantalla de orden descendente. En caso de no estar creado, lo crea primero.
     * worldToolsSimplified.setObjInDisplay('conteo', mc.DisplaySlotId.Sidebar, 'Conteo', mc.ObjectiveSortOrder.Descending);
     * ```
     */
    setObjInDisplay(idObj: string, displaySlot: mc.DisplaySlotId, nameDisplayObj?: string, order?: mc.ObjectiveSortOrder): void;
    /**
     * Método auxiliar que limpia los objectives asignados a una parte de la pantallas de forma simplificada.
     * @param {mc.DisplaySlotId} displaySlot El slot a limpiar en cuestión.
     * @author HaJuegos - 31-03-2026
     * @public
     * @afterEvent Método que detecta el evento después de que suceda. Obteniendo la información sin permitir modificarla en su mayoría.
     * @example
     * ```ts
     * // Se quita al objective que se mostraba en sidebar.
     * worldToolsSimplified.removeDisplaySlot(mc.DisplaySlotId.Sidebar);
     * ```
     */
    removeDisplaySlot(displaySlot: mc.DisplaySlotId): void;
    /**
     * Método auxiliar que convierte segundos a ticks de forma simple.
     * @public
     * @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;
    /**
     * Método auxiliar que convierte ticks a segundos de forma simple.
     * @public
     * @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;
    /**
     * Método auxiliar que convierte un color hexadecimal a RGB.
     * @param {string} hexcolor El color hexadecimal (ej. "#00000F").
     * @returns {mc.RGB} El objeto RGB correspondiente.
     * @author HaJuegos - 14-03-2026
     * @public
     * @example
     * ```ts
     * const rgb = worldToolsSimplified.convertHexToRGB("#FF0000"); // { red: 255, green: 0, blue: 0 }
     * ```
     */
    convertHexToRGB(hexcolor: string): mc.RGB;
    /**
     * Método auxiliar que convierte un color hexadecimal a RGBA.
     * @param {string} hexcolor El color hexadecimal (ej. "#00000FFF" para 8 dígitos, o "#00000F" asumiendo a=255).
     * @returns {mc.RGBA} El objeto RGBA correspondiente.
     * @author HaJuegos - 14-03-2026
     * @public
     * @example
     * ```ts
     * const rgba = worldToolsSimplified.convertHexToRGBA("#FF0000FF"); // { red: 255, green: 0, blue: 0, alpha: 255 }
     * const rgba2 = worldToolsSimplified.convertHexToRGBA("#FF0000"); // { red: 255, green: 0, blue: 0, alpha: 255 }
     * ```
     */
    convertHexToRGBA(hexcolor: string): mc.RGBA;
    /**
     * Método auxiliar que obtiene los datos de una propiedad dinámica en concreto guardado en el mundo.
     * @param {string} idProperty ID de la propiedad en concreto.
     * @returns {(string | number | boolean | mc.Vector3 | undefined)} Los datos guardados en la propiedad, en caso de no estar creada, será undefined.
     * @remarks Este valor depende del UUID de tu add-on. Es decir, si hay dos add-ons en el mundo y los dos deciden guardar la misma propiedad, será diferente en ambos. Por ej: Add-on1 guarda la propiedad y Add-on2 lo consulta, será undefined porque solo existe en el Add-on1.
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * worldToolsSimplified.getWorldDynamicProperty('ha:property'); // "string" | undefined.
     * ```
     */
    getWorldDynamicProperty(idProperty: string): string | number | boolean | mc.Vector3 | undefined;
    /**
     * Método auxiliar que obtiene todos los IDs de propiedades dinámicas guardadas en el mundo.
     * @returns {string[]} El array de todos los IDs registrados, en caso de no haber ninguno, estará vacío.
     * @remarks Este valor depende del UUID de tu add-on. Es decir, si hay dos add-ons en el mundo y los dos deciden guardar la misma propiedad, será diferente en ambos. Por ej: Add-on1 guarda la propiedad y Add-on2 lo consulta, será undefined porque solo existe en el Add-on1.
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * worldToolsSimplified.getAllWorldDynamicPropertiesIDs(); // ['ha:test','ha:test2','ha:test3'].
     * ```
     */
    getAllWorldDynamicPropertiesIDs(): string[];
    /**
     * Método auxiliar que obtiene los datos de una propiedad dinámica guardada en una entidad en concreto.
     * @param {(mc.Entity | mc.Player)} targetEntity Entidad en cuestión a consultar.
     * @param {string} idProperty ID en cuestión de la propiedad a consultar.
     * @returns {(string | number | boolean | mc.Vector3 | undefined)} Devuelve el tipo de dato guardado en la propiedad, en caso de no existir, será undefined.
     * @remarks Este valor depende del UUID de tu add-on. Es decir, si hay dos add-ons en el mundo y los dos deciden guardar la misma propiedad, será diferente en ambos. Por ej: Add-on1 guarda la propiedad y Add-on2 lo consulta, será undefined porque solo existe en el Add-on1.
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * worldToolsSimplified.getEntityDynamicProperty(entity, 'ha:test'); // "string" | undefined.
     * ```
     */
    getEntityDynamicProperty(targetEntity: mc.Entity | mc.Player, idProperty: string): string | number | boolean | mc.Vector3 | undefined;
    /**
     * Método auxiliar que obtiene todos los IDs de propiedades dinámicas en una entidad en concreto.
     * @param {(mc.Entity | mc.Player)} targetEntity Entidad en concreto a consultar.
     * @returns {string[]} Devuelve un Array con todos los IDs, en caso de no haber ninguno, será vacío.
     * @remarks Este valor depende del UUID de tu add-on. Es decir, si hay dos add-ons en el mundo y los dos deciden guardar la misma propiedad, será diferente en ambos. Por ej: Add-on1 guarda la propiedad y Add-on2 lo consulta, será undefined porque solo existe en el Add-on1.
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * worldToolsSimplified.getEntityDynamicPropertiesIDs(entity); // ['ha:test1','ha:test2','ha:test3']
     * ```
     */
    getEntityDynamicPropertiesIDs(targetEntity: mc.Entity | mc.Player): string[];
    /**
     * Método auxiliar que activa globalmente música para todos los jugadores.
     * @param {string} idMusic ID de la música a reproducir.
     * @param {?mc.MusicOptions} [options] (Opcional) Las condiciones para hacer sonar la música.
     * @returns {void}
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * worldToolsSimplified.startGlobalMusic('music.pigstep');
     * ```
     */
    startGlobalMusic(idMusic: string, options?: mc.MusicOptions): void;
    /**
     * Método auxiliar que detiene la música global del mundo.
     * @returns {void}
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * worldToolsSimplified.stopGlobalMusic();
     * ```
     */
    stopGlobalMusic(): void;
    /**
     * Método auxiliar que obtiene o crea un area persistente en el mundo. Un /tickingarea, basado en las configuraciones de la misma, este es asíncrono debido a que debe esperar la carga de chunks requeridas y los cálculos que hace el juego para crear el radio.
     * @param {string} idArea ID del area a crear o obtener.
     * @param {mc.TickingAreaOptions} options Parametros para la creación del area en caso de no existir.
     * @returns {Promise<mc.TickingArea | undefined>} Si todo sale bien, devuelve el area correctamente en caso de modificarlo, sino, será undefined.
     * @author HaJuegos - 18-07-2026
     * @public
     * @async
     * @example
     * ```ts
     * // Esto crea una area persistente en el mundo y si todo sale bien, devuelve el tipo para modificarlo. En caso de ya existir, pues no se crea.
     * worldToolsSimplified.getOrCreateTickingArea('ha:area_persistente', {
     *     dimension: Dimension,
     *     to: { x: 0, y: 0, z: 0 },
     *     from: { x: 0, y: 10, z: -10 }
     * });
     * ```
     */
    getOrCreateTickingArea(idArea: string, options: mc.TickingAreaOptions): Promise<mc.TickingArea | undefined>;
    /**
     * Método auxiliar que elimina un area persistente del mundo creado previamente.
     * @param {(string | mc.TickingArea)} idArea Area en concreto a eliminar o tambien su ID.
     * @returns {void}
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * // Esto elimina dicha area, si existe, sino, pues no hace nada.
     * worldToolsSimplified.deletedTickingArea('ha:area_persistente');
     * ```
     */
    deletedTickingArea(idArea: string | mc.TickingArea): void;
    /**
     * Método auxiliar que permite la creación de textos flotantes custom en el mundo, con mucha personalización.
     * @param {CustomFloatingTextParams} params Todos los parámetros requeridos para la creación de un texto flotante.
     * @returns {mc.TextPrimitive} Si todo sale bien, devuelve el mismo texto flotante previamente creado para su modificación.
     * @author HaJuegos - 18-07-2026
     * @public
     * @example
     * ```ts
     * // Esto crea un texto flotante llamado "Hola soy un texto".
     * const floatText: CustomFloatingTextParams = {
     *     text: { rawtext: [{ text: 'Hola soy un texto' }] },
     *     dimension: Dimension,
     *     alwaysVisible: true,  // Siempre será visible para todos a través de bloques.
     *     location: { x: 0, y: 0, z: 0 },
     *     rotation: { x: 0, y: 0, z: 0 },
     *     duration: 1000,
     *     scale: 1
     * };
     *
     * worldToolsSimplified.setAndGetFloatingText(floatText);
     * ```
     */
    setAndGetFloatingText(params: CustomFloatingTextParams): mc.TextPrimitive | undefined;
    /**
     * Método auxiliar que obtiene las dimensiones vanillas o custom por el método world.
     * @param {(vanilla.MinecraftDimensionTypes | string)} dimensionID El ID vanilla o custom en cuestión a obtener de la dimensión.
     * @returns {(mc.Dimension | undefined)} Si todo sale bien, devuelve la dimensión en concreto, sino, será undefined.
     * @public
     * @author HaJuegos - 06-08-2026
     * @example
     * ```ts
     * // Todas las formas de obtener dimensiones.
     * const over = worldToolsSimplified.getDimension(vanilla.MinecraftDimensionTypes.Overworld);
     * const end = worldToolsSimplified.getDimension(vanilla.MinecraftDimensionTypes.TheEnd);
     * const customDime = worldToolsSimplified.getDimension('ha:custom_dimension');
     * ```
     */
    getDimension(dimensionID: vanilla.MinecraftDimensionTypes | string): mc.Dimension | undefined;
    /**
     * Método auxiliar que obtiene todos los jugadores en el mundo independientemente de las dimensiones.
     * @returns {(mc.Player[] | undefined)} Si todo sale bien, devuelve de array de todos los jugadores, sino, será undefined.
     * @public
     * @author HaJuegos - 06-08-2026
     * @example
     * ```ts
     * // Obtiene todos los jugadores del mundo.
     * worldToolsSimplified.getAllPlysGlobal();
     * ```
     */
    getAllPlysGlobal(): mc.Player[] | undefined;
    /**
     * Método auxiliar que envía un evento script globalmente por medio de, scripts vaya.
     * @param {string} idScript ID del script en concreto a enviar.
     * @param {?string} [msg] (Opcional) Mensaje del script en concreto a enviar como argumento adicional.
     * @returns {void}
     * @public
     * @author HaJuegos - 06-08-2026
     * @example
     * ```ts
     * // Envía un script de prueba al addon de forma global.
     * worldToolsSimplified.sendScriptEventGlobal('ha:test_script');
     * ```
     */
    sendScriptEventGlobal(idScript: string, msg?: string): void;
}
export declare const worldToolsSimplified: WorldToolsSimplified;
export {};
//# sourceMappingURL=worldToolsSimplifiedManager.d.ts.map