Hit Counts

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

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 Reset If and PauseIf flags can also have hits. Follow the links for details.

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

• Using Hit Counts as a Timer
• Using Delta Values and Hit Counts to Detect an Increment

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

Last 10 changes on this page:

• [2022-07-27 19:31] Searo: Page doesn't exist and we don't care what softcore users do anymore
• [2021-07-17 07:27] Jamiras: Updated Hit Counts (markdown)
• [2021-07-17 07:27] Jamiras: add section detailing behavior at reset/power on
• [2019-02-18 17:01] meleu: fix broken links
• [2019-02-12 13:10] meleu: fix broken links
• [2019-02-12 09:23] meleu: Updated Hit Counts (markdown)
• [2019-02-12 09:21] meleu: Created Hit Counts (markdown)