GameObjectSpawnSystem.ixx File

System for processing spawn schedules and enqueuing spawn commands. More...

Included Headers

#include <cassert> #include <memory> #include <vector> #include <helios.engine.runtime.spawn.events.SpawnPlanCommandExecutedEvent> #include <helios.engine.runtime.spawn.scheduling.SpawnScheduler> #include <helios.engine.runtime.spawn.SpawnManager> #include <helios.engine.runtime.spawn.commands.ScheduledSpawnPlanCommand> #include <helios.engine.runtime.world.GameWorld> #include <helios.engine.runtime.world.UpdateContext> #include <helios.engine.common.tags.SystemRole> #include <helios.engine.runtime.messaging.command.EngineCommandBuffer> #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	spawn
	Entity spawning and lifecycle management. More...
namespace	systems
	Systems for spawn lifecycle management. More...

Classes Index

class	GameObjectSpawnSystem

Description

System for processing spawn schedules and enqueuing spawn commands.

File Listing

The file content with the documentation metadata removed is:

1/**

2 * @file GameObjectSpawnSystem.ixx

3 * @brief System for processing spawn schedules and enqueuing spawn commands.

4 */

5module;

6

7#include <cassert>

8#include <memory>

9#include <vector>

10

11export module helios.engine.mechanics.spawn.systems.GameObjectSpawnSystem;

12

13

14

15import helios.engine.state.Bindings;

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

17

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

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

20import helios.engine.runtime.spawn.commands.ScheduledSpawnPlanCommand;

21import helios.engine.runtime.spawn.SpawnManager;

22import helios.engine.runtime.spawn.scheduling.SpawnScheduler;

23import helios.engine.runtime.spawn.events.SpawnPlanCommandExecutedEvent;

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

25

26

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

28export namespace helios::engine::mechanics::spawn::systems {

29

30

31 class GameObjectSpawnSystem {

32

33

34 helios::engine::runtime::spawn::SpawnManager& spawnManager_;

35

36 GameWorld* gameWorld_ = nullptr;

37

38 public:

39

40

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

42

43 explicit GameObjectSpawnSystem(helios::engine::runtime::spawn::SpawnManager& spawnManager) noexcept

44 : spawnManager_{spawnManager} {}

45

46

47 void init(GameWorld& gameWorld) noexcept {

48 gameWorld_ = &gameWorld;

49 }

50

51 /**

52 * @brief Processes spawn scheduling and enqueues spawn commands.

53 *

54 * @details Iterates through all schedulers and performs these steps for each:

55 * 1 Reads `SpawnPlanCommandExecutedEvent` from frame event bus

56 * 2 Commits completed spawns to the scheduler (for tracking/cooldowns)

57 * 3 Evaluates all spawn rules against current conditions

58 * 4 Drains ready spawn plans and enqueues them as commands

59 *

60 * @param updateContext The current frame's update context.

61 */

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

63

64 const auto& events = updateContext.readFrame<

65 helios::engine::runtime::spawn::events::SpawnPlanCommandExecutedEvent

66 >();

67

68 for (const auto& spawnScheduler : spawnManager_.spawnSchedulers()) {

69

70 /**

71 * @todo this should be processed before iterating over all schedulers: A scheduler owns the rule,

72 * hence a rule that triggered the event's can be associated with the owning Scheduler, making it

73 * unneccesary to iterate over already processed events

74 */

75 for (const auto& event : events) {

76 spawnScheduler->commit(event.spawnRuleId, event.spawnCount);

77 }

78

79 spawnScheduler->evaluate(*gameWorld_, updateContext);

80

81 auto scheduledPlans = spawnScheduler->drainScheduledPlans();

82

83 for (auto& plan : scheduledPlans) {

84 updateContext.queueCommand<

85 helios::engine::runtime::spawn::commands::ScheduledSpawnPlanCommand

86 >(

87 plan.spawnProfileId, plan.spawnPlan, plan.spawnContext

88 );

89 }

90 }

91

92 }

93

94 };

95

96}

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.15.0.