EPTLast Updated: Wednesday, Aug 11 4:20am GMT (GMT+00:00)
Source code: http://github.com/tec27/APMAlert2
Someone asked me to update the old APMAlert plugin for SC2, and since I realized that its actually almost easier now since SC2 outputs APM data to the registry (to interface with the Razer SC2 peripherals), I decided I'd go ahead and do it. For those of you that don't know what this does:
Features of APMAlert2:
- Configurable minimum APM you would like yourself to keep
- Configurable sound for it to play when you fall below this minimum APM
- LiveAPM display ingame (only activates after you have built your first building. This is to prevent the program from being annoying when you're watching replays/playing UMS)
- HellItsAboutTime display (ingame clock display for current real world time)
- Customizable colors and fonts for all text displays, including different coloring for specific APM ranges
- Customizable positioning for all displays, including horizontal/vertical centering
- Hotkey for quickly toggling sound alert
Features that will NOT be implemented:
- Game Timer
- Displaying APMs of other players while Observing/In Replays (not really necessary anyway, given that SC2 already does this)
- Electro-shock alerts
Features I would like to implement in the future:
- Ingame configuration GUI
- Locking/unlocking the displays and moving them around with the mouse
- Borders and text effects
- Customizable texturing
- Graphical Clock(s)
Screenshots:
![[image loading]](http://tec27.com/APMAlert2/apmalert2-standard.jpg)
APMAlert2 with the default settings
![[image loading]](http://tec27.com/APMAlert2/apmalert2-realgood.jpg)
APMAlert2 with settings for people who understand what the real game is
Requirements:
- Windows XP/Vista/7
- .NET Framework 3.5 (Download here.)
- Microsoft VS 2010 Runtime Files (Download here.)
- Starcraft 2
Install Guide:
- Download APMAlert2 and PSI Starcraft Injector from here: http://tec27.com/APMAlert2/APMAlert2.zip
- Unzip the file wherever you would like to keep APMAlert2.
- If you are using Windows 7 or Vista and you have UAC enabled (if you don't know what that is, you do), you MUST run PSI as administrator for this to work. To make this always happen, simply right click PSIStarcraftInjector.exe and choose Properties. Then go to the compatibility tab and check 'Run this program as an administrator'.
- Run PSIStarcraftInjector.exe and the configuration window should pop up. As long as this program is running, APMAlert will be run for each instance of SC2. If you don't want this to happen, simply exit this program before starting SC2. Otherwise, you can set your configuration and minimize PSI (which will live in your system tray), and it will do its job. Any settings changes will be applied at the beginning of each new SC2 game (except for the alert hotkey, this can only be updated after SC2 is restarted).
- The current version of PSI cannot do automatic updates, so be sure to check this thread frequently for new versions, especially if you're having problems. I will try to keep a changelog up to date here.
Notes About Configuration:
- When configuring positions for the various displays, X/Y are specified by percentage. Therefore the maximum value for each of these is 1.0, and minimum is 0.0. If you want to specify an exact pixel value, you can simply divide the desired pixel location by your SC2 width/height. IE: For a pixel location of 10,10 on a 1280 by 1024 window, the X would be 10/1280=0.0078125 and the Y would be 10/1024=0.0097656.
- The default alert toggle hotkey is Ctrl+Alt+Shift+Backslash
- Restoring defaults will immediately write the defaults to the registry, so be careful doing this if you don't want to lose settings
- The custom APM value colors are checked from the bottom up. That is, if the last value is below your current APM, that color will be used even if the second-to-last value is closer but still below your APM. So if you'd like to input only a few custom colors, but not all 5, I recommend you start with the very bottom one and work up until you've input all your colors.
Ethical Considerations:
APMAlert (that is, the alert itself, not the two displays it also comes with) should only be used as a training tool. You should not under any circumstances use it in games that are not for training and/or are highly meaningful (IE: Tournaments, Showmatches, etc.). I can't control what you do with it, but I think most of you can handle that responsibility and its usefulness dwindles for those at the top of the game anyway.
Changelog
+ Show Spoiler +
- August 11th 2010
- Changed DirectX/D3DX/WinMM to load dynamically to provide better error handling
- August 10th 2010
- Added a message if the injector fails to load.
- Fixed a problem that prevented you from disabling the LiveAPM/Clock display
- Tweaked the APM calculation algorithm to decay faster. This feels closer to actual APM but still definitely needs tweaking.
- Added a message if the injector fails to load.
- August 9th 2010
- Lowered the .NET target to 3.5
- Fixed an issue with portraits ingame (I think)
- Lowered the .NET target to 3.5
- August 9th 2010
- More specific error messages for DLL Injection failure
- Safer log file creation
- More specific error messages for DLL Injection failure
- August 7th, 2010
- Logging to a text file added
- August 7th, 2010
- APMAlert2 released!
Known Bugs:
- Changing Between Windowed/Fullscreen while playing a game could result in a crash
Please post in this thread if you have any questions or problems and I'll do my best to help! Suggestions for new features or different programs are also welcome!
Also, currently I am not sure I am satisifed with how APM is calculated in APMAlert2. If you notice that your APM is too high, not dynamic enough, or just feels wrong, please mention it. I'm still trying to work out the kinks in that. (Also, the APM used is actual APM, IE: 1.38 * what Blizzard says your APM is).
One last thing: If you have any cool sounds that you're using to alert yourself to speed the hell up, please post them in this thread. I plan on compiling a pack of alert sounds for people to easily choose from and releasing that within the next few days.
If you are having problems or cannot get it working, please post the contents of apmalert2.log from the directory you have PSI in. If you cannot find the log there, check <Your Starcraft 2 Folder>\Support\ for it.
Known Fixes:
- If you receive a LoadLibrary error with code 126 or 127, please download and install the file located at: http://tinyurl.com/g7juc . This should fix that issue for you.
![[image loading]](http://i129.photobucket.com/albums/p228/waffles_breakfast/apmchangecopy.jpg)
caution.
