Overview

WCGASAbilityBook is a Data Asset that defines collections of Ability Pages with UI configuration for the Wonderscape Creations GAS Ally plugin. It represents a complete "spellbook" or ability catalog for a specific purpose. Designers can organize abilities into themed books without writing any C++ code, making ability library management a fully designer-driven workflow. Each book is reusable and can be organized by user type (e.g., "PlayerAbilityBook", "MonsterAbilityBook"), game mode (e.g., "PvEAbilityBook", "PvPAbilityBook"), or content release (e.g., "BaseGameAbilityBook", "Expansion1AbilityBook").

Creating an Ability Book Data Asset

Using the Wonderscape GAS Ally Menu

1. Open the Content Browser
2. Right-click in any folder where you want to create the asset
3. Navigate to: Wonderscape GAS Ally > Ability Library > Ability Book
4. Give your new asset a descriptive name (e.g., DA_AbilityBook_Player, DA_AbilityBook_Monster, DA_AbilityBook_Boss)
5. Double-click the asset to open it and configure its properties

How Ability Books Work

Registration Flow

1. Book Creation
   • Create Ability Book assets via the Content Browser context menu
   • Each book contains soft references to multiple Ability Page assets
   • Pages can be shared between books (pages are not exclusive to one book)
2. Project Registration
   • Add Ability Book assets to Project Settings → Plugins → WC GAS Ally → Ability Library → Ability Book Assets
   • Multiple books can be registered simultaneously
   • The system validates all registered books on startup
3. Runtime Initialization
   • When the game starts:
     • UWCGASAbilityLibrarySub (Game Instance Subsystem) initializes
     • Subsystem loads all registered Ability Books from settings
     • Pages are loaded on-demand (lazy loading via soft references)
     • Ability lookup cache is built for fast queries
     • OnLibraryLoaded event broadcasts when initialization completes
4. Query Handling
   • Book Queries: Find books by tag, filter by category tags
   • Page Queries: Access pages within a book, filter by character restrictions
   • Ability Queries: Search across all pages in a book, filter by category/tier/school
   • Character Filtering: Get abilities accessible to specific actors based on tags

Configuration Properties

Identity