Troubleshooting

Troubleshooting

This page lists common OpenLuaTools problems and the first things to check.

OpenLuaTools does not appear in Millennium

Check:

• Millennium is installed and working.
• The plugin folder is inside the Millennium plugins directory.
• plugin.json is at the root of the OpenLuaTools folder.
• plugin.json contains the plugin name openluatools.
• Steam has been restarted after installation.

OpenLuaTools button/icon is missing or blank

Try:

1. Restart Steam.
2. Disable and re-enable OpenLuaTools in Millennium.
3. Confirm the public/ folder exists in the plugin install.
4. Confirm public/openluatools-icon.png exists.
5. Confirm the plugin can copy webkit assets into Steam's steamui/webkit folder.

The 1.0.0 release includes a fix for the header icon fallback issue.

Script install says Steam path could not be found

OpenLuaTools needs to detect the Steam install path before it can write to OpenSteamTool's Lua folder.

Try:

• Restart Steam.
• Confirm Steam is installed normally.
• Confirm OpenSteamTool is installed and working.
• Confirm the current Windows user can write to the Steam folder.
• Avoid running a half-moved Steam install without fixing its registry/path data.

Script install fails with archive or path errors

OpenLuaTools rejects unsafe archive entries and unexpected filenames.

Common causes:

• The archive does not contain the expected <appid>.lua file.
• The archive uses nested or unusual paths.
• A manifest file does not match the expected numeric manifest filename format.
• The archive contains path traversal entries such as ../.
• The destination path is outside the allowed folder.

Use a trusted archive and verify its contents before trying again.

Script installs but does not show as installed

Check:

• The file exists in <Steam>/config/lua.
• The filename matches the app ID, for example 123456.lua.
• The file is not disabled as 123456.lua.disabled.
• Steam was restarted after installation.
• OpenSteamTool is watching the expected <Steam>/config/lua directory.

API check says not available

Possible reasons:

• The configured source is offline.
• The configured source requires an API key.
• Your API key is missing or invalid.
• The source returned a non-success HTTP status.
• Your firewall, DNS, VPN, or antivirus blocked the request.

Try another trusted source or check again later.

A fix/helper archive applies but there is no uninstall entry

Some reverse/uninstall features are not fully implemented in the backend yet.

Before applying helper archives:

• Back up the game folder.
• Note which files are changed.
• Use Steam's verify-files feature if you need to restore original files.

Report a bug

When opening an issue, include:

• OpenLuaTools version.
• Millennium version.
• OpenSteamTool version.
• Steam client branch, if relevant.
• What you clicked.
• What you expected.
• The visible error message.
• Relevant logs, with API keys and personal paths removed.

Do not include API keys, account tokens, or private files.