Skip to main content

useSimpleAchievements

useSimpleAchievements(): object

Defined in: src/hooks/useSimpleAchievements.ts:8

A simplified hook for achievement tracking. Provides the v4 happy path for direct metric updates plus explicit state names.

Returns​

all​

all: AchievementWithStatus[] = achievementState.allAchievements

Deprecated​

Use allAchievements instead. This alias will be removed in 5.0.

allAchievements​

allAchievements: AchievementWithStatus[] = achievementState.allAchievements

exportData()​

exportData: () => string

Returns​

string

getAllAchievements()​

getAllAchievements: () => AchievementWithStatus[]

Returns​

AchievementWithStatus[]

getState()​

getState: () => object

Returns​

object

metrics​

metrics: Record<string, any>

unlocked​

unlocked: string[]

importData()​

importData: (jsonString, options?) => ImportResult

Parameters​

jsonString​

string

options?​

ImportOptions

Returns​

ImportResult

increment()​

increment: (metric, amount) => AchievementUpdateResult

Parameters​

metric​

string

amount​

number = 1

Returns​

AchievementUpdateResult

metrics​

metrics: AchievementMetrics = achievementState.metrics

reset()​

reset: () => void

Returns​

void

totalCount​

totalCount: number = achievementState.totalCount

track()​

track: (metric, value) => void

Parameters​

metric​

string

value​

any

Returns​

void

trackMultiple()​

trackMultiple: (metrics) => void

Parameters​

metrics​

Record<string, any>

Returns​

void

unlocked​

unlocked: string[] = achievementState.unlockedIds

Deprecated​

Use unlockedIds instead. This alias will be removed in 5.0.

unlockedAchievements​

unlockedAchievements: AchievementWithStatus[] = achievementState.unlockedAchievements

unlockedCount​

unlockedCount: number = achievementState.unlockedCount

unlockedIds​

unlockedIds: string[] = achievementState.unlockedIds