Zagala Game Solutions - ZagalaSpec (ATDD - Executable Specifications)

Turn the things you agreed on into things you can run.


Every project has them
  • The meeting that ends with nods and no deliverable

  • The department that ships a feature nobody else knew about

  • The bug that was fixed in March and is back in June

  • That AI prompt that screwed up the codebase

  • Stale documentation

  • The question "is that feature actually done?" answered with a shrug

ZagalaSpec is simple living documentation that Unreal can verify

The team writes what the feature should do, then they connect those sentences to real implementation once.

From then on, every sentence is a test that passes or fails in the feature itself, the Session Frontend or on your build machine.

Everyone is involved. Everyone knows what's in there and whether or not a change breaks it.

It has opinions, not handcuffs. Keep it simple and put everything in one Blueprint step, or use the full 'test-case → domain language → protocol driver → system' layering when a feature or business language grows.

Steps are reusable, so new scenarios usually mean new sentences, not new code.

A specification is not a contract carved in stone: scenarios are independent, negotiable, valuable, estimable, small and testable (INVEST), so changing your mind means editing a sentence and running it again.

Utilize ZagalaSpec to create a safety net for your project by continuously verifying the intended behavior of features and catching regressions early.

Write it down once. Check its status at all times.

Ships with 6 worked examples (Blueprint-only, in-memory C++, physics world, multi-actor, multiplayer in the editor), and runs through the standard Unreal Automation Framework, headless included.


Features at a Glance

  • Executable specifications for Unreal Engine projects.

  • Supports Blueprint-only and C++ projects.

  • Allows to write in simple, human-readable sentences that describe feature behavior. Then connect those sentences to real implementation.

  • Supports both single-step Blueprint scenarios and multi-layered architecture for complex features.

  • Works with physics worlds and multi-actor scenarios.

  • Examples included inside plugin for easier learning and reference.

  • Integrates with the Unreal Automation Framework, including headless runs.

  • Support for regex patterns in step definitions, including capture groups to later inject dynamic values.

  • Import/Export support for all major formats from/to plain text (partial support; some format features may not be fully supported.)

  • Loose 4-layer architecture: test-case → domain language → protocol driver → system, or all-in-one for convenience.

  • Optional communication layer between steps for better coordination and data sharing.

  • Asynchronous execution of steps by default.

  • Interface-based architecture to allow flexible implementation and extension of features.

  • Full source code available for inspection and modification.


Notes
  1. This plugin requires the GameplayTagsEditor plugin to be enabled.

  2. AI was used to help generate this plugin, always under supervision and review of the development team.

  3. Support is best effort support only, available through the ZagalaSpec Discord, Documentation and support@zagalagamesolutions.com.

  4. Support is available from Monday to Thursday, 09:00–13:00 ET, 06:00–10:00 PT, 15:00–19:00 CET.