/game-testing-framework

allowed-tools: Read, Write, Edit, Bash
argument-hint: [test-type] | --unit | --integration | --performance | --automation | --comprehensive
description: Use PROACTIVELY to implement comprehensive game testing frameworks with automated validation, performance testing, and multi-platform verification

Game Testing Framework & Automation

Implement comprehensive game testing framework: $ARGUMENTS

Current Testing Context

• Game engine: @package.json or detect Unity/Unreal/Godot project files
• Existing tests: !`find . -name "*test*" -o -name "*Test*" | head -10`
• CI/CD setup: @.github/workflows/ or @.gitlab-ci.yml or @Jenkinsfile (if exists)
• Build configs: !`find . -name "*.sln" -o -name "*.csproj" -o -name "build.gradle" | head -3`
• Platform targets: !`grep -r "BuildTarget\|Platform\|Target" . 2>/dev/null | wc -l` target configurations

Task

Create a comprehensive testing framework for game development with automated validation, performance benchmarks, cross-platform testing, and continuous integration.

Testing Framework Components

1. Unit Testing Infrastructure

• Core game logic and mechanics testing
• Component-based testing for modular systems
• Mock and stub systems for external dependencies
• Data validation and serialization testing
• Mathematical calculations and algorithm verification

2. Integration Testing Suite

• Scene loading and transition testing
• Asset loading and management validation
• Save/load system integrity testing
• Networking and multiplayer functionality
• Platform-specific feature integration testing

3. Performance & Benchmarking

• Frame rate stability testing across scenarios
• Memory usage profiling and leak detection
• Loading time benchmarks for different content
• Stress testing with high entity counts
• Platform-specific performance validation

4. Automated Gameplay Testing

• AI behavior validation and regression testing
• User input simulation and response verification
• Game state progression and checkpoint validation
• Balance testing for game mechanics
• Procedural content generation validation

Testing Categories

Functional Testing

• Core gameplay mechanics validation
• User interface responsiveness and functionality
• Audio system integration and spatial audio
• Physics simulation accuracy and stability
• Animation system timing and blending

Compatibility Testing

• Multi-platform build verification
• Device-specific feature testing (mobile, console, VR)
• Different screen resolutions and aspect ratios
• Hardware capability scaling and adaptation
• Operating system compatibility validation

Regression Testing

• Automated testing for code changes impact
• Asset modification impact on game performance
• Save file compatibility across versions
• Feature functionality preservation
• Performance regression detection

User Experience Testing

• Accessibility features validation
• Control scheme testing across input devices
• Localization and internationalization testing
• Tutorial and onboarding flow validation
• Error handling and recovery testing

Deliverables

1. **Testing Framework Setup**

• Test runner configuration and automation
• Mock systems and test data generation
• Continuous integration pipeline integration
• Test reporting and metrics collection

2. **Test Suite Implementation**

• Unit tests for core game systems
• Integration tests for complex interactions
• Performance benchmarks and monitoring
• Automated gameplay validation scripts

3. **Platform Testing Strategy**

• Device-specific test configurations
• Cloud testing and device farm integration
• Performance validation across target platforms
• Compatibility testing automation

4. **Monitoring & Reporting**

• Test results dashboard and visualization
• Performance regression tracking
• Code coverage analysis and reporting
• Automated test failure investigation

Implementation Guidelines

Integrate with game engine testing tools and establish CI/CD pipelines for automated testing. Ensure scalable test architecture that grows with project complexity and team size.