LuaTools

English

LuaTools is a Steam plugin for Millennium that helps you install and manage Lua scripts and game fixes directly from the Steam interface.

Short description

LuaTools centralizes common Lua modding tasks: detect games, add or remove Lua scripts, apply fixes, check available APIs, and keep the plugin up to date.

Main features

• Steam UI integration through Millennium.
• Install and remove LuaTools support per AppID.
• Detect and apply game-specific fixes.
• Track download/operation status in background tasks.
• Automatic update checks and Steam restart flow when needed.
• Settings/localization support with web assets (JS/CSS/icon).

Project structure

• backend/: core Python logic (APIs, downloads, fixes, updates, settings).
• public/: front-end assets injected into Steam (luatools.js, styles, icon).
• scripts/: maintenance/development utilities.
• plugin.json: Millennium plugin metadata.

Requirements

• Steam installed.
• Millennium configured and running.
• Python 3.10+ (recommended).
• Dependencies listed in requirements.txt.

Installation (local/development)

1. Clone this repository into your Millennium plugins directory.

2. Install Python dependencies:

   pip install -r requirements.txt

3. Restart Steam/Millennium so the plugin is loaded.

Note: some paths and behaviors depend on your Steam and Millennium setup.

Typical usage

1. Launch Steam with Millennium.
2. Open the LuaTools interface in Steam.
3. Select a game (or use its AppID).
4. Add/remove Lua scripts or apply available fixes.
5. Review logs/status to verify each action.

Project status

Active project focused on Lua/fix workflow automation inside Steam.

License

This repository currently does not declare an explicit license.

---

Español

LuaTools es un plugin para Steam (Millennium) que facilita la instalación y gestión de scripts Lua y correcciones (fixes) para juegos, con una interfaz integrada directamente en Steam.

Descripción corta

LuaTools centraliza tareas comunes para usuarios de parches/mods basados en Lua: detectar juegos, añadir o quitar scripts, aplicar fixes, consultar APIs disponibles y mantener el plugin actualizado automáticamente.

Características principales

• Integración con la UI de Steam mediante Millennium.
• Instalación y eliminación de soporte LuaTools por AppID.
• Detección y aplicación de fixes para juegos compatibles.
• Gestión de estado de descargas y operaciones en segundo plano.
• Actualización automática del plugin y reinicio de Steam cuando corresponde.
• Soporte de configuración/localización y carga de recursos web (JS/CSS/icono).

Estructura del proyecto

• backend/: lógica principal en Python (APIs, descargas, fixes, actualización, configuración).
• public/: recursos front-end inyectados en Steam (luatools.js, estilos e icono).
• scripts/: utilidades de mantenimiento/desarrollo.
• plugin.json: metadatos del plugin para Millennium.

Requisitos

• Steam instalado.
• Millennium configurado y funcionando.
• Python 3.10+ (recomendado).
• Dependencias de requirements.txt.

Instalación (desarrollo/local)

1. Clona este repositorio en la carpeta de plugins de Millennium.

2. Instala dependencias Python:

   pip install -r requirements.txt

3. Reinicia Steam/Millennium para que el plugin cargue.

Nota: algunas rutas y comportamientos dependen de la instalación de Steam y del entorno Millennium.

Flujo de uso general

1. Inicia Steam con Millennium.
2. Abre la interfaz de LuaTools en Steam.
3. Busca el juego por AppID o selecciónalo desde la lista.
4. Añade/quita scripts Lua o aplica fixes disponibles.
5. Revisa estados y logs para confirmar cada operación.

Estado del proyecto

Proyecto activo, orientado a facilitar automatización de tareas Lua/fixes dentro de Steam.

Licencia

Este repositorio no declara una licencia explícita en este momento.