ASF-FreeGames is a plugin for ArchiSteamFarm allowing one to automatically collect free steam games ๐ posted on Reddit.
- โ a working ArchiSteamFarm environment
- ๐ฝ Download latest Dll from the release page
- โก๏ธ Move the dll into the
pluginsfolder of your ArchiSteamFarm installation - ๐ (re)start ArchiSteamFarm
- ๐ Have fun
Every โฐ30 minutes the plugin starts ๐ฌanalyzing reddit for new free gamesโพ.
Then every ๐addlicense asf appid command found is broadcasted to each currently logged bot ๐ช.
freegamesto collect free games right now ๐getipto get the IP used by ASF ๐setto configure this plugin's options (see below) ๐ ๏ธ
For information about issuing ๐ขcommands see ASF's wiki
The plugin behavior is configurable via command
freegames set nof2pto โprevent the plugin from collecting free to play gamesfreegames set f2pto โ๏ธallow the plugin to collect f2p (the default)freegames set nodlcto โprevent the plugin from collecting dlcfreegames set dlcto โ๏ธallow the plugin to collect dlc (the default)
In addition to the commands above, the configuration is stored in a ๐config/freegames.json.config JSON file, which one may ๐ edit using a text editor to suit their needs.
The plugin can be configured to use a proxy (HTTP(S), SOCKS4, or SOCKS5) for its HTTP requests to Reddit. You can achieve this in two ways:
- Environment Variable: Set the environment variable
FREEGAMES_RedditProxywith your desired proxy URL (e.g.,http://yourproxy:port). freegames.json.config: Edit theredditProxyproperty within the JSON configuration file located at<asf>/config/freegames.json.config. Set the value to your proxy URL.
Example freegames.json.config with Proxy:
{
...
"redditProxy": "http://127.0.0.1:1080"
}Important Note: If you pass a proxy password, it will be stored in clear text in the freegames.json.config file, even when passing it via the environment variable.
Note: Whichever method you choose (environment variable or config file), only one will be used at a time. The environment variable takes precedence over the config file setting.
- There's nothing wrong (most likely), those error messages are the result of the plugin trying to add a steam key which is unavailable. With time those errors should occurs less frequently (see #3 for more details).
The plugin supports checking for updates on GitHub. You can enable automatic updates by modifying the PluginsUpdateList property in your ArchiSteamFarm configuration (refer to the ArchiSteamFarm wiki for details).
Important note: Enabling automatic updates for plugins can have security implications. It's recommended to thoroughly test updates in a non-production environment before enabling them on your main system.
Simply execute dotnet build ASFFreeGames -c Release and find the dll in ASFFreeGames/bin folder, which you can drag to ASF's plugins folder.