Sc2gears is a comprehensive, multi-platform StarCraft 2 utility designed for players, coaches, and analysts who need deep insights into their gameplay. Built on Java, it offers a consistent experience across Windows, macOS, and Linux environments.
Installation Guide
To get started, download the latest archive from the official repository. Extraction is straightforward: place the files in any directory you prefer. No complex installer is required.
Platform-Specific Setup:
On Unix-based systems (Linux and macOS), you must manually grant execution permissions to the starter scripts. In my experience, the most reliable way is via the terminal:
1. Open your terminal and navigate to the Sc2gears directory.
2. Execute the appropriate command:
Linux:
OS-X:
Once permissions are set, launch the application using:
Windows: Double-click
Linux:
OS-X:
Sc2gears features an automated self-updater. Upon startup, the program checks for new versions and prompts you to update. This process is designed to be safe: it preserves your "User content" folder, ensuring your settings, logs, and replay lists remain intact while updating the core binaries.
If the automated process fails, you can manually migrate by downloading the new version and copying your existing "User content" folder into the new directory.
Technical Requirements
The application requires the Java Runtime Environment (JRE) 6.0 or newer. For the best visual experience, specifically the Nimbus theme, Java 6.0 Update 10 or higher is recommended. Notably, Sc2gears is a standalone parser; you do not need StarCraft 2 installed on the machine to analyze replay files.
Official Java Download: https://java.com/
Security and Compliance
It is important to clarify that Sc2gears is not a "cheat" or a 3rd party hack. It functions as an independent parser. It does not hook into the StarCraft 2 process, nor does it read or modify game memory. Because it only interacts with saved
Search Filters and Logic:
The parser extracts nearly every data point from the replay file, including:
Practical Example: To find games on "Metalopolis" featuring either "Dakota" or "TheWinds":
Data Management Features:
This powerful filter uses shorthand notation: P (Protoss), T (Terran), Z (Zerg), R (Random). Use 'v' for teams and '*' as a wildcard.
Example: "ZvZ" with "Exact match" enabled will exclude team games like ZTvZP, focusing strictly on 1v1 Zerg mirrors.
Installation Guide
To get started, download the latest archive from the official repository. Extraction is straightforward: place the files in any directory you prefer. No complex installer is required.
Download the Latest Release
Sc2gears for all operating systems (Windows, Linux, and macOS): Sc2gears-0.82 (1.28 MB)Platform-Specific Setup:
On Unix-based systems (Linux and macOS), you must manually grant execution permissions to the starter scripts. In my experience, the most reliable way is via the terminal:
1. Open your terminal and navigate to the Sc2gears directory.
2. Execute the appropriate command:
Linux:
chmod +x Sc2gears-linux.shOS-X:
chmod +x Sc2gears-os-x.shOnce permissions are set, launch the application using:
Windows: Double-click
Sc2gears-win.cmdLinux:
./Sc2gears-linux.shOS-X:
./Sc2gears-os-x.shUpdating Your Software
Sc2gears features an automated self-updater. Upon startup, the program checks for new versions and prompts you to update. This process is designed to be safe: it preserves your "User content" folder, ensuring your settings, logs, and replay lists remain intact while updating the core binaries.
If the automated process fails, you can manually migrate by downloading the new version and copying your existing "User content" folder into the new directory.
Technical Requirements
The application requires the Java Runtime Environment (JRE) 6.0 or newer. For the best visual experience, specifically the Nimbus theme, Java 6.0 Update 10 or higher is recommended. Notably, Sc2gears is a standalone parser; you do not need StarCraft 2 installed on the machine to analyze replay files.
Official Java Download: https://java.com/
Security and Compliance
It is important to clarify that Sc2gears is not a "cheat" or a 3rd party hack. It functions as an independent parser. It does not hook into the StarCraft 2 process, nor does it read or modify game memory. Because it only interacts with saved
.SC2Replay files, it remains fully compliant with Blizzard's Terms of Use. You can use it safely without risk of account suspension.Advanced Replay Search
The search engine operates on a replay source—a defined set of folders or specific files. The engine recursively scans these sources to build a searchable database.Search Filters and Logic:
The parser extracts nearly every data point from the replay file, including:
- Player names, map names, and match-up types.
- Specific units trained, buildings constructed, and abilities/spells cast.
- In-game chat logs.
Practical Example: To find games on "Metalopolis" featuring either "Dakota" or "TheWinds":
- Input "Metalopolis" in the map name group.
- Input "Dakota" in the player name group.
- Click the green plus icon to add a field to the player group and input "TheWinds".
Data Management Features:
- Exporting: Save replay lists as UTF-8 encoded CSV files, which are natively compatible with Microsoft Excel for advanced statistical modeling.
- Batch Operations: Right-click selections to move, copy, delete, or pack replays into ZIP archives.
- Renaming: Use custom templates to batch-rename files based on replay metadata.
This powerful filter uses shorthand notation: P (Protoss), T (Terran), Z (Zerg), R (Random). Use 'v' for teams and '*' as a wildcard.
Example: "ZvZ" with "Exact match" enabled will exclude team games like ZTvZP, focusing strictly on 1v1 Zerg mirrors.
Replay Analyzer Deep-Dive
The analyzer provides a granular breakdown of player performance through several specialized modules:- APM Chart: Tracks Actions Per Minute over the duration of the match.
- Hotkeys: Analyzes control group assignments and selection frequency.
- Builds/Tech: A chronological timeline of production, research, and upgrades.
- In-game Chat: A timestamped log using player-specific colors.
- Granularity: Adjust the APM curve approximation (linear vs. cubic) to better visualize macro-cycles versus micro-intensive spikes.
- Synchronization: The chart marker is synced with the action list; clicking a spike in the APM chart will highlight the exact actions in the list below.
- Navigation: Use
CTRL+Ito zoom in andCTRL+Uto zoom out. Quickly jump to specific frames usingCTRL+J.
Miscellaneous Features
- Localization: Supports multiple languages. Contributors can submit new translations via the Translation page.
- MDI Architecture: Open multiple analyzers and search tabs simultaneously. Use
CTRL+TABto cycle through active windows. - Performance: Multi-threading ensures that a heavy replay search won't freeze the UI or interrupt an active analysis.
- UI Customization: Includes various "Look and Feel" themes. While "Nimbus" offers a modern aesthetic, "Metal" provides a balanced performance profile for older systems.
| Action | Close Active | Next Window | Context Menu | Restore Size | Toggle Navigation |
| Shortcut | CTRL+F4 | CTRL+TAB | CTRL+SPACE | CTRL+F5 | F6 |