Skip to content

Changelog

All notable changes to this package are documented here. The format follows Keep a Changelog and the package uses Semantic Versioning.

[Unreleased]

Added

  • Hierarchical gameplay tags: registry, immutable sets, reference-counted containers, queries.
  • Attributes with base and current values, Min/Max and max-attribute clamping, meta attributes.
  • Gameplay effects: instant, timed, infinite, periodic; stacking; granted tags; application and ongoing requirements; immunity; removal by tags.
  • Magnitudes: constant, scalable by level, attribute-based (live or snapshot), set-by-caller, custom.
  • Custom executions for multi-attribute formulas.
  • ArcanaWorld: timer-driven time, command queue for other threads, recursion guard.
  • Allocation-free hot paths, covered by performance tests.
  • Gameplay abilities: cost, cooldown, activation tags, blocking and cancelling by tag, instancing and reactivation policies, triggers, input binding, passives.
  • AbilityTask async waits: delay, gameplay event, tag added or removed, attribute change, input pressed or released, target data.
  • Gameplay events with payload, and gameplay cues from effects and abilities.
  • Unity integration: settings in Project Settings (preloaded, no Resources), tag and attribute databases, AbilitySystemComponent with owner/avatar, profiles, effect assets, ScriptableAbility with built-in effect, projectile and melee abilities.
  • Spreadsheet import for tags, attributes and effects: CSV files or Google Sheets links, preview with changed columns, line and column errors, orphans removed only on request, CSV export, batch-mode import for CI.
  • History: AbilitySystemHistory records effects, attribute changes with their cause, tags, abilities and events; the debugger shows it on a timeline.
  • Save and load: CaptureState and RestoreState on ability systems, JSON helpers and a Save Catalog for assets.
  • Editor: setup assistant, project validator (window and command line) and script templates for abilities, executions, magnitudes and cues.
  • GameplayEffectDefinition.Validate() reports what prevents an effect from being applied.
  • Input buffer: presses refused by a cooldown or a blocking ability are retried for InputBufferTime seconds.
  • Optional Input System integration: Ability Input Binder component and pointer, compiled only when the package is installed.
  • Animation-driven abilities: PlayAnimation, WaitAnimationEvent, WaitAnimationEnd, hit windows, and WaitUntil with timeout in the core.
  • Targeting: sphere, cone, box, line and self collectors with tag, line-of-sight, count and distance filters; ground targeting with WaitGroundTarget; InputConfirm and InputCancel on ability systems.
  • ArcanaProjectile.TargetRequirement: a tag query that targets must match, for factions without physics layers.
  • Arena sample: a playable wave survival whose tags, attributes and effects come from CSV tables.
  • Gameplay cue libraries, handlers and pooled notifies; ArcanaPool; ArcanaProjectile; AnimationEventRelay.
  • Editor: tag and attribute dropdowns, type picker for magnitudes and executions, [ArcanaButton], debugger window, in-game debug overlay.
  • Recipes sample: eleven playable examples in one scene.
  • PlayMode tests for the Unity layer.