Module progress

Native functions for the conditional_progress category — quest progress behaviors (QuestTemplate::progress_behavior). Output is the new i64 progress value assigned to QuestInstance::current.

Quest progress collapses to ~12 patterns; per-quest constants (level thresholds, dungeon/currency/rarity ids) are const parameters of generic fns, registered once per shipped constant. Content uuids baked into patterns are exported as consts and validated against the config at deploy time (see [super::validate]).

Structs

ConditionalProgressCtx

Inputs available to a conditional_progress native fn.

Constants

COLLECT_CURRENCY

DUNGEON_1

DUNGEON_2

DUNGEON_3

LOG_IN_QUEST

RARITY_A

RARITY_B

RARITY_C

Functions

always_one

Always 1.

boss_win

EndFight the player won while the fight’s template is CampaignBossFight and the fight is NOT a dungeon run → +1; everything else unchanged. Dungeon bosses ride the same template type, but the quest is “Defeat a Campaign Boss” (BAL-035) and dungeon bosses grant no Mastery, so they must not tick it either. Quest dispatch runs while the fight is still present (the same contract raid_dungeon’s in-fight branch relies on).

complete_daily_quest

complete_loop_task_quest

complete_weekly_quest

count_equipped_at_rarity

On PlayerEquipItem: the number of equipped inventory items whose rarity q is at least the target rarity R’s q; other events leave progress unchanged.

current_chapter_level

character.current_chapter_level (raw, monotonic). Paired with a quest whose progress_target is the TARGET chapter, so the quest completes exactly when the player reaches that chapter — one behavior gates ANY chapter without a per-threshold const registration (active_quest.current = progress, so is_completed is current_chapter >= progress_target). Used by the progress-pass (trophy road) tiers, which span the whole game (chapter-level 20→115; the pass button itself unlocks at chapter-level 20 per gatings.progress_pass_button_unlock_chapter).

increment_by_batch_size

quest.current + event.batch_size.

increment_one

quest.current + 1. Kill quests (subscribed to EntityDeath) skip ally deaths (§3).

log_in_today

+1 when the event references the log-in daily quest.

loop_task_boss_win

Loop-task-guarded boss win (CompleteAllLoopTasks force-completes to N).

loop_task_collect_currency

CompleteAllLoopTasks → 100; other custom events → unchanged; otherwise quest.current + amount of the target currency in the event’s currency list, or 0 when the currency isn’t present (preserved from the shipped behavior — note: 0, not quest.current).

loop_task_increment_batch

Loop-task-aware +batch_size with completion value N.

loop_task_increment_one

Loop-task-aware +1: CompleteAllLoopTasks → N (the completion target), other custom events → unchanged, else +1.

loop_task_pvp_win

Loop-task-guarded PvP win. A CompleteAllLoopTasks custom event force- completes; otherwise the same player-won-PvP gate as pvp_win.

loop_task_raid_dungeon

Loop-task-guarded dungeon raid.

loop_task_reach_chapter_level

Loop-task-guarded reach-chapter-level.

loop_task_reach_level

Loop-task-guarded reach-level: CompleteAllLoopTasks → 1, other custom events → unchanged, else event.level >= T ? 1 : 0.

pvp_revenge

«Реванш»: проиграй бой на арене, затем выиграй. Использовать с progress_target: 2.

pvp_win

EndFight that the player won in a PvP fight → +1, else unchanged. The is_win gate is what distinguishes a “Win in the Arena” objective from mere participation — without it a loss would (wrongly) count as a win.

pvp_win_streak

Consecutive arena wins («выиграй N подряд»): win → +1, loss → reset to 0.

quest_current_0_then_1_else_2

current 0 → 1, otherwise 2.

quest_event_level_1_then_2

level 1 → 1, level 2 → 2, otherwise 0.

raid_dungeon

+1 on a RaidDungeon event for dungeon D, or while the active fight is in dungeon D; otherwise unchanged.

raid_dungeon_any

+1 on any RaidDungeon regardless of type («пройди N рейдов данжей»). One raid ACTION = +1 (a multi-sweep still counts once — the same semantics as raid_dungeon).

raid_dungeon_difficulty_at_least

+1 on a RaidDungeon with difficulty >= N (any dungeon type) — «пройди данж на сложности N+», полосные варианты.

reach_chapter_level

character.current_chapter_level >= T ? 1 : 0 (no guard).

reach_level

event.level >= T ? 1 : 0 (no loop-task guard).

register

Register this category’s native fns into the registry.

upgraded_abilities_delta

quest.current + Σ (final - current) over event.upgraded_abilities.

Type Aliases

ConditionalProgressFn

Signature of a conditional_progress native fn. Captureless fn so it is Copy and storable in the registry; context arrives via ConditionalProgressCtx.