47 lines
1.3 KiB
C++
47 lines
1.3 KiB
C++
#pragma once
|
|
|
|
#include <optional>
|
|
#include <vector>
|
|
|
|
#include <QVector2D>
|
|
|
|
#include "Tick.h"
|
|
|
|
#include "entt/entity/entity.hpp"
|
|
|
|
class EntityAdmin;
|
|
|
|
// A piece of debris and the scrap amount it still holds (REQ-RES-DEBRIS-DROP).
|
|
struct DebrisInfo
|
|
{
|
|
entt::entity entity;
|
|
QVector2D position;
|
|
int amount;
|
|
};
|
|
|
|
// Manages debris entities: the salvageable objects dropped by destroyed ships and
|
|
// defence stations (REQ-RES-DEBRIS-DROP). Each piece carries a scrap amount that
|
|
// salvage modules collect one unit at a time (REQ-SHP-SALVAGE).
|
|
class DebrisSystem
|
|
{
|
|
public:
|
|
explicit DebrisSystem(EntityAdmin& admin);
|
|
|
|
entt::entity spawn(QVector2D position, int amount, Tick despawnAt);
|
|
void tickDespawn(Tick currentTick);
|
|
|
|
// Removes the debris and returns its remaining scrap amount, or nullopt if not found.
|
|
std::optional<int> consume(entt::entity entity);
|
|
|
|
// Collects a single scrap unit from the debris: decrements its amount by one,
|
|
// destroying the entity once depleted. Returns true if a scrap was collected,
|
|
// false if the entity is invalid or already empty (REQ-SHP-SALVAGE).
|
|
bool collectOne(entt::entity entity);
|
|
|
|
// Lightweight snapshot for callers that need to iterate all debris.
|
|
std::vector<DebrisInfo> getAllDebrisInfo() const;
|
|
|
|
private:
|
|
EntityAdmin& m_admin;
|
|
};
|