User Guide

User Guide

OpenLuaTools adds an OpenSteamTool-focused Lua script management interface to Steam through Millennium.

Main tasks

OpenLuaTools is designed around these tasks:

• Check whether a supported Lua script is present for an app.
• Install an OpenSteamTool Lua script into <Steam>/config/lua.
• List installed Lua scripts.
• Delete installed Lua scripts.
• Check configured sources for availability.
• Manage API source settings.
• Apply supported helper/fix archives when appropriate and lawful.
• Change plugin settings, language, and appearance options.

Installed script location

OpenLuaTools targets this folder:

<Steam>/config/lua

Installed scripts are expected to use app ID based filenames such as:

123456.lua

Disabled scripts may appear as:

123456.lua.disabled

Adding a script

The exact UI may change, but the normal flow is:

1. Open the Steam page for the relevant app.
2. Open the OpenLuaTools interface.
3. Check available configured sources.
4. Start the add/install action only if you are allowed to use the selected script.
5. Wait for the download and extraction process to finish.
6. Restart Steam if required.

OpenLuaTools extracts downloads into a temporary plugin folder first, validates them, then copies only expected files into the Steam/OpenSteamTool folders.

Removing a script

To remove an installed OpenSteamTool Lua script:

1. Open the OpenLuaTools installed scripts view.
2. Find the app ID or script entry.
3. Use the delete/remove action.
4. Restart Steam if the change does not appear immediately.

The backend removes matching files from <Steam>/config/lua, including:

<appid>.lua
<appid>.lua.disabled

Game helper/fix archives

OpenLuaTools includes logic for checking and applying supported helper/fix archives. OpenLuaTools validates archive paths before copying files into a game folder, but you should still treat third-party archives carefully.

Reading status messages

During downloads or fix application, OpenLuaTools uses status states such as:

• queued
• downloading
• extracting
• processing
• done
• failed

If a task fails, copy the visible error and check Troubleshooting.