#pragma once #include #include #include #include #include #include namespace Game::State { class GameState { public: static GameState& getInstance() { static GameState instance; return instance; } // Execute work while holding the GameState mutex to keep access thread-safe. template void withEntitiesLocked(Fn&& fn) { std::scoped_lock lock(mMutex); fn(mEntities); } void sort(); // Sort entities by zIndex for correct rendering order Object::Entity* getEntityByName(const std::string& name); // Get an entity by name, returns nullptr if no entity with the name exists std::vector getEntitiesSnapshot(bool sortByZIndex = false); // Get a stable snapshot of entity pointers for iteration outside the lock // Update entity at index, by REFERENCE. Object::Entity* getAtIndex(size_t at); // Add an entity to the gamestate. void addEntity(std::unique_ptr entity); private: mutable std::mutex mMutex; // Shared mutex for thread safety std::vector> mEntities; }; }