AbilityBookAssets

TArray<TSoftObjectPtr<UWCGASAbilityBook>>

What it is:

Array of Ability Book data assets that are loaded at game start and form the global Ability Library.

Systems that access it:

• UWCGASAbilityLibrarySub
  • LoadBooksFromSettings() calls GetDefault<UWCGASAllySettings>() and reads AbilityBookAssets
  • Synchronously loads each UWCGASAbilityBook and fills:
    • LoadedBooks
    • AbilityLookupCache (built in BuildAbilityLookupCache())
• Ability query helpers
  • Anything using UWCGASAbilityLibrarySub (directly or via UWCGASAbilityLibFuncLib) ultimately queries only books loaded from this array:
    • GetAllBooks(), FindBookByTag()
    • GetAllPages(), FindPageByTag(), GetPagesForActor(), etc.
    • GetAllAbilities(), FindAbilityByTag(), GetAbilitiesByCategory(), etc.
• Startup validation/logging
  • UWCGASAbilityLibrarySub::LoadBooksFromSettings():
    • Logs missing settings
    • Warns on duplicate BookIdentifier tags
    • Warns on missing BookIdentifier on a book
    • Logs how many books / abilities were loaded

Why it matters:

This is the source-of-truth list of ability books that the Ability Library subsystem knows about. Only books referenced here are:

• Loaded into memory on startup
• Included in global page/ability lookups
• Available to systems that resolve abilities via tags (e.g., Curriculum, debug commands, any UI built on top of the library)

If a book is not in AbilityBookAssets, its pages and abilities are effectively invisible to the library and to any tag-based queries.

If left empty:

• UWCGASAbilityLibrarySub::LoadBooksFromSettings() logs:
  • [AbilityLibrary] No ability books configured in settings.
• LoadedBooks stays empty and AbilityLookupCache has no entries:
  • All global queries (books/pages/abilities) return empty results
  • Systems that rely on the Ability Library for resolving ability tags (e.g., curricula, debug utilities, and any blueprint calls via UWCGASAbilityLibFuncLib) will not find anything
• There is no hard error, but the Ability Library subsystem is effectively disabled because it has no data to operate on.