GameObjectLifecycleSystem.ixx File

System that processes health depletion events and triggers despawning. More...

Included Headers

#include <vector> #include <cassert> #include <helios.engine.mechanics.match.events> #include <helios.engine.mechanics.spawn.components.SpawnedByProfileComponent> #include <helios.engine.mechanics.health.types> #include <helios.engine.mechanics.match.components> #include <helios.engine.mechanics.health.events> #include <helios.engine.runtime.spawn> #include <helios.engine.runtime.world.UpdateContext> #include <helios.engine.mechanics.health> #include <helios.engine.runtime.world.GameWorld> #include <helios.engine.runtime.world.Manager> #include <helios.engine.runtime.messaging.command.EngineCommandBuffer> #include <helios.engine.common.tags.SystemRole> #include <helios.engine.state.Bindings>

Namespaces Index

namespace	helios
namespace	engine
	Main engine module aggregating core infrastructure and game systems. More...
namespace	mechanics
	High-level gameplay systems and components for game logic. More...
namespace	lifecycle
	Lifecycle management for entity components and world-level operations. More...
namespace	systems
	Systems for processing entity lifecycle transitions. More...

Classes Index

class	GameObjectLifecycleSystem
	Reacts to HealthDepletedEvents and despawns or deactivates entities. More...

Description

System that processes health depletion events and triggers despawning.

File Listing

The file content with the documentation metadata removed is:

1/**

2 * @file GameObjectLifecycleSystem.ixx

3 * @brief System that processes health depletion events and triggers despawning.

4 */

5module;

6

7

8#include <vector>

9#include <cassert>

10

11export module helios.engine.mechanics.lifecycle.systems.GameObjectLifecycleSystem;

12

13import helios.engine.state.Bindings;

14import helios.engine.runtime.messaging.command.EngineCommandBuffer;

15

16

17

18import helios.engine.runtime.world.Manager;

19import helios.engine.runtime.world.GameWorld;

20import helios.engine.runtime.world.UpdateContext;

21

22import helios.engine.runtime.spawn;

23

24import helios.engine.mechanics.health.events;

25import helios.engine.mechanics.health.types;

26

27import helios.engine.mechanics.match.components;

28import helios.engine.mechanics.match.events;

29

30import helios.engine.mechanics.health;

31

32import helios.engine.mechanics.spawn.components.SpawnedByProfileComponent;

33

34using namespace helios::engine::runtime::world;

35using namespace helios::engine::runtime::messaging::command;

36

37using namespace helios::engine::mechanics::match::components;

38using namespace helios::engine::mechanics::match::events;

39using namespace helios::engine::mechanics::health::types;

40using namespace helios::engine::mechanics::health::events;

41using namespace helios::engine::mechanics::spawn::components;

42using namespace helios::engine::runtime::spawn::commands;

43

44import helios.engine.common.tags.SystemRole;

45

46export namespace helios::engine::mechanics::lifecycle::systems {

47

48 /**

49 * @brief Reacts to HealthDepletedEvents and despawns or deactivates entities.

50 *

51 * Reads HealthDepletedEvents from the phase bus. For each affected entity,

52 * the system inspects the HealthComponent's HealthDepletedBehavior flags:

53 * - If Despawn is set and the entity has a SpawnedByProfileComponent,

54 * a DespawnCommand is enqueued.

55 * - Otherwise the entity is deactivated.

56 */

57 class GameObjectLifecycleSystem {

58

59 public:

60

61 using EngineRoleTag = helios::engine::common::tags::SystemRole;

62

63 /**

64 * @brief Processes health depletion events and enqueues despawn commands.

65 *

66 * @param updateContext Current frame context.

67 */

68 void update(helios::engine::runtime::world::UpdateContext& updateContext) noexcept {

69

70 auto events = updateContext.readPass<HealthDepletedEvent>();

71

72 for (auto& event : events) {

73 auto go = updateContext.find(event.source());

74

75 if (go) {

76

77 auto* hc = go->get<helios::engine::mechanics::health::components::HealthComponent>();

78 if (hc) {

79 auto healthDepletedBehavior = hc->healthDepletedBehavior();

80 if (hasHealthDepletedFlag(healthDepletedBehavior, HealthDepletedBehavior::Despawn)) {

81 if (auto* sbp = go->get<SpawnedByProfileComponent>()) {

82 assert(sbp->spawnProfileId().value() != 0 && "Entity has no SpawnProfileId.");

83 updateContext.queueCommand<DespawnCommand>(go->entityHandle(), sbp->spawnProfileId());

84 } else {

85 go->setActive(false);

86 /**

87 * @todo remove from gameworld

88 */

89 }

90 }

91 }

92 }

93

94 }

95

96 }

97 };

98

99}

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.15.0.