View source for Ai goal actbusy queue

{{LanguageBar}}
{{CD|CAI_ActBusyQueueGoal|base=CAI_ActBusyGoal|file1=ai_behavior_actbusy.cpp}}
{{this is a|point entity|game1=Alien Swarm|name=ai_goal_actbusy_queue|game=Half-Life 2}}
[[File:Ai goal actbusy queue queue.jpg|thumb|right|250px|This entity managed the food line in {{ent|d1_trainstation_02}}.]]
It can do anything that an {{ent|ai_goal_actbusy}} can do, except this entity is designed to order [[actbusy]] hints and [[NPC]]s in a queue. The queue can be moved forward, and when the first NPC in the queue leaves, it can be given orders.

{{bug|Hint activities must not require exiting, or the queue will freeze.}}
{{bug|Source 2006: Sometimes you want to switch between busy systems that you have, but direct call of it in your busy entity with '''OnNpcFinishedBusy->ForceNPCToActBusy''' works incorrectly and new one busy system npc grabbs extra npc from your queue.}} 

You can't just use a small delay there, cause it still interrupts extra other npc from queue and npc, who finished his busy activity react immediately, causing whole queue to stuck by his movements, cause he didn't proceed to exit node, also, you can't use '''OnNpcLeft''' and '''OnNpcLeftQueue''' (it just won't work in this case).

{{tip|To avoid this you can use this workaround:}}
<source lang="cpp" style="background:initial">OnNPCFinishedBusy !activator AddOutput OnUser1 busy_relay:Trigger
OnNPCFinishedBusy !activator FireUser1 <delay:0.20></source>
In your [[logic_relay]] (busy_relay) you can set a delay to wait for npc before switching to other [[ai_goal_actbusy]] system like this:
<source lang="cpp" style="background:initial">
OnTrigger actbusy_street_new ForceNPCToActBusy !activator <delay>
</source>

{{stray ent|{{portal}} {{portal2}}}}

==Keyvalues==
{{KV Targetname}}
{{KV|Exit Node|intn=node_exit|target_destination|The name of the first node ({{ent|info_node_hint}} or {{ent|path_corner}}) the first NPC in the queue should head to when leaving the queue. Required.}}
{{KV|Node 1|to=Node 20|intn=node1|target_destination|Used for defining the path of the queue, with {{ent|info_node_hint}}s. '''Node 1''' is the front of the queue. The number of defined nodes defines the maximum number of NPCs queuing.}}
{{KV|Must Reach Front|intn=mustreachfront|choices|If true, an NPC must strictly be at '''Node 1''' before being able to leave the queue.
:*0: No
:*1: Yes}}
{{KV BaseActbusyGoal}}
{{KV GoalEntity}}

==Inputs==
{{IO|MoveQueueUp|Moves all NPCs in the queue up one position, and sends the first NPC to the '''Exit Node'''.}}
{{IO|PlayerStartedBlocking|param=float|Tell the queue manager that the player has started blocking a specified point in the queue.}}
{{IO|PlayerStoppedBlocking|param=float|Tell the queue manager that the player has stopped blocking a specified point in the queue.}}
{{I BaseActbusyGoal}}
{{I GoalEntity}}

==Outputs==
{{IO|OnQueueMoved|param=integer|Fired when the queue moves up. {{outadd|the number of NPCs remaining in the queue}}}}
{{IO|OnNPCLeftQueue|param=targetname|Fired when an NPC goes to the '''Exit Node'''. {{outadd|the targetname of the NPC}}}}
{{IO|OnNPCStartedLeavingQueue|param=targetname|Fired when an NPC is at '''Node 1'''. {{outadd|the targetname of the NPC}}}}
{{O BaseActbusyGoal}}

==See also==
*[[Actbusy Queues]] - Description of the Actbusy queue system.

[[Category:AI]]