Addon ID

  • epicgamesplus_ext

Info

Statistics

  • Download count3 total downloads
  • Latest download count 3 downloads of latest version
  • Average download count1 downloads per day average

Owners

A list of all Actions, Conditions and Expressions supported in this addon.

Epic Games Plus

  • Actions

    Refresh status

    Refresh availability and Product User readiness from the official Epic Games plugin.

    Clear cached player achievements and stats

    Clear cached player achievement and stat data. Use this when the signed-in Epic account changes; achievement definitions are retained.

  • Conditions

    Is available

    True when the companion can access the EOS Achievements and Stats interfaces supplied by Scirra's official Epic Games plugin.

    Achievement/stat user is ready

    True after Scirra's official Epic Games plugin completes EOS Connect login and supplies the Product User ID. Check achievement state and other player operations wait for this automatically.

    On status refresh success

    Triggered after Refresh status successfully checks the official plugin's current EOS handles.

    On status refresh error

    Triggered when Refresh status cannot communicate with the native companion.

  • Expressions

    LastResultCode

    The numeric EOS or companion result code for the current completion trigger. Read it inside an error trigger.

    LastResultText

    Readable result text for the current completion trigger. Read it inside an error trigger.

    AffectedCount

    The number of stats or achievements reported as affected by the latest write operation.

Achievements

  • Actions

    Check achievement {0} state on EOS

    Starts a fresh EOS QueryPlayerAchievements request for the current Product User ID. Definitions are queried automatically when required so locked hidden achievements can be identified. Every invocation completes through exactly one unlocked, locked, or error trigger. This action never unlocks an achievement; use Scirra's official Epic Games plugin for that.

    Add {2} progress to achievement {0} threshold {1}

    Add to the EOS stat threshold linked to an achievement. Achievement definitions are queried automatically on first use; completion is reported by the existing success/error triggers.

    Query player achievements

    Query and cache the local player's progress and unlock state for all achievements. Achievement definitions are queried automatically first when needed so locked hidden achievements are included.

    Query achievement definitions

    Query and cache all achievement definitions, including localized text, icons, hidden state and stat thresholds.

  • Conditions

    Achievement {0} state is known

    True only when the latest successful EOS player-achievement query contains this achievement. Check achievement state prepares this automatically.

    Achievement {0} is unlocked

    True only when the latest successful EOS query contains this achievement and reports an unlock time or 100% progress.

    Achievement {0} is locked

    True only when the latest successful EOS query contains this achievement and reports it as not unlocked. Unknown IDs are never treated as locked.

    Has cached player achievement {0}

    True when the current successful player-achievement query contains the specified achievement.

    Has achievement definition {0}

    True when the specified achievement definition is in the local cache. Query achievement definitions first.

    Player achievement cache is ready

    True after Query player achievements has completed successfully for the current Product User. Check unlock state only while this is true.

    Achievement definitions cache is ready

    True after achievement definitions have been queried successfully. Query player achievements automatically prepares this cache first.

    On checked achievement {0} is unlocked

    Triggered when a fresh EOS player-achievement query confirms this achievement is already unlocked. Do not call the official unlock action from this trigger.

    On any checked achievement is unlocked

    Triggered when a fresh EOS query confirms any requested achievement is already unlocked. TriggerAchievementId identifies it.

    On checked achievement {0} is locked

    Triggered when a fresh EOS player-achievement query confirms this achievement is still locked. Call Scirra's official Epic Games Unlock achievement action from this trigger.

    On any checked achievement is locked

    Triggered when a fresh EOS query confirms any requested achievement is still locked. TriggerAchievementId identifies it; use Scirra's official plugin to unlock it.

    On achievement {0} state check error

    Triggered when the fresh EOS achievement-state request for this achievement fails. Use LastResultCode and LastResultText inside this trigger.

    On any achievement state check error

    Triggered when any fresh EOS achievement-state request fails. TriggerAchievementId identifies the request; LastResultCode and LastResultText describe the failure.

    On add achievement {0} progress success

    Triggered when EOS accepts ingestion of the stat linked to the selected achievement threshold. Query player achievements later to refresh cached progress.

    On add achievement {0} progress error

    Triggered when the linked stat cannot be resolved from cached achievement data or EOS rejects the ingest request.

    On query player achievements success

    Triggered after EOS returns and caches the local player's achievement progress and unlock states.

    On query player achievements error

    Triggered if EOS cannot query the local player's achievement data.

    On query achievement definitions success

    Triggered after EOS returns and caches the localized achievement definitions.

    On query achievement definitions error

    Triggered if EOS cannot query achievement definitions. LastResultCode and LastResultText contain details.

  • Expressions

    TriggerAchievementId

    The achievement ID associated with the current achievement-related trigger.

    PlayerAchievementCount

    The number of cached player achievement records.

    PlayerAchievementIdAt

    The achievement ID at a zero-based cached player-achievement index.

    AchievementProgress

    The cached overall achievement progress percentage from 0 to 100.

    AchievementUnlockTime

    The cached Unix unlock timestamp, or -1 while locked.

    PlayerAchievementDisplayName

    The localized display name returned with cached player progress data.

    PlayerAchievementDescription

    The localized description returned with cached player progress data.

    PlayerAchievementIconURL

    The icon URL returned with cached player progress data.

    PlayerAchievementFlavorText

    The flavor text returned with cached player progress data.

    AchievementStatCount

    The number of stat progress records associated with a cached player achievement.

    AchievementStatName

    The stat name at a zero-based player-achievement stat index.

    AchievementStatCurrent

    The current stat value at a zero-based player-achievement stat index.

    AchievementStatThreshold

    The threshold value at a zero-based player-achievement stat index.

    AchievementStatPercent

    The current percentage for one stat threshold, clamped from 0 to 100.

    AchievementDefinitionCount

    The number of cached achievement definitions.

    AchievementDefinitionIdAt

    The achievement ID at a zero-based cached definition index.

    AchievementUnlockedDisplayName

    The localized unlocked display name for an achievement definition.

    AchievementUnlockedDescription

    The localized unlocked description for an achievement definition.

    AchievementLockedDisplayName

    The localized locked display name for an achievement definition.

    AchievementLockedDescription

    The localized locked description for an achievement definition.

    AchievementFlavorText

    The localized flavor text for an achievement definition.

    AchievementUnlockedIconURL

    The URL of the unlocked achievement icon.

    AchievementLockedIconURL

    The URL of the locked achievement icon.

    AchievementIsHidden

    1 when the achievement definition is hidden, otherwise 0.

    AchievementThresholdCount

    The number of configured stat thresholds for the achievement.

    AchievementThresholdStatName

    The linked stat name at a zero-based achievement threshold index.

    AchievementThresholdValue

    The required value at a zero-based achievement threshold index.

Stats

  • Actions

    Query stats {0} from {1} to {2}

    Query and cache comma-separated stat names for the local player. Leave names blank for all stats. Use -1 for an unbounded start or end Unix timestamp.

    Ingest {1} into stat {0}

    Submit a stat value/amount to EOS. Its effect depends on the stat's configured aggregate type (SUM, LATEST, MIN or MAX).

    Ingest stats {0}

    Submit up to 64 stats in NAME=AMOUNT comma-separated format, for example KILLS=1,SCORE=250.

  • Conditions

    Has stat {0}

    True when the specified EOS stat is in the local cache. Query stats first.

    Stats cache is ready

    True after Query stats has completed successfully for the current Product User.

    On query stats success

    Triggered after EOS returns and caches the requested local-player stats.

    On query stats error

    Triggered if EOS cannot query the requested stats.

    On ingest stat {0} success

    Triggered when EOS accepts the specified stat ingest request. The backend interprets the value according to the stat's configured aggregate type.

    On ingest stat {0} error

    Triggered when EOS rejects the specified stat ingest request.

    On ingest multiple stats success

    Triggered when EOS accepts the batched stat ingest request.

    On ingest multiple stats error

    Triggered when the batched stat ingest request is invalid or rejected.

  • Expressions

    TriggerStatName

    The stat name associated with the current trigger.

    TriggerAmount

    The stat amount associated with the current trigger.

    StatCount

    The number of cached stats.

    StatNameAt

    The stat name at a zero-based cached index.

    StatValue

    The cached value of the specified stat.

    StatValueAt

    The stat value at a zero-based cached index.

    StatStartTime

    The cached stat period start as a Unix timestamp, or -1 when undefined.

    StatEndTime

    The cached stat period end as a Unix timestamp, or -1 when undefined.