¿Cómo configuro peso para puntuación?

Las extracciones de desempeño por lo general son una herramienta de ayuda fundamental para la gestión de un reino. Igualmente, la interpretación de esos datos es imprescindible, es por esto, hemos creado un apartado de peso para los diferentes atributos, pudiendo hacer un puntaje por jugador acorde a tus necesidades.

PROCEDIMIENTO


Abriremos nuestra aplicación en su vista principal:

Navegamos al apartado de Configuraciones & Parametrizaciones:

En el apartado de Puntuación desempeño podremos dar el peso o factor multiplicador para la determinación de la puntuación del jugador en las extracciones de desempeño, siendo la fórmula por la cual se obtiene dicha puntuación:

PUNTUACIÓN = [ ( Puntos de muerte * <Factor1> ) + ( Muertos * <Factor2> ) + ( T1 * <Factor3> ) + ( T2 * <Factor4> )  + ( T3 * <Factor5> )  +  ( T4 * <Factor5> ) + ( T5 * <Factor6> ) ] – ( Poder * <Factor7> )

NOTA: Desde la revisión 22122023 se ha incorporado el factor de poder haciendo que tengan más peso los atributos cuánto menos poder se tenga.

¿Cómo configuro mi WEBHOOK?

Uno de los prerrequisitos para poder disponer de la integración con Discord es la configuración del servicio de integración WEBHOOK. Este servicio que ofrece Discord permite la integración de aplicaciones externas con un servidor de Discord determinado.

PREREQUISITOS


Algunas actividades deberán haber sido gestionadas con anterioridad:

  • Disponer de cuenta y servidor de Discord.

PROCEDIMIENTO


Abrimos nuestra aplicación de Discord y accedemos al servidor dónde queremos que se integre nuestra aplicación:

Hacemos botón secundario sobre el icono de nuestro servidor y navegamos a Server Settings > Integrations

En ese momento se nos abrirá una vista general dónde aparecerá el apartado de WEBHOOK:

Pulsamos sobre View Webhooks para acceder a la vista principal dónde figurarán todos los WEBHOOKS que tenemos configurados actualmente:

Continuamos presionando en el botón de New Webhook. Dónde indicaremos el nombre del Webhook (IMPORTANTE: el nombre deberá ser el literal AHVWIKI) así cómo el canal por donde queremos que la aplicación haga el envío de los mensajes:

Guardamos la creación y tras esto, pulsamos el botón llamado Copy Webhook URL, lo pulsamos para copiar la URL generada:

Abrimos nuestro extractor y navegamos a la vista de Integración:

Introducimos la URL que copiamos anteriormente en el apartado Dirección WEBHOOK y guardamos:

Finalmente, pulsamos en Validar para confirmar que la URL se ha copiado bien y tenemos conexión:

¿Cómo enviar mensajes a Discord?

La nueva versión trae consigo muchas funcionalidades que habéis demandado. Una de ellas es la integración con Discord. Con el módulo de integración podréis enviar la información de vuestras extracciones al servidor de Discord y hacer participes de las datos a todos vuestros miembros.

CARACTERISTICAS


El módulo de integración te permitirá:

  • Configurar un WEBHOOK
  • Envío de informes de clasificación para el desempeño generado en la fecha seleccionada (requiere haber ejecutado un desempeño para un intervalo, por favor, ver > https://ahvwiki.com/index.php/2023/11/25/como-evaluo-el-desempeno/)
  • Envío de ficheros de extracción, pudiendo descargar y visualizarse directamente desde Discord:
    • Fichero general del reino
    • Fichero de extracción para fecha seleccionada

PREREQUISITOS


Algunas actividades deberán haber sido gestionadas con anterioridad:

PROCEDIMIENTO


Abriremos nuestra aplicación en su vista principal:

Navegamos al apartado de Integraciones:

Sobre el campo Dirección WEBHOOK indicamos la URL generada desde Discord (Ver manual >> https://ahvwiki.com/index.php/2023/11/25/como-configuro-mi-webhook/):

Continuamos indicando la Selección de fecha de extracción(el listado se corresponde con aquellas extracciones que tenemos disponibles en el sistema):

Finalmente, seleccionamos el filtro a generar según nuestra preferencia y pulsamos en Lanzar prueba:

Accedemos a nuestro servidor de Discord y confirmamos que la clasificación se ha generado correctamente:

Finalmente, en el caso de seleccionar el envío de ficheros, el resultado que se recibirá en Discord será:

¿Cómo genero mis clasificaciones?

Al igual que para el apartado de desempeño, la vista de clasificaciones nace para dar cobertura individualizada, a los informes de clasificación. Desde este apartado podrás ver de una forma visual las clasificaciones de los diferentes jugadores para un intervalo de tiempo indicado.

PREREQUISITOS


Algunas actividades deberán haber sido gestionadas con anterioridad:

  • Debemos disponer de las extracciones a evaluar.
  • Las extracciones deben contener el mismo número de jugadores.
  • El usuario a evaluar deberá estar contenido en las extracciones indicadas.

PROCEDIMIENTO


Abriremos nuestra aplicación en su vista principal:

Navegamos al apartado de Clasificación:

Seleccionamos el intervalo a evaluar, y terminamos pulsamos en Ver:

Se nos mostrará la clasificación de los primeros 15 jugadores para el atributo seleccionado.

¿Cómo ver histórico de jugador?

La evaluación de los diferentes jugadores se puede gestionar de múltiples formas, como por ejemplo, la extracción general. Aún así y de cara a simplificar la actividad, la aplicación ofrece un apartado en exclusiva bajo el nombre Históricos. Desde él podrás:

  • Evaluar actividad histórica del jugador en formato gráfico para todos los atributos
  • Selección por intervalos de tiempo fijados según necesidad.

RECOMENDACIONES


Recomendamos no ejecutar intervalos de históricos con más de 20 extracciones comprendidas en las fechas a analizar. El uso de exceso de información puede hacer que la grafica se superponga.

PREREQUISITOS


Algunas actividades deberán haber sido gestionadas con anterioridad:

  • Debemos disponer de las extracciones a evaluar.
  • Las extracciones deben contener el mismo número de jugadores.
  • El usuario a evaluar deberá estar contenido en las extracciones indicadas.

PROCEDIMIENTO


Abriremos nuestra aplicación en su vista principal:

Navegamos al apartado de Históricos:

Seleccionamos el intervalo a evaluar, momento en el cual el desplegable de jugadores se habilitará con aquellos que estén disponibles:

Tras seleccionar el jugador deseado, pulsaremos en el botón de Ver:

¿Cómo evaluó el desempeño?

Quizás esta sea una de las funcionalidades más demandas en Rise Of Kingdom. La evaluación del desempeño de un jugador para un intervalo determinado de tiempo, es sin duda la actividad más costosa en la gestión de un reino. Con la vista de Desempeño podrás:

  • Evaluar la diferencia de atributos para todos los jugadores en el intervalo seleccionado.
  • Puntuación a medida según filtro configurado por peso (Ver manual de configuración > https://ahvwiki.com/como-configuro-peso-para-puntuacion/)
  • Excel de extracción con toda la información.

Adicionalmente, debemos ser conscientes que la evaluación del desempeño, no requiere de interacción con Bluestack por lo que no hace falta tener el juego abierto.

PREREQUISITOS


Algunas actividades deberán haber sido gestionadas con anterioridad:

  • Debemos disponer de las extracciones a evaluar.
  • Las extracciones deben contener el mismo número de jugadores.

PROCEDIMIENTO


Abriremos nuestra aplicación en su vista principal:

Navegamos al apartado de Desempeño:

Continuamos seleccionado el intervalo deseado (será necesario contar con extracciones correctas para ambas fechas) y pulsamos en Ver:

En este momento, se mostrará el listado completo según lectura (sin un orden prefijado). Para filtrar por atributo, bastará con pulsar en la cabecera de la columna deseada. En ese momento se ordenaran los elementos:

Adicionalmente, el programa generará un fichero Excel con nombre KVK_STATS.xlsx ubicado siempre en la carpeta de la fecha objetivo, es decir, para el caso que estamos mostrando 24-11-2023:

Dónde dicho Excel será un reflejo de lo mostrado en la aplicación:

¿Cómo evaluó a mi reino por Pkills?

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?:

¿Cómo extraer la información de mi reino?

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:

 

 

[Error-0001] Pemission Denied

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 configuro mis coordenadas?

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!