CLua - Macro Tool

🧩 CLua – Introduction

CLua is a standalone Lua script runner, originally designed as a flexible and extensible macro tool to support modding for the game Original War. Its goal was to make modders’ lives easier — but it has since grown into a more universal tool.

It is now suitable for a wide range of automation and scripting tasks.

💾 Available Versions

CLua is provided as a console application for:

  • 🪟 Windows Run directly via CLua.exe
    (The console opens automatically)

  • 🐧 Linux Run directly via clue binary file or manualy via console/terminal
    (To ensure the console opens automatically)

🔍 What CLua Can Do

CLua is written in C# and uses a custom embedded Lua engine to execute scripts. It is designed to support modular Lua code with features like:

  • User interface elements (windows, buttons, text, progress bars…)
  • Working with .xlsx spreadsheets (no MS Excel required)
  • Text file generation
  • Nested scripting via import()
  • Modular architecture with support for custom code extensions

The GUI layer is powered by Terminal.GUI 1.7.

🔐 Security Restrictions

CLua is focused on safe macro scripting, and therefore:

  • Certain native Lua features are disabled to prevent unrestricted system access (io, os, debug, package, loadfile, and dofile)
  • Scripts are sandboxed — they cannot access files outside the CLua directory (All paths are relative to the CLua folder. Attempts to read files outside it will result in an error.)

This ensures that even community-provided scripts cannot perform unintended system operations.

🧪 Development Note

CLua is still in active development and will be expanded over time. That said, it already allows you to build powerful, readable, and efficient macros.

📜 License

CLua is provided as an open tool for non-commercial use. The source code will be made available on GitHub for custom modification in the future.