$ show maxisoft/ASFFreeGames
This repository contains ASFFreeGames, a plugin for ArchiSteamFarm (ASF) that automatically collects free Steam games from Reddit and Redlib sources. The plugin monitors the ASFinfo Reddit user for posts containing "!addlicense asf" commands, extracts game identifiers from these posts, and uses ASF's addlicense command to claim those games for all logged-in bots. It operates on a configurable schedule (default 30 minutes) and can also be triggered manually via the "freegames" command. The architecture follows a plugin pattern with clear separation of concerns: core plugin logic handles ASF integration and scheduling, command processing manages user interactions, strategy objects encapsulate different data source approaches (Reddit vs Redlib), and specialized parsers handle the extraction of game information from HTML/JSON responses. The plugin maintains a persistent cache of already-claimed games to prevent duplicates and supports configuration options for filtering results (e.g., skipping free-to-play games or DLC). Notably, the project contains several high-quality, reusable utility components in the Maxisoft.Utils namespace. These include BitSpan (a high-performance bit array using span<long>), SpanDict (a dictionary implementation using spans with linear probing), OrderedDictionary (a dictionary that preserves insertion order), and RandomUtils (a Gaussian random number generator using the Box-Muller transform). These utilities demonstrate advanced .NET span usage and algorithmic implementation skills, with minimal dependencies making them suitable for extraction to other projects. The project is actively maintained with recent commits, comprehensive CI/CD workflows, and targets the latest .NET 9.0 framework. Dependencies appear current, and the codebase shows no significant technical debt or use of deprecated APIs. The plugin properly handles edge cases like rate limiting, network failures, and invalid responses while providing configurable logging options.
The LLM identified 4 files worth highlighting for reuse:
Implements a high-performance bit array using span<long> for storage. Provides efficient bit-level operations (Get, Set, And, Or, Xor, Not) with enumerator support. Demonstrates advanced span usage and bit manipulation techniques. Completely self-contained with no internal dependencies, making it easily extractable for use in any project requiring efficient bit storage or flags.
Implements a dictionary data structure using span<KeyValuePair<TKey, TValue>> for storage with linear probing collision resolution. Provides standard dictionary operations (Add, Get, Remove, Contains) with O(1) average complexity. Demonstrates sophisticated hash table implementation and span usage. Zero internal dependencies allow easy extraction to other projects needing a high-performance dictionary alternative.
Implements a dictionary that maintains insertion order of elements, combining IDictionary<TKey, TValue> behavior with predictable iteration order. Uses internal list for ordering and dictionary for fast lookups. Demonstrates skill in combining multiple data structures to achieve specific behavior. Only depends on JetBrains.Annotations (NuGet) and standard libraries, making it highly reusable.
Implements a Gaussian (normal) random number generator using the Box-Muller transform. Provides NextGaussian() method for generating random numbers with specified mean and standard deviation. Demonstrates proper statistical random number generation techniques. Completely self-contained with only standard .NET dependencies, suitable for use in simulations, games, or any application requiring normally distributed random values.