PixelDot2D Core Framework

PixelDot2D Core Framework

A No-Magic, Performance-First, Architecturally Structured 2D Foundation

Explicit Control. Decoupled Logic. Contract-Safe Architecture.

Important Notice: PixelDot2D is a code-first framework designed explicitly for intermediate to advanced developers. This is a highly optimized engineering toolset, not a plug-and-play visual template. There is no automated editor magic under the hood.

What Is PixelDot2D:

Traditional Unity frameworks and templates lock you into rigid hierarchies and hardcoded inheritance. Want to add a "Hover State" mid-game, or dynamically transition from a melee swing to a laser weapon? You are usually forced to instantiate new prefabs, messily attach MonoBehaviour components at runtime, or maintain hyper-specific, bloated controllers.

PixelDot2D is designed to be your foundation without getting in your way or forcing rigid prefab structures or inheritance loops. Get total freedom with thin interface calls and plain C# classes driven entirely by you - no hidden magic.

PixelDot2D completely eliminates this architectural overhead:

By decoupling logic from the Unity hierarchy, your GameObjects become clean canvases. The system relies on a high-performance orchestration layer driven by lightweight interfaces and plain C# classes. To expand your game, you simply feed the orchestrator ScriptableObject Blueprints on the fly.

• Infinite Extensibility without Refactoring: You don't need to know what features you will add six months from now. Orchestrators are completely open-ended. You can introduce entirely new gameplay states, passives, abilities, or weapons from the outside without touching a single line of core framework code, or by utilizing a simple registry pattern via a new enum entry.

• Instant Feature Mutations: Start a character with a basic Idle/Walk blueprint. At runtime, pass a ScriptableObject through a simple method call to instantly grant them a Dash, Glide, or Hover state, update their stats, or alter their passives. You can even switch physics archetypes from Side-Scroller to Top-Down instantly, with zero AddComponent calls or instantiation spikes.

• Unified Combat Execution: Combat follows the exact same architectural rules. One combat orchestrator processes whatever ScriptableObject data you feed it. A single unified system cleanly handles hitboxes, raycast lasers, custom projectiles, and any other 2D combat need.

• Cross-Genre Flexibility: Because the framework drives raw Rigidbody2D calculations through decoupled interfaces, your entities are entirely genre-agnostic. Use the same orchestration engine for platformers, top-down shooters, side-scrollers, or space sims.

ScriptableObjects as Virtual Prefabs

You construct your gameplay logic visually using ScriptableObjects as "Virtual Prefabs" - composing entirely new entity behaviors and weapon variations right inside the Inspector, while your hierarchy remains pristine and your CPU overhead stays near zero.

PixelDot2D documentation comes with a .pdf file, but extensive documentation lives inside the IDE. Every source file is meticulously documented with production-grade XML comments detailing not just the implementation, but the design philosophies, architectural trade-offs, and step-by-step expansion guides - complete with explicit <see cref="..." /> cross-references to guide your development flow instantly.

Production-Ready Out of the Box:

While highly engineered for code architecture, PixelDot2D is not a blank canvas. Every sub-library and sub system ships with a comprehensive suite of pre-configured ScriptableObject assets designed for immediate deployment. Due to the data-driven nature of the systems, these ScriptableObjects are entirely decoupled and not hardcoded to any specific character, player, or AI entity. All systems merely require a single, thin interface to be migrated seamlessly into your own custom logic or existing project pipelines.

This includes an expansive arsenal of pre-built weapons within the Combat Engine and fully mapped platformer and top-down character blueprints within the Modular Character framework. These configurations serve as rapid integration baselines that are easily expanded or overridden with your own custom runtime logic. The library is continuously growing, ensuring the architectural foundation scales with new foundational modules.

Requirements

PixelDot2D is designed to be evergreen, relying purely on C# and Unity’s built-in systems. It imposes no external dependencies or UI frameworks; only Unity’s New Input System is required. Although fully decoupled, it integrates seamlessly with standard Unity components. Unity version requirement: Unity 6.5+ compatible.

List of Features

https://github.com/PixelDot2D/PixelDot2D-Core-Framework-Feature-List

Code Quality Preview

https://gist.github.com/PixelDot2D/c89bbeb4a152f954f291fc2ad8ad072b

Patch Notes History

https://github.com/PixelDot2D/PixelDot2D-Core-Framework-Patch-Notes-History

Support

For any support, questions, or suggestions, please contact us via email at: PixelDot2D@gmail.com