Top Down Shooter ToolKit (TDS-TK)

About Top Down Shooter ToolKit (TDS-TK) – Unity Editor Tool & Plugin

Top Down Shooter ToolKit (TDS-TK) Unity Asset Overview

In my experience building action titles in Unity, crafting a responsive top-down shooter controller from scratch involves far more than simply translating vector inputs to player movement. You need to account for frame-rate-independent aiming math, camera lead distance, recoil dynamics, hitscan versus projectile trajectory physics, object pooling, and state-driven enemy AI. The Top Down Shooter ToolKit (TDS-TK) addresses these complex core mechanics directly, giving developers a structured framework to build upon immediately.

Architecturally, TDS-TK relies on a decoupled, component-based structure. Instead of cramming all player logic into a monolithic script, the toolkit splits responsibilities across specialized controllers: PlayerController handles locomotion and mouse/gamepad rotation tracking, WeaponControl manages fire rates, clip reloads, and recoil impulse, while UnitHealth standardizes damage calculations across both players and NPCs. Centralized managers like TDSGameManager and ObjectPoolManager handle scene-wide loops, wave tracking, and memory allocations without cluttering your core gameplay scripts.

Core Technical Features & Highlights

What sets TDS-TK apart is its practical approach to handling resource-intensive game loops. Rather than spawning and destroying bullets, muzzle flashes, and blood splatters dynamically—which leads to aggressive Garbage Collection (GC) spikes—the toolkit provides a built-in pooling system out of the box. Here is a breakdown of the core technical features that make this framework reliable for production pipelines:

• Flexible Weapon System: Native support for hitscan rays, physical rigid-body projectiles, direct beam/laser systems, and area-of-effect explosive launchers configured via clean inspector fields.
• Line-of-Sight & AI Perception: Integrated AIVision component using cone-check physics overlap and line-of-sight raycasts to calculate cover points, pursuit states, and sight angles efficiently.
• Dynamic Camera Control: Dedicated top-down camera system featuring screen shake, mouse-lead offsets, dynamic zoom based on speed, and configurable target tracking.
• Customizable Ability & Perk Architecture: Extensible stat modifier system allowing passive perks (e.g., increased fire rate, armor multipliers) and active abilities (e.g., dash, localized EMPs).
• Universal Render Pipeline (URP) Ready: Prefabs and visual effects ship with standard shaders that easily convert to URP Shader Graph materials without requiring complex re-lighting.

Ideal Use Cases & Game Genres

Honestly, TDS-TK shines brightest when you need to prototype rapidly without sacrificing long-term scalability. While designed for classic shooters, its underlying physics and combat handlers adapt easily to multiple top-down formats:

1. Twin-Stick Arcade Shooters

If you are building fast-paced, high-density wave shooters similar to Alien Swarm or Helldivers, the included game mode controllers handle spawning waves, win/loss triggers, and player score multipliers cleanly.

2. Isometric Tactical RPGs & Roguelikes

For titles in the style of Synthetik or Enter the Gungeon, you can easily tap into the kit's inventory hooks, ammo management arrays, and item drop structures to attach randomized loot generation algorithms.

3. Mobile Action Games

Because the controls rely on abstract input vectors rather than hardcoded hardware references, mapping virtual dual-joysticks for iOS and Android requires minimal refactoring, making it ideal for hyper-casual or mid-core mobile titles.

Quick-Start Unity Setup & Integration Guide

Integrating TDS-TK into an existing project or setting up a clean scene takes less than ten minutes if you follow these straightforward setup steps.

Step 1: Scene & Layer Configuration

First, create your collision matrix layers to ensure physics raycasts perform correctly. In your Unity project settings, create distinct layers for Player, Enemy, Obstacle, and Bullet.

Step 2: Spawning the Player Prefab

Drag the standard player prefab from TDSTK/Prefabs/Player/ into your scene hierarchy. Ensure the attached PlayerController component has its movement speeds, ground mask, and aim layer set to target your terrain or floor colliders.

Step 3: Configuring the Camera

Attach the TDSCamera script to your Main Camera. Drag your player transform into the Target field. Adjust the Distance Height, Smooth Follow Speed, and Cursor Offset Weight parameters to fine-tune visual tracking during fast gameplay.

Step 4: Custom Script Event Listening

To keep your gameplay systems decoupled, you should hook into TDS-TK's delegate events rather than modifying core scripts directly. Below is a C# snippet showing how to listen to weapon firing events to trigger custom gameplay feedback, such as haptic effects or user interface updates:

using UnityEngine;
using TDSTK;

public class CustomWeaponFeedback : MonoBehaviour
{
    [SerializeField] private WeaponControl weaponController;
    [SerializeField] private ParticleSystem extraMuzzleFlash;

    private void OnEnable()
    {
        if (weaponController != null)
        {
            // Subscribe to the shooter toolkit fire event
            weaponController.OnShootEvent += HandleWeaponFired;
        }
    }

    private void OnDisable()
    {
        if (weaponController != null)
        {
            // Unsubscribe to prevent memory leaks
            weaponController.OnShootEvent -= HandleWeaponFired;
        }
    }

    private void HandleWeaponFired()
    {
        // Custom visual or physical feedback execution
        if (extraMuzzleFlash != null)
        {
            extraMuzzleFlash.Play();
        }
    }
}

Pros & Cons Assessment

Pros

• Clean C# Codebase: Well-commented, modular scripts with minimal coupling, making custom extensions easy to implement.
• Built-in GC Optimization: Object pooling is deeply integrated into bullet, particle, and impact effect instantiation routines.
• Fast Prototyping: Included weapon types (pistols, shotguns, laser beams, grenades) work straight out of the box with sound effects and visuals configured.
• Decoupled UI & HUD: Built-in canvas prefabs automatically sync with ammo, health, and skill cooldown events without heavy configuration.

Cons

• Legacy Input System Default: Ships configured primarily for Unity's legacy Input Manager, requiring an extra wrapper or manual porting if your project strictly uses the modern UnityEngine.InputSystem package.
• UI Refactoring Needed: UI components use Unity's traditional UI Canvas system rather than UI Toolkit, which might require re-skinning for advanced interface architectures.

Frequently Asked Questions (FAQ)

Can I integrate Unity's new Input System package with TDS-TK?

Yes. Although the default scripts read directional inputs using Input.GetAxis(), the input logic inside PlayerController.cs is neatly isolated. You can easily replace those calls with your own bindings or map the InputAction callbacks directly to the movement vector fields.

Is TDS-TK performant on lower-end mobile devices?

In my experience, performance on mobile is solid, largely thanks to the pre-configured object pooling infrastructure. To optimize further on mobile platforms, ensure you reduce the maximum simultaneous active enemy count in the WaveManager and keep point-light shadows turned off in URP.

What is the licensing policy for evaluating this asset package?

Here is the key takeaway regarding usage: assets made available on this site are provided strictly for educational, testing, and architecture evaluation purposes only—never for commercial production releases. If you decide to launch a commercial game using TDS-TK, please purchase an official license directly from the Unity Asset Store to support the original author's continued development efforts.

Related Unity Tools Assets