Skip to content

Hit Counts

In the Achievement Editor, the field on the far right side is Hit Count.

Hit Count Field in Editor

The default is Zero, which means the condition must be true for the achievement to trigger.

If you set a target hit count, like 5, it means the condition must be true for at least that many frames, and once that hit count target is met, it doesn't need to be met again at any other time.

PLEASE NOTE: if a condition has a non-zero hit count, and reaches the number required, this condition is no longer tested. It remains true, UNLESS you have a ResetIf, which we will discuss below.

Conditions with ResetIf and PauseIf flags can also have hits. Follow the links for details.

In the Real Examples section there are two examples good examples:

Effect of Resetting the Emulator

When the emulator is reset, all hits are immediately zeroed out and the achievement is set back to Waiting. However, an emulator reset does not clear out memory, so it's possible for the hits to reaccumulate before the game reinitializes the memory. As such, you should not rely on the hits being cleared out by the emulator reset.

Similarly, when the emulator first "powers on", the state of memory is not guaranteed to be consistent as true hardware does not initialize its memory. Instead, the software sets some initial state when it claims portions of memory. Some games actually rely on the random nature of the uninitialized memory to seed their random number generators.

For both cases, you should have an explicit reset for some piece of knowable logic, like the player being on the title screen.

Changelog

Released under the GPL-3 License. There are no copyright-protected ROMs available for download on RetroAchievements.