What is the primary purpose of the zinc-unittest skill?

It automates the creation and management of unit tests for Warcraft III maps developed using the Zinc and Jass languages within the War3Lib framework.

How are test results reported?

The skill utilizes UnitTestFramwork.assert for logic verification and the Trace log system for outputting results to developer logs rather than in-game UI.

Will test code increase my final map size?

No, the skill implements macro protection using #if (CURRENT_BUILD_VERSION != VERSION_RELEASE) to ensure test logic is excluded from production builds.

Does it support testing for map objects like units and abilities?

Yes, the workflow allows for optional .w3a (abilities), .w3u (units), and .w3i (items) files to be created alongside test scripts for object-assisted testing.

How does the skill handle library dependencies?

It uses .cfg files to maintain public API keywords and [chain] dependencies, which are recursively injected during the test generation process.

Zinc Unit Testing for War3Lib

Name: Zinc Unit Testing for War3Lib
Author: Crainax

byCrainax

•

Game Development

Standardizes and automates the unit testing workflow for Warcraft III Zinc and Jass modules within the War3Lib ecosystem.

This skill provides a comprehensive framework for creating, managing, and executing unit tests for Warcraft III map development using Zinc and Jass. It streamlines the testing process by automating the generation of test shells via Lua scripts, managing complex library dependencies through configuration files, and providing a standardized assertion and logging system. It is specifically designed for developers working with War3Lib who need to ensure the reliability of their game logic through reproducible, macro-protected testing suites that include support for map objects like units, abilities, and items.

Key Features

01Dependency injection management through specialized .cfg file configurations.

02Macro protection system to prevent test code from leaking into production releases.

03Automated test shell generation using TaskCreateUT.lua and Jass templates.

048 GitHub stars

05Integrated support for map object testing with .w3a, .w3u, and .w3i files.

06Standardized assertion framework utilizing UnitTestFramwork for various data types.

Use Cases

01Refactoring legacy map logic with safety assertions and reproducible test shells.

02Building automated regression suites for complex Warcraft III Jass libraries.

03Debugging interactive game systems using automated timers and trace logs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add crainax/war3lib zinc-unittest

For use in Claude.ai and ChatGPT

Download Skill