App-LOL

Español · English

Compañero de escritorio para League of Legends. Reúne builds, counters, runas, datos del cliente y un overlay de partida en una sola app, sin publicidad y sin pedir tu cuenta de Riot.

Proyecto personal, no afiliado ni respaldado por Riot Games. League of Legends y sus activos son propiedad de Riot Games, Inc.

Descargar el instalador para Windows · Todas las versiones

Ver capturas de la app

Champ select

Partida en vivo

Características

• Datos oficiales: campeones, objetos, hechizos, runas y recomendaciones desde Data Dragon y Community Dragon. El parche se detecta automáticamente y se guarda en caché local.
• Objetos por campeón: cada ficha muestra los objetos que recomienda el cliente del juego para ese campeón, con build curada cuando Riot no publica datos y adaptación a la composición enemiga.
• Catálogo de objetos: buscador, filtros por categoría, orden por precio, estadísticas, ruta de construcción y campeones que recomiendan cada objeto.
• Análisis de builds: salida de línea, primer objeto completado, botas, orden de compra y prioridad de habilidades, además de runas, hechizos de invocador y counters directos.
• Exportar al cliente: guarda la build como conjunto de objetos y la página de runas en League of Legends con un clic, sin copiar nada a mano.
• ARAM y Arena: detecta el modo desde el champ select o la partida en vivo, limita los objetos a los disponibles en el mapa y usa los zumos de Arena. Arena no genera página de runas.
• Champ select: composición aliada y enemiga, picks, bans, counters, baneos recomendados para tu pick y temporizador.
• Partida en vivo: KDA, CS, objetos, nivel, oro estimado por personaje y diferencia total y por línea, además de timers de objetivos.
• Idiomas: interfaz y datos de Riot en español, inglés o portugués de Brasil, con selector en Ajustes.
• Overlay click-through y personalizable: se muestra solo en champ select, partida o reconexión. Incluye counters, baneos recomendados, oro por línea y timers. No roba foco ni clics; puedes cambiar tamaño, transparencia, posición y secciones visibles.
• Mi cuenta: perfil, nivel, icono, rangos de Solo/Dúo y Flex, LP, winrate y maestría de campeones.
• Inicio automático: arranca con Windows, queda en la bandeja y aparece al abrir League.
• Sin credenciales: usa únicamente las APIs locales del cliente. No hay login, cuentas ni servidores propios.

Requisitos

Para usar la app

• Windows 10 u 11 de 64 bits.
• League of Legends instalado.
• Conexión a internet la primera vez, para descargar los datos del parche.
• No requiere permisos de administrador.

Para desarrollar

• Node.js 22.22.2 o superior.
• npm 10 o superior.
• Git.

Descarga

Los ejecutables están publicados en GitHub Releases, así no dependes de tenerlos solo en el Escritorio. Los enlaces de descarga apuntan siempre a la última versión publicada.

• Instalador recomendado: App-LOL-Setup-x64.exe. Instala la app, crea accesos directos en el Escritorio y el menú Inicio, y la abre al terminar.
• Portátil: App-LOL-Portable-x64.exe. No requiere instalación.

Al abrir la app por primera vez, queda configurada para iniciar con Windows y aparecer cuando abres League of Legends. Puedes cambiar ambas opciones en Ajustes → Sistema.

Instalación en Windows

La app se distribuye de dos formas: instalador con accesos directos o ejecutable portátil.

Opción A: instalador

1. Ejecuta App-LOL-Setup-x64.exe.
2. Elige la carpeta de instalación si quieres cambiarla.
3. El instalador crea accesos directos en el escritorio y en el menú Inicio.
4. Al terminar, App-LOL se abre automáticamente.

Opción B: portátil

1. Ejecuta App-LOL-Portable-x64.exe.
2. La app extrae sus archivos a una carpeta temporal y se ejecuta desde allí.
3. Puedes mover o renombrar el ejecutable, pero no lo borres mientras la app está abierta.

Aviso de SmartScreen

Los ejecutables no están firmados digitalmente, así que Windows puede mostrar un aviso de SmartScreen. Si descargaste el archivo desde este repositorio o lo compilaste tú, usa Más información → Ejecutar de todas formas.

Actualizaciones

La versión instalada comprueba si hay una versión nueva al abrir la app y cada 6 horas. La actualización se descarga en segundo plano y se instala al cerrar o reiniciar App-LOL. También puedes comprobarla manualmente en Ajustes → Actualizaciones.

Importante: App-LOL 0.1.0 no incluye el actualizador y no puede actualizarse sola. Si ya lo tenías instalado, descarga e instala una vez la 0.2.0 desde GitHub Releases. A partir de ahí las siguientes actualizaciones serán automáticas.

La versión portátil no se actualiza sola: descarga el ejecutable nuevo desde la última release. Las actualizaciones automáticas están disponibles en la versión instalada de Windows.

Las versiones se publican como releases de GitHub. El instalador se actualiza con latest.yml y los usuarios no tienen que volver a descargar nada.

Primer uso

1. Abre App-LOL.
2. Abre League of Legends. La app detecta el cliente automáticamente y trae tu perfil.
3. Si ya estás en champ select o en partida, entra en Partida para ver el análisis en vivo.
4. En Ajustes puedes configurar el inicio con Windows, el overlay y la conexión manual con el cliente.

La primera carga descarga los datos del parche. Las siguientes aperturas usan la caché local y son más rápidas.

Páginas

Inicio

Resumen del estado del cliente, acceso rápido a partida y campeones destacados. Si no hay partida activa, muestra el estado actual y atajos para empezar.

Partida

Champ select y partida en vivo:

• Aliados, enemigos, picks, bans y roles.
• Counters y sugerencias de build.
• Baneos recomendados cuando ya elegiste tu campeón.
• KDA, CS, nivel, objetos y hechizos.
• Oro estimado por personaje, diferencia total del equipo y diferencia por línea.
• Timers de objetivos.
• Botón para mostrar u ocultar el overlay.

Campeones

Buscador y filtros por rol, con detalle de cada campeón: estadísticas, habilidades, pasiva, lore, builds, runas y counters. La ficha incluye los objetos recomendados para ese campeón y enlaza al catálogo.

Objetos

Catálogo completo de objetos del parche con buscador, filtros por categoría, orden por precio, estadísticas, objetos que lo componen y campeones para los que el juego lo recomienda. Desde cada objeto puedes saltar a los campeones asociados.

Mi cuenta

Perfil del invocador, nivel, icono, rangos de Solo/Dúo y Flex 5v5, LP, winrate combinado, rachas y maestría de los campeones más jugados.

Los datos de la cuenta se leen del cliente local. Si League está cerrado, la página muestra un estado vacío o un error con opción de reintentar.

Ajustes

• Idioma de la interfaz y de los datos de Riot: español de España, inglés o portugués de Brasil. En español se usa “línea” y “sostenibilidad” en lugar de “carril” y “sustain”.
• Detección automática del cliente o conexión manual por ruta, puerto y token.
• Frecuencia de actualización.
• Ventana siempre arriba, envío al segundo monitor, overlay, splash arts y reducción de animaciones.
• Inicio con Windows y aparición al abrir League.
• Estado de la caché y actualización de datos.

Builds y orden de objetos

App-LOL cruza tres fuentes para proponer una compra: la guía de objetos del campeón, su rol y arquetipo, y la composición enemiga. En ARAM y Arena se usan solo los objetos disponibles en ese mapa; el catálogo de objetos muestra los de Grieta del Invocador.

La ficha de build se divide en:

• Objetos recomendados: hasta seis objetos de la guía del campeón, con la fuente indicada (meta externa, datos del juego, build curada o arquetipo).
• Salida de línea: Doran + poción, World Atlas + pociones si eres soporte, o mascota de jungla + poción si jungleas. Se usa la salida del campeón cuando encaja con el rol y, si no, se adapta al poke y al arquetipo.
• Primer objeto completado: el que más ayuda a ganar el intercambio inicial. No siempre es el más caro: se penalizan la penetración porcentual, la anti-curación y los objetos acumulativos como primera compra.
• Botas: se eligen según el daño y el control de masas enemigo, con las botas recomendadas para el campeón como respaldo.
• Núcleo: tres objetos completados que definen tu pico de poder.
• Situacionales: dos objetos para responder a curación, tanques, escudos, CC o daño dominante.
• Orden de compra: numera la secuencia desde el primer completado; las botas aparecen después para no tapar el primer pico de poder.
• Habilidades: prioridad Q/W/E/R y niveles de la definitiva según el kit y el rol.

La selección de objetos combina:

• Guías de objetos por campeón extraídas de los datos del juego de Riot en CommunityDragon. Cubren 121 campeones del parche actual.
• Builds meta contrastadas con OP.GG y LoLalytics para 173 campeones y 280 combinaciones campeón/rol del parche actual.
• Builds curadas por App-LOL para los campeones sin guía publicada, y una reserva por arquetipo para cualquier campeón nuevo.
• Estadísticas oficiales de Data Dragon.
• Etiquetas de arquetipo y rol.
• Bonus por objetos de arranque habituales de cada clase.
• Amenazas enemigas: curación, tanques, escudos, CC, poke y daño físico o mágico.
• Penalizaciones para compras tardías o situacionales demasiado pronto.

Las guías de objetos se generan desde los archivos del juego publicados por Riot en CommunityDragon. Cuando Riot no publica una guía para un campeón, App-LOL usa una build curada y la marca en la ficha. Las builds y los matchups meta se contrastan con OP.GG y LoLalytics mediante una instantánea generada en el repositorio; la app no consulta esas webs en tiempo de ejecución. El orden final sigue siendo una recomendación, no un winrate en vivo ni una lista competitiva.

Overlay

El overlay aparece sobre el monitor principal cuando estás en champ select, en partida o reconectando. Es transparente, no roba foco y deja pasar los clics al juego.

• Mostrar u ocultar: Ctrl + Shift + O, el botón de la barra superior o el menú de la bandeja.
• Tamaño: en Ajustes puedes elegir entre 60% y 100%, con las etiquetas Muy pequeño, Pequeño, Normal, Grande y Muy grande. Por defecto usa 80%. La ventana base mide 448×664 px.
• Legibilidad: fondo con más contraste, filas de oro y timers más separadas, y tu línea resaltada.
• Transparencia: el fondo va de 35% (casi transparente) a 100% (sólido). Por defecto usa 75%.
• Posición: arriba o abajo, a la izquierda o derecha, o al centro lateral. La posición centrada sirve para acercar los timers al minimapa.
• Segundo monitor: en Ajustes → Ventana y apariencia puedes enviar la ventana principal al otro monitor y dejar el overlay sobre el juego.
• Secciones: puedes activar o desactivar el oro estimado (total y por línea), los timers de objetivos y el overlay durante champ select.
• Oro con atajo: si activas “Oro solo con Ctrl+Shift+G”, el panel de oro empieza oculto y lo muestras u ocultas con ese atajo. No se puede detectar la tecla Tab del juego desde la API.
• Alcance: counters y baneos recomendados durante champ select, oro estimado por personaje con diferencia total y por línea, y timers de objetivos.
• Oro estimado: el oro disponible de tu jugador se toma de la API cuando está disponible; el resto se calcula con el tiempo de partida, CS, KDA y el valor de los objetos. El oro de los rivales no es exacto, por eso se muestra con ≈.
• Pantalla completa exclusiva: el overlay puede no verse en ese modo. Usa League en pantalla completa sin bordes o en ventana.

Inicio con Windows y bandeja

El inicio automático y la aparición al abrir League vienen activados por defecto.

• Al iniciar sesión en Windows, App-LOL arranca oculta en la bandeja.
• Cuando se detecta el cliente de League, la ventana sale de la bandeja sin robar foco.
• Con el inicio automático activo, la X oculta la ventana en la bandeja. Para cerrar la app del todo, usa Salir en el menú de la bandeja.
• Si desactivas el inicio automático, la X cierra la app.
• El menú de la bandeja también permite abrir la app, activar el overlay y cambiar el inicio con Windows o la aparición al abrir League.

El inicio automático se registra en el usuario actual, no requiere administrador y se limpia al desinstalar.

Conexión con League

Por defecto, App-LOL busca el cliente en estas ubicaciones:

C:\Riot Games\League of Legends
C:\Program Files\Riot Games\League of Legends
C:\Program Files (x86)\Riot Games\League of Legends
D:\Riot Games\League of Legends
E:\Riot Games\League of Legends

También puede leer el proceso LeagueClientUx.exe y su archivo lockfile.

Si usas otra instalación:

1. Abre Ajustes → League of Legends.
2. Desactiva Detectar el cliente automáticamente.
3. Introduce la ruta de instalación, por ejemplo C:\Riot Games\League of Legends.
4. Si hace falta, completa el puerto y el token del cliente.
5. Sal del campo para guardar y usa Volver a detectar.

El token del cliente es local y sensible. La app no lo envía a internet. No compartas tu lockfile ni el token con nadie.

Datos y privacidad

• Los datos estáticos se descargan de Data Dragon y Community Dragon, de Riot Games.
• Las builds y los matchups meta de OP.GG y LoLalytics se incluyen como instantánea generada; la app no contacta esas webs al ejecutarse.
• Los datos de la partida y de la cuenta se leen de 127.0.0.1: la API local del cliente (LCU) y la Live Client Data API en el puerto 2999.
• No hay cuentas, telemetría, publicidad ni servidores propios.
• La caché de datos se guarda en el directorio de datos de la app dentro de tu perfil de Windows.
• La app no pide usuario ni contraseña de Riot.

Desarrollo

git clone https://github.com/ryodan14/App-LOL.git
cd App-LOL
npm install
npm run dev

Comandos

Comando	Descripción
npm run dev	Inicia la app en modo desarrollo con recarga.
npm run typecheck	Verifica tipos del proceso principal y del renderer.
npm test	Ejecuta los tests con Vitest.
npm run build	Compila la app sin empaquetar.
npm run build:win	Genera el instalador NSIS, el portátil y latest.yml en release/.
npm run build:linux	Genera un AppImage para Linux.
node scripts/generate-champion-items.mjs	Regenera las guías de objetos por campeón desde CommunityDragon.
node scripts/generate-meta-snapshot.mjs	Regenera la instantánea de builds y matchups desde OP.GG y LoLalytics. Usa .cache/meta y tarda varios minutos.
npm run audit	Falla si npm detecta vulnerabilidades moderadas o superiores en dependencias de producción.
npm run audit:all	Revisa también las dependencias de desarrollo y empaquetado.
npm run verify:release -- --windows --tag=v0.4.0	Comprueba tag, instalador, hash, tamaño y metadatos del actualizador.

Los artefactos de Windows quedan en release/:

release/App-LOL-Setup-x64.exe
release/App-LOL-Setup-x64.exe.blockmap
release/App-LOL-Portable-x64.exe
release/latest.yml

En Linux o WSL, npm run build:win necesita Wine para generar el instalador NSIS. Si no está disponible, ejecuta npm run build y después npx electron-builder --win portable --publish never para generar solo el portátil.

Publicar una versión

La forma recomendada es dejar que GitHub Actions compile y publique la release:

1. Sube la versión y crea el tag: npm version patch (o minor/major).
2. Sube el commit y el tag:

git push origin main --follow-tags

3. La workflow .github/workflows/release.yml compila en Windows, revisa las dependencias, ejecuta los tests y publica el instalador, latest.yml y el .blockmap.

Si compilas manualmente con npm run build:win, sube a la release el instalador, el .blockmap, el portátil y latest.yml. No publiques el instalador y el portátil por separado: todos los assets deben quedar en la misma release.

La versión de package.json debe coincidir con el tag. Para que las actualizaciones funcionen, la release debe ser pública y no quedar en borrador.

Estructura

src/
  main/            Proceso principal de Electron
    services/      LCU, datos estáticos, snapshots, ajustes y caché
    index.ts       Ciclo de vida, IPC, bandeja, inicio automático y atajos
    overlay.ts     Ventana del overlay
    preview.ts     Datos de prueba para capturas y QA
    window.ts      Ventana principal y persistencia de tamaño
  preload/         Puente seguro entre main y renderer
  renderer/
    src/
      pages/       Inicio, Partida, Campeones, Mi cuenta y Ajustes
      components/  Layout y componentes de UI
      overlay/     Interfaz del overlay
      store/       Estado de la app con Zustand
      lib/         Cliente IPC, formato y datos de juego
  shared/          Tipos, constantes y motor de análisis
build/             Iconos y personalización del instalador
docs/media/        Capturas y GIFs usados en el README

Solución de problemas

La app no detecta el cliente

• Verifica que League of Legends esté abierto y hayas iniciado sesión.
• Abre Ajustes → League of Legends y usa Volver a detectar.
• Si usas una instalación personalizada, desactiva la detección automática e introduce la ruta.
• Revisa que el archivo lockfile exista dentro de la carpeta de instalación.

El overlay no aparece

• Activa el overlay en Ajustes o con Ctrl + Shift + O.
• El overlay solo se muestra en champ select, partida o reconexión. Verifica que “Mostrar en champ select” esté activo si no aparece al elegir campeón.
• Si el oro no aparece, usa Ctrl + Shift + G o desactiva “Oro solo con Ctrl+Shift+G” en Ajustes.
• En pantalla completa exclusiva puede quedar oculto. Prueba con pantalla completa sin bordes.
• Si otro programa usa Ctrl + Shift + O o Ctrl + Shift + G, cambia el foco y vuelve a intentar.

Windows bloquea el ejecutable

Es un binario sin firma digital. Usa Más información → Ejecutar de todas formas si confías en el origen del archivo.

La app no arranca o no aparece la ventana

• Si el inicio automático está activo, la app puede estar en la bandeja. Haz clic en el icono de App-LOL.
• Abre el menú de la bandeja y elige Abrir App-LOL.
• Si el problema persiste, cierra la app desde la bandeja con Salir y vuelve a abrirla.

No cargan los datos del parche

• Revisa la conexión a internet.
• Abre Ajustes → Datos y usa Actualizar datos ahora.
• Si el parche cambió hace poco, puede tardar unos minutos en estar disponible en Data Dragon.

Mi cuenta aparece vacía

• La página necesita que el cliente esté abierto y con sesión iniciada.
• Espera unos segundos y usa Actualizar cuenta.
• Si el cliente está en mantenimiento o sin conexión, los rangos y la maestría pueden no estar disponibles.

Estado del proyecto

App-LOL está en desarrollo activo. Algunas limitaciones conocidas:

• El oro exacto de los diez jugadores no está expuesto por la API oficial. El de tu jugador se lee cuando la API lo ofrece; el resto se estima y se muestra como aproximado.
• Las guías de objetos dependen de que Riot publique los datos del campeón en CommunityDragon. Para los que no los publica se usa una build curada; el orden final es una recomendación, no un winrate.
• No hay OCR ni lectura de pantalla.
• El overlay puede no funcionar en pantalla completa exclusiva.
• Los ejecutables no están firmados, por lo que SmartScreen puede advertir.
• La integración completa con una partida real requiere League of Legends abierto en Windows.

Contribuir

Las mejoras se trabajan desde develop con una rama corta por cambio:

• feature/... para funcionalidad.
• fix/... para errores, textos o ajustes puntuales.
• docs/... para documentación.

Cada rama debe tener un objetivo y commits pequeños. Evita mezclar motor de análisis, interfaz y documentación en el mismo commit.

Antes de abrir un cambio:

npm run typecheck
npm test
npm run build

Los mensajes de commit se mantienen en español. El README está disponible en español e inglés.

Aviso legal

App-LOL no está afiliada ni respaldada por Riot Games. League of Legends y todos los activos relacionados son propiedad de Riot Games, Inc. El uso de las APIs locales está sujeto a los términos de servicio de Riot Games.