Una de las herramientas que brinda el extractor, es la evaluación de los jugadores del reino en base a un filtro de puntos de muertes personalizado. Este filtro se configura a medida y acorde a vuestras necesidades.

PROCEDIMIENTO

Abriremos nuestra aplicación en su vista principal:

Navegamos al apartado de Configuraciones & Parametrizaciones

En él, revisamos los filtros de aplicación. Lugar dónde podremos configurar en base a un intervalo de poder, el objetivo en puntos de muerte que deseamos:

Tras fijar el filtro deseado, pulsamos en Modificar para salvar los cambios y navegamos a la vista del terminal de extracción. Ejecutamos una nueva extracción:

Finalmente, navegamos a la vista Resultados y evaluamos la columna de ¿Objetivo PK?:

La principal función de nuestra aplicación reside en la capacidad de poder extraer la información de un determinado reino. El siguiente documento pretende explicar cómo podrás realizar dichas extracciones, en el contexto de la aplicación AHV Extractor.

RECOMENDACIONES

Las extracciones se basan en un proceso de digitalización de la información, esto quiere decir, se obtienen los valores mediante la lectura de las imágenes del juego haciendo que la resolución de pantalla sea un factor clave para la obtención de los mejores resultados.

• Personalizar coordenadas y maximizar la ventana del Emulador para disponer de un rango de lectura mayor.
• Uso de cuentas dummy ya que se trata de un proceso de emulación ajeno a Rise of Kingdom y por ende, tiene sus riesgos.

PREREQUISITOS

De cara a una correcta extracción, por favor, asegúrese de que se dispone de los siguientes prerrequisitos:

• Dispone de un emulador Bluestack descargado y abierto
• El emulador Bluestack se encuentra en idioma Español/Castellano.
• El juego Rise of Kingdom disponible y en ejecución sobre el emulador
• Disponer de una cuenta en el reino a analizar con al menos, ayuntamiento nivel 8.
• Tiene en su poder una licencia válida, solicitada mediante el centro de soporte para su reino.
• Ha descargado e instalado el extractor AHV en la última versión desde el centro de descargas.
• Disponer de las coordenadas debidamente configuradas (Ver manual > https://ahvwiki.com/index.php/2023/11/21/como-configuro-mis-coordenadas-2/)

EXPLICACIÓN

Tras ejecutar la aplicación nos encontraremos con la primera vista. En ella se gestionará tanto la ejecución de las diferentes extracciones, como la visualización del log de proceso:

En esta vista nos encontraremos diferentes acciones, todas ellas ubicadas en la inferior de la pantalla:

• Cantidad: Valor de jugadores que serán analizados por el proceso automático. Dispone de diferentes opciones precargadas (1, 5, 10, 20, 50, 100, 200, 400, 500, 700 y 1000).
• Fecha a evaluar: Fecha con la cual se guardarán los ficheros de extracción resultantes del proceso.
• Carga log: Recuperación de log de extracción para la fecha indicada en el campo Fecha a evaluar. Esta opción se usará principalmente para la revisión de extracciones anteriores.
• Lanzar extracción: Inicio de la extracción para la cantidad de jugadores seleccionados en el apartado de Cantidad y para la fecha seleccionada en el apartado de Fecha a evaluar
• Forzar Excel: Mecanismo para recargar una lectura de la extracción generada anteriormente ende fecha seleccionada (Fecha a evaluar). Esta misma funcionalidad, creará el fichero Excel de inventario nuevamente, así cómo mostrará el log resultante en el propio terminal.

EJECUTAR EXTRACCIÓN

1) Abrimos la aplicación y nos situamos sobre el Terminal de extracción:

2) Indicamos el valor de Cantidad de jugadores a extraer, para nuestro caso será 1:

3) Continuamos indicando la fecha de extracción (por defecto, vendrá con la fecha actual). Para nuestro caso, la dejaremos tal y cómo está:

4) Continuamos confirmando que tenemos nuestra ventana de Bluestack abierta con el juego Rise Of Kingdoms, así cómo se encuentra visible tras nuestro extractor (sin ninguna otra ventana de por medio). Pulsamos en Lanzar extracción y esperamos:

5) Navegamos a la pestaña de Resultado y confirmamos los datos de extracción:

Pudiendo hacer clic sobre cualquier registro y ver el detalle en una ventana emergente:

6) Finalmente, navegamos al directorio de EXTRACCIONES (ubicado en la carpeta de instalación) y buscamos en la carpeta con fecha igual a la extracción realizada. En ella, encontraremos el Excel de extracción con el nombre INVENTARIO_REINO.xlsx:

7) Lo abrimos y observamos que contiene la información de la extracción, tanto para la parte de jugadores:

Cómo para la parte de estadísticas del reino:

Finalmente, agrupamos todo lo anterior en un video explicativo para una extracción de 20 jugadores:

SINTOMA

Al lanzar la ejecución por primera vez del programa tras su instalación, aparece la siguiente venta de error:

Failed to execute script ‘AHV_ROKv4’ due to unhandled exception: [Errno 13]: Pemission denied: Traceback (most recent call last): ‘./config/config.properties’

Traceback (most recent call last): File “AHV_ROKv4.py”, line 4361, in <module> PermissionError: [Errno 13] Permission denied: ‘./config/config.properties’

SOLUCIÓN

El error se produce por la falta de permisos. Esto es provocado a consecuencia de no disponer de permisos suficientes sobre la carpeta de instalación o tratarse de una unidad protegida por el sistema, siendo el programa ejecutado de autor desconocido. Enumeramos las alternativas para solventarlo:

• Reinstalar la aplicación en una carpeta sin restricciones, ejemplo: “Documentos“.
• Ejecutar la aplicación con permisos de administrador: “Botón secundario” > “Ejecutar como administrador“.

Cómo parte del funcionamiento del extractor, se requiere de la configuración de coordenadas de lectura. Estas coordenadas, actuarán cómo guía para el proceso automático. Es por ello, es fundamental dedicar el tiempo necesario para ajustar/validar lo mejor posible cada una de las áreas incluidas en el apartado de Configuraciones & Parametrizaciones.

RECOMENDACIONES

Algunas de nuestras recomendaciones son:

• Las extracciones se basan en un proceso de digitalización de la información, esto quiere decir, se obtienen los valores mediante la lectura de las imágenes del juego, haciendo que la resolución de pantalla sea un factor clave para la obtención de los mejores resultados.
• Personalizar coordenadas y maximizar la ventana del Emulador para disponer de un rango de lectura mayor en caso de optar por una opción puramente manual (no recomendada).
• Uso de cuentas dummy ya que se trata de un proceso de emulación ajeno a Rise of Kingdom y por ende, tiene sus riesgos.
• Se recomienda para obtener los resultados óptimos, tener configurada una resolución de emulador de 2560×1440.

PREREQUISITOS

De cara a una correcta extracción, por favor, asegúrese de que se dispone de los siguientes prerrequisitos:

• Dispone de un emulador Bluestack descargado y abierto
• El emulador Bluestack se encuentra en idioma Español/Castellano.
• El juego Rise of Kingdom disponible y en ejecución sobre el emulador
• Disponer de una cuenta en el reino a analizar con al menos, ayuntamiento nivel 8.
• Tiene en su poder una licencia válida, solicitada mediante el centro de soporte para su reino.
• Disponer de los anuncios de Bluestack deshabilitados así como evitar cualquier modificación que suponga un cambio de las dimensiones y disposición de la ventana estándar del emulador.
• Ha descargado e instalado el extractor AHV en la última versión desde el centro de descargas.

EXPLICACIÓN

En el apartado de configuración, encontraremos diferentes acciones (incluidas en el fichero de configuración). En el, se centraliza toda la parametrización de las coordenadas y configuraciones básicas del aplicativo.

PARAMETROS DE EXTRACCIÓN:

• Cantidad: Valor por defecto relativo a la cantidad de jugadores a extraer.
• Directorio: Ubicación física dónde se depositarán las diferentes extracciones por fecha. Este directorio no debe ser modificado una vez realizada la primera extracción.
• Tiempo: Valor en segundos utilizado por el proceso automático para la espera entre lecturas, por defecto será 1 segundo.
• Reino: Valor por el cual se basarán las extracciones y validación de la licencia (Recordar, el programa está pensando para evaluar un reino propio y el uso que se le pueda dar para extraer información de varios reinos con una única licencia puede comprometer su funcionamiento así cómo en casos extremos, podría provocar la anulación de la licencia).

MODO:

El extractor brinda dos posibilidades a la hora de configurar las coordenadas:

AUTOMÁTICA (Opción recomendada):

Delegamos en la aplicación el cálculo de las coordenadas. El programa calculará un tamaño prefijado de pantalla (resolución 1575×900) para el emulador y lo situará en la parte superior izquierda de la pantalla para su correcta lectura. De cara a dejarlo configurado de forma automática, usaremos el botón Calcular Coordenadas calcularlas automáticamente.

1. Marcamos la opción de Automática en el modo de extracción.
2. Nos aseguraremos que nuestro emulador Bluestack este abierto y a ser posible con la ventana maximizada.
3. Una vez hecho, pulsaremos el botón Calcular coordenadas
4. Finalmente, validaremos las coordenadas mediante los botones de validación habilitados para tal efecto.

MANUAL:

Opción más costosa en tiempo pero recomendada por nuestra parte. El programa no hará ninguna redimensión automática y las coordenadas se tomarán según la posición actual del emulador. Requiere de la configuración manual de las coordenadas para una extracción a medida.

1. Marcamos la opción de Manual en el modo de extracción.
2. Nos aseguraremos que nuestro emulador Bluestack este abierto y a ser posible con la ventana maximizada.
3. Realizamos el ajuste de cada coordenada manualmente.

COORDENADAS:

A continuación, explicaremos el listado de valores parametrizables:

• Puntos de Clic: Valores que utilizaremos en la aplicación para que el Bot conozca dónde debe hacer clic.

Siendo la definición de cada propiedad:

• • Reset(X)/(Y): Coordenadas para el clic de Reset entre las diferentes vistas
  • Detalle1(X)/(Y): Coordenadas para el clic de acceso a la vista de cantidad de Kills
  • Detalle2(X)/(Y): Coordenadas para el clic de a la vista de Muertes y recursos recolectados
  • Lect1(X)/(Y): Coordenadas para el clic del primer jugador en la vista de clasificación
  • Lect2(X)/(Y): Coordenadas para el clic del segundo jugador en la vista de clasificación
  • Lect3(X)/(Y): Coordenadas para el clic del tercer jugador en la vista de clasificación
  • Lect4(X)/(Y): Coordenadas para el clic del cuarto jugador en la vista de clasificación
  • Lect5(X)/(Y): Coordenadas para el clic del quinto jugador en la vista de clasificación

• Áreas de extracción: Valores que utilizaremos  en la aplicación para que el Bot conozca cuál es el área que deberá interpretar para extraer su contenido.

Siendo la definición de cada propiedad:

• • ID(X)/(Y)/(AN)/(AL):  Coordenadas del área de extracción para el campo ID Jugador
  • NOMBRE(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo nombre 
  • PODER(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo poder
  • PKILL(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo puntos de Kills 
  • MUERTOS(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo Muertos
  • T1(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo T1 asesinadas
  • T2(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo T2 asesinadas
  • T3(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo T3 asesinadas
  • T4(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo T4 asesinadas
  • T5(X)/(Y)/(AN)/(AL): Coordenadas del área de extracción para el campo T5 asesinadas

PASOS PARA LA CONFIGURACIÓN

Abrimos nuestro emulador Bluestack y nos ubicamos en el apartado de clasificación de jugadores del reino por poder individual:

Continuamos abriendo nuestro aplicativo de extracción y navegamos al apartado de Configuraciones & Parametrizaciones :, dónde dependiendo de la modalidad de coordenadas que vayamos a utilizar deberemos:

– Manual: Indicar los datos manualmente de cada coordenada.

– Automática: Deberemos pulsar en el botón Calcular coordenadas para que el sistema haga la determinación de coordenadas automáticamente.

VALIDACIÓN DE LAS COORDENADAS:

La opción de validación es recomendable ejecutarla tanto para la modalidad Manual cómo para la modalidad Automática ya que nos ayudará tanto a comprender el uso de las coordenadas, cómo validar si realmente la determinación de coordenadas es la esperada/correcta. Dicho lo anterior, existen diferentes validaciones:

• Validación Lista: Pantalla de listado de jugadores por poder individual.
• Validación Perfil: Pantalla de perfil del jugador.
• Validación Detalle: Pantalla detalle del jugador por tipo de unidad matada.
• Validación muertes: Pantalla detalle del jugador general.

Para mostrar un ejemplo, utilizaremos la validación Lista:

1) Sobre nuestro emulador Bluestack y teniendo el juego ROK abierto, navegamos a la vista de clasificación de jugadores por poder individual.

2) Una vez en ella,  pulsamos en el botón Validar Lista dentro de nuestra aplicación:

3) Confirmamos. Acto seguido, se nos mostrará una imagen con la representación de las coordenadas informadas:

Así mismo repetimos la operación anterior para el resto de vistas. Las siguientes imágenes muestran a modo informativo, la evaluación de las lecturas:

Vista Lista:

Vista Perfil:

Vista Kills:

Vista Detalle:

Recordad, tras evaluar todas las vistas,  DEBEREMOS PULSAR EN EL BOTÓN DE MODIFICAR confirmando así las modificaciones tanto a nivel de calculo de coordenadas o manuales que hayamos realizado:

De lo contrario, corremos el riesgo de perder todos los cambios generados hasta el momento. Así mismo, hacemos un breve vídeo con la explicación del proceso automático:

¡Listo! ¡Estamos preparados para comenzar con nuestra primera extracción!

Lanzamos una nueva versión del aplicativo AHV Extractor. En ella se ha incorporado una nueva mejora de diseño y optimización de nuestro BOT. 

NUEVA FUNCIONALIDAD INCLUIDA

• Nueva resolución de pantalla para mejorar la vista desde el aplicativo.
• Creación de ajuste para sobrescribir carpeta de extracción para cada lanzamiento (Soluciona acción manual de borrado de directorio para extracciones con error).
• Incorporación de extracciones por reino en repositorio global para futura lista de reinos hispanos actualizada.
• Incorporación de log de error para contemplar jugadores con error de lectura y ubicación de la lectura incorrecta.
• Sincronizadas imágenes de aplicación con recurso online para mostrar eventos e informaciones en tiempo real.
• Incorporación de nuevos campos de parametrización tales cómo: Serial o número de instalación y versión.
• Refinamiento de propuesta de coordenadas para facilitar primera tarea de configuración
• Reorganización de pantalla de “Configuración & Parametrización” para ubicar botones de validación en los bloques de coordenadas correspondientes.
•  Incorporar filtros por jugador y ordenamiento en tabla de resultado extracción.
• Creación de apartado para la integración con Discord y WEBHOOK.
• Solucionado falta de informe Total Kills en desempeño y vista desempeño de la aplicación
• Corregido valores con decimales para resultados de desempeño.
• Incorporación de árbol con extracciones disponibles en visor de explorador.
• Ajuste en listados de resultado y desempeño para poder ampliar el número de registros.
• Incorporación de opción Calculo coordenadas en vista de configuración.
• Creación de asistente de instalación para la mejora en el proceso de configuración.

De todas ellas queremos destacar puntos como la incorporación de los filtros de desempeño totalmente personalizables así cómo la ayuda de propuesta de coordenadas para evitar que sea tan costosa la configuración de los valores:

La inclusión de la integración asíncrona con Discord para el reporte de clasificaciones o ficheros de extracción:

Visor de extracciones incluido dentro de la aplicación, ayudando a la revisión en caso de necesidad sin tener que navegar entre carpetas del sistema:

Todas las extracciones son personalizables. Somos propietarios del desarrollo y por ende, podemos adaptar según las necesidades del reino cada una de las extracciones:

¡NO ESPERES MÁS, CONTACTANOS PARA MÁS INFORMACIÓN!