Skip to content

About

AutoTG Lua Game GUI Automation Testing Framework 2026

Topics

Resources

Stars

56 stars

Watchers

0 watching

Forks

Latest commit

 

History

135 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

preview Download

AutoTG ✨

Script‑driven automation for games and desktop GUIs — no more repetitive clicking, just pure logic. AutoTG empowers you to capture screen events, simulate input, and orchestrate complex test flows using the expressive power of Lua. Think of it as a universal remote for your applications, but instead of pressing buttons, you write poetry in code.


📖 Table of Contents


🚀 Why AutoTG?

Most automation tools force you into rigid, click‑and‑record workflows. AutoTG flips that script. Here, you don't just record – you compose. Whether you're verifying a game's UI after a patch, stress‑testing a legacy desktop application, or building a regression suite that runs while you sleep, AutoTG gives you the keys.

Built with a lightweight Lua runtime and a native input/screen capture layer, AutoTG bridges the gap between "it works on my machine" and "it works everywhere, every time."


🔑 Key Features

  • 🎮 Game & GUI agnostic – Works with DirectX, OpenGL, Vulkan, and standard windowed apps.
  • 📜 Lua scripting engine – Full Lua 5.4 with sandboxed I/O and coroutine support.
  • 🖱️ Pixel‑perfect input simulation – Mouse, keyboard, gamepad, and touch emulation.
  • 🖼️ Screen capture & image recognition – Template matching, OCR hooks, and colour probes.
  • ⏱️ Deterministic timing – Millisecond‑accurate waits, frame‑sync options, and retry logic.
  • 🧩 Modular test suites – Organise scripts into suites, share fixtures, and generate reports.
  • 📊 JUnit XML & HTML reporting – Plug into your CI/CD pipeline without friction.
  • 🌐 Cross‑platform – Runs on Windows, Linux (X11/Wayland), and macOS.
  • 🔒 Sandboxed execution – No arbitrary file system access unless explicitly allowed.
  • 📦 Zero‑configuration bootstrap – Drop a single binary and start scripting in seconds.

⚙️ How It Works

AutoTG operates on a simple three‑layer model:

  1. Perception – Captures the screen, reads pixels, and optionally runs OCR or template matching.
  2. Decision – Your Lua script interprets the captured data using conditions, loops, and state machines.
  3. Action – Simulates input events (clicks, keys, swipes) back into the application.

Because everything is script‑driven, you can version‑control your tests, diff changes, and review automation logic like any other code.


🎯 Use Cases & Metaphors

  • The Night Watchman – Run a script that monitors a game's login screen for 12 hours, alerting you if the server goes down.
  • The Tireless Tester – Simulate 10,000 clicks on a UI button to see if memory leaks appear.
  • The Choreographer – Sequence complex combos in a fighting game to verify hitboxes after a balance patch.
  • The Archaeologist – Automate a 20‑year‑old Windows 95 inventory app that no one remembers how to test manually.
  • The Multilingual Guardian – Switch languages in your app and verify that all labels render correctly.

📱 Responsive UI & Multilingual Support

AutoTG's companion dashboard (optional) adapts to any screen size – from a 4K monitor to a tiny VM window. The interface is built with a responsive layout that scales gracefully.

Scripts and error messages are available in English, Spanish, German, Japanese, and Simplified Chinese. The Lua API remains language‑agnostic; only the human‑readable strings change.


🛎️ 24/7 Customer Support

Our support team never sleeps – much like AutoTG itself. Whether you're stuck on a tricky image‑recognition threshold or need help integrating with your CI runner, reach out any time. We provide:

  • Community forum with searchable archives.
  • Direct email ticketing with a 4‑hour response SLA.
  • Live chat during regional business hours (with after‑hours bots that escalate to humans).

🔍 SEO‑Friendly Summary

If you're searching for game automation with Lua, GUI test automation scripts, or desktop input simulation tools, AutoTG is built for you. Keywords like scriptable UI testing, cross‑platform automation, and Lua‑driven regression suites are not just buzzwords – they're the pillars of this project. Use AutoTG to reduce manual QA hours, increase test coverage, and catch regressions before your users do.


📜 License

This project is distributed under the MIT License. You are welcome to use, modify, and share it – just keep the original copyright notice.

👉 View the full MIT License text

Copyright (c) 2026 coolxv and contributors.


⚠️ Disclaimer

AutoTG is intended for legitimate testing, automation, and accessibility purposes only. You must own or have explicit permission to automate the applications you target. The authors are not responsible for any misuse, including violation of terms of service, unintended data loss, or hardware wear. Always test in a controlled environment before deploying to production. This software is provided "as is", without warranty of any kind.


Download

About

AutoTG Lua Game GUI Automation Testing Framework 2026

Topics

Resources

Stars

56 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages