SteamTools 使用教程与清单入库指南
掌握在 Windows、macOS Whisky 与 Steam Deck 掌机上快速生成与安装 Steam 清单的完整流程。
四步极速入库流程
Step 1: Locate Game & Download Verified Package
Use the search bar on SteamToolsApp.com to find your desired Steam title (by name or numeric App ID). Click "Download ZIP Package" to retrieve the pre-compiled archive containing both the .lua script and the key.vdf depot decryption file.
Step 2: Extract Files into SteamTools Directory
Unzip the downloaded archive. Move the <appId>_public.lua script into your SteamTools installation folder under "plugins/lua/". Move the key.vdf depot key file into the "data/" directory.
Step 3: Launch SteamTools Desktop Client First
Start the SteamTools (Watt Toolkit) desktop application. Confirm that the local manifest routing engine and HTTP hook status indicator turns green.
Step 4: Launch Official Steam Client & Synchronize
Open your official Steam desktop client. Steam will automatically detect the local manifest descriptor, register the game in your active user library, and allow you to initiate high-speed depot downloads directly from Valve edge CDN servers.
How SteamTools Works
No technical knowledge needed. Get any game running in under 2 minutes.
Search & Generate
Enter any Steam App ID or game title in the generator above to instantly compile clean Lua scripts and depot keys.
Place in Directory
Extract the downloaded ZIP package and move the .lua and key.vdf files into the SteamTools plugins folder.
Launch & Synchronize
Restart SteamTools and open Steam. The game will automatically appear in your Steam library ready to play.
多平台环境配置详解
Detailed installation pathways tailored for Windows, macOS Whisky, and Steam Deck.
Windows 10 / 11 Native Setup
On Windows operating systems, SteamTools functions as a background hook process. Ensure your antivirus software (such as Windows Defender) whitelist the portable SteamTools directory, as manifest injection hooks can occasionally trigger false-positive heuristic flags.
The default file path for placing Lua scripts is: C:\Program Files (x86)\SteamTools\plugins\lua\. Always ensure the file is named in the format <appId>_public.lua.
macOS (Apple Silicon M1/M2/M3/M4 & Intel)
Mac users can run Windows Steam and SteamTools concurrently inside a dedicated Whisky or CrossOver bottle. Create a Windows 10 64-bit bottle, install the Windows Steam client, and install SteamTools in the same container.
Virtual bottle file path: drive_c/Program Files (x86)/SteamTools/plugins/lua/. Launch SteamTools inside Whisky before executing Steam.
Steam Deck (SteamOS 3.0+ Desktop Mode)
Hold down the Power button on your Steam Deck and select Switch to Desktop. Download the native Linux tarball edition of SteamTools and extract it to ~/.steamtools/.
Copy the downloaded manifest packages into ~/.steamtools/plugins/, run the synchronization script, and switch back to Gaming Mode to launch your games with native gamepad controls.
Lua 脚本核心参数与清单语法解析
Every manifest package generated by SteamToolsApp contains an optimized Lua table interpreted at runtime by the local proxy hook. Understanding these configuration keys helps advanced users customize branch parameters and DLC mapping:
Instructs the client hook to authorize all sub-depots associated with the main application package without requesting external licensing tokens.
Maps specific 64-bit manifest GID numbers to corresponding depot identifiers, locking the download to stable release builds.
Declares individual depot IDs, including executable binaries, sound packs, high-resolution textures, and DLC sub-trees.
Contains the 256-bit AES cryptographic decryption keys required by the content pipeline to assemble raw files from CDN nodes.
常见错误与故障排查矩阵
Error: "Manifest Unavailable" or "Connection Timeout"
This error occurs when Steam attempts to download content before SteamTools has established its local HTTP routing pipe. To resolve: completely exit Steam, start SteamTools as Administrator, verify the green status light, and relaunch Steam.
Error: "No Licenses" on Newly Released Game Titles
For recently launched titles or major game updates, Valve may rotate depot encryption keys. Visit SteamToolsApp.com, download the updated ZIP package for that App ID, and overwrite your old .lua script to receive fresh cryptographic hashes.
入库前检查清单与安全合规
Never inject Lua scripts while Steam is actively downloading or running. Exit Steam completely from system tray before starting SteamTools.
Ensure the numeric App ID matches the exact store page identifier to prevent depot decryption mismatch errors.
SteamTools modifies client-side descriptors without binary injection. For competitive multiplayer servers, official game licenses are recommended.
Local save files remain intact under AppData/Saved Games. No data loss occurs during manifest updates.
Everything You Need to Know
Q:What is SteamTools (Watt Toolkit)?
SteamTools is a lightweight open-source toolkit that manages local game configurations, depot keys, and Lua scripts to assist gamers in library management and offline testing.
Q:Is it safe to use SteamTools generated manifests?
Yes. SteamToolsApp compiles clean, open-source Lua scripts and standard key.vdf files without requiring your Steam password, tokens, or Web API keys. No system DLL injection is performed.
Q:Where do I put the downloaded .lua and key.vdf files?
Extract the downloaded ZIP package and drop both files directly into your SteamTools install directory. Then restart SteamTools and Steam.
Q:Does SteamTools work on macOS and Steam Deck?
Yes! SteamTools provides native builds for macOS (compatible with M1/M2/M3/M4 chips and Intel) as well as Linux distributions and Steam Deck (SteamOS).
Q:Why does my game not appear in Steam after copying files?
Ensure you completely closed and restarted both SteamTools and Steam. Files must be located in the root installation folder, not inside subfolders. Also verify that you are logged into your Steam client.