Invincible: Xeno Swarm - Unity 3D Air Combat AI Framework

Invincible: Xeno Swarm is a professional Unity framework designed specifically for 3D vertical action games, inspired by the superhero-themed work "Invincible". The framework provides comprehensive flight combat, advanced spatial AI, and procedural sandbox generation features, suitable for developing superhero, sci-fi air combat, and survival game genres. Its core design philosophy is to integrate complex 3D spatial navigation, agent behavior, and dynamic environment generation into a plug-and-play component system, helping developers focus on realizing game ideas rather than low-level technical details.

Basic Project Information

• Original Author/Maintainer: StephenSouth13
• Source Platform: GitHub
• Original Link: https://github.com/StephenSouth13/shadow-sense-ai-framework
• Version: 1.0.0
• Unity Compatibility: Unity 6.0.x and above

Design Philosophy

The framework aims to build a complete ecosystem that supports the performance and modular architecture required for commercial releases. Its core goal is to lower the technical barriers of 3D spatial AI and dynamic environment generation, allowing developers to quickly realize their game ideas.

Ground AI System: RobotBrain FSM

Based on Finite State Machine (FSM), integrated with NavMesh navigation grid, supporting three core states: patrol, chase, and investigate. It bridges with Animator controller to achieve smooth transition animations.

3D Spatial Pathfinding

Custom non-NavMesh pathfinding solution, using A* path planning and floating waypoint network to achieve intelligent navigation in open airspace.

Flight Physics Engine: SteeringAgent

Provides functions such as whisker obstacle avoidance, group separation behavior, Perlin noise roaming, etc., to achieve organic air movement effects.

Advanced Flight Controller: ViltrumiteFlightController

Integrates global A* navigation and local steering behavior to achieve efficient pursuit of players.

Combat System

• PlayerCombatController: 3D flight controller based on the new input system, supporting omnidirectional movement and sprinting.
• IDamageable Interface: Decouples the combat architecture, allowing players and AI to interact without knowing each other's types.

Procedural Tool: SectorSandboxGenerator

One-click generation of a 200x200 arena, including procedural buildings, automatic NavMesh baking, waypoint network establishment, and dynamic entity generation, accelerating prototype design and level iteration.

Quick Start Guide

1. Scene Generation: Open the Sector_Zero_Arena scene → Click "Generate Sector" in SectorSandboxGenerator → Bake NavMesh.
2. Audio Configuration: Set background music and sound effects via the AudioManager in the [SYSTEM_PERSISTENT] prefab.
3. Build Settings: Add MainMenu_Scene and Gameplay_Scene to Build Settings; MainMenuController will load the combat scene asynchronously.

1. Decoupled Architecture: The IDamageable interface follows the dependency inversion principle, improving system scalability and maintainability.
2. Performance Optimization: Uses Physics.OverlapSphere and optimized raycasting to support high frame rates with multiple agents.
3. Coding Standards: Follows PascalCase naming conventions, includes detailed comments, and uses [SerializeField] and [Header] attributes to optimize the Inspector experience.
4. Cross-Platform Support: Fully integrated with Unity's new input system, compatible with modern controllers and keyboard/mouse operations.

Application Scenarios

• Superhero genre: High-speed flight, urban traversal, large-scale battles.
• Sci-fi air combat: Dogfights, formation flight, mothership attack/defense.
• Survival genre: Zombie hordes, insect swarm invasions, and other multi-enemy scenarios.

Future Expansion

• Online multiplayer synchronization.
• More complex group behavior patterns.
• Dynamic difficulty adjustment system.
• Machine learning-based adaptive AI.

Summary

The Invincible: Xeno Swarm framework integrates pathfinding algorithms, behavior systems, physics simulation, and procedural generation. It is a complete 3D action game development solution suitable for indie developers and small teams.

Dependency Requirements

• AI Navigation Package
• TextMeshPro
• New Input System