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.
AbilityTaskasync 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,
AbilitySystemComponentwith owner/avatar, profiles, effect assets,ScriptableAbilitywith 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:
AbilitySystemHistoryrecords effects, attribute changes with their cause, tags, abilities and events; the debugger shows it on a timeline. - Save and load:
CaptureStateandRestoreStateon 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
InputBufferTimeseconds. - 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, andWaitUntilwith 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;InputConfirmandInputCancelon 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.