SDL3 2D Simulation Engine - Hammer Engine

🧱 SDL3 HammerEngine Template: A High-Performance, Safe C++ Foundation

The SDL3_HammerEngine_Template is a lightweight yet powerful starting point for C++ developers using SDL3. It’s designed not as a full engine, but as a robust framework, featuring multithreading, automatic asset loading, memory safety, and performance-first design.

🚀 Core Highlights

🔹 Multithreading & WorkerBudget Scheduling
A modern thread pool with smart worker allocation and priority-based scheduling ensures smooth performance under load. Thanks to WorkerBudget and prioritized queues, critical game logic and AI tasks don’t block rendering or input handling.

🔹 Memory Safety & Smart Pointers
No raw pointers or manual allocation. The engine uses RAII and smart pointers throughout to eliminate undefined behavior and facilitate safe, leak-free code.

🔹 Automatic Asset Loading
Textures, fonts, audio, and music are auto-detected in resource folders and ready to use—even without manual registration.

🔹 Modular Scene & Entity State Machines
Includes both a global game-state manager (for menus, gameplay, pause screens) and per-entity state machines (e.g. idle/running) for flexible behavior control.

🔹 Efficient Rendering & UI Management
An immediate-mode draw interface plus full-featured UIManager supports text, panels, animations, and dynamic layouts—complete with stress testing for complex interfaces.

🔹 Performance-Centric Systems

• ParticleManager: Currently handles 20K + particles at 60+ FPS.

• AIManager: Efficiently runs 20K+ entities with dynamic behavior switching, caching, and threaded updates.

• EventManager: A fast, type-indexed event system optimized for batching and multithreaded dispatch.

🔹 Robust Testing & CI Integration
Comprehensive automated tests include unit tests, AI benchmarks, UI stress tests, thread-system validation, static analysis with cppcheck, verified memory performance with Valgrind.

🎯 Who Is This For?

Ideal for developers who want:

• A transparent, control-driven codebase

• Solid, scalable performance foundations

• High assurance in memory correctness and thread safety

• A clean framework to build gameplay, physics, or tools
  

https://github.com/Ronin15/SDL3_HammerEngine_Template