FollowAgendaItem class | actor.t[7484]

An AgendaItem that can be used to trigger actor travel when the actor is waiting for the player character to follow him/her/it.

`class FollowAgendaItem : AgendaItem`

Superclass Tree (in declaration order)

`FollowAgendaItem`
`AgendaItem`
`object`

Subclass Tree

(none)

Global Objects

(none)

Summary of Properties

`agendaOrder connectorList nextConnector nextConnNum nextDirection travelBlockReported traveledThisTurn`

Inherited from `AgendaItem` :
`calledBy endCondition executeOnce initiallyActive invokedByActor isDone isReady name`

Summary of Methods

`arrivingDesc beforeTravel cancel execute invokeItem noteArrival registerItem resetItem sayDeparting showSpecialDesc specialDesc travelBlocked`

Inherited from `AgendaItem` :
`actorSay getActor initiateConversation invokeItemBase report`

Properties

`agendaOrder` OVERRIDDEN | `actor.t[7736]`

Give this agendaItem a high priority to make sure it is used in response to a FOLLOW ccmmand in preference to any other AgendaItems that may be pending.

`connectorList` | `actor.t[7596]`

A list of TravelConnectors through which we want the player character to follow our associated actor.

`nextConnector` | `actor.t[7599]`

The next connector our NPC wants to lead the PC via

`nextConnNum` | `actor.t[7589]`

A pointer to the next connector to use

`nextDirection` | `actor.t[7670]`

Display our default message. We make use there is a nextDirection before we attempt to use it in our message, otherwise we simply use a bland "X is here."

`travelBlockReported` | `actor.t[7620]`

Flag: did the travelBlocked() method output any text? This is handled internally by the library and shouldn't normally be used by game author code.

`traveledThisTurn` | `actor.t[7586]`

Which turn did this FollowAgendaItem last cause our NPC to travel on?

Methods

`arrivingDesc ( )` | `actor.t[7678]`

The specialDesc to use when our NPC has just traveled as a result of this TravelAgendaItem. By default we just show our specialDesc, but game code might want to customize this to something like "Bob crosses the room and waits for you to follow him through the green door."

`beforeTravel (traveler, connector)` | `actor.t[7712]`

Give this AgendaItem the opportunity to react to travel; in particular this might be used to allow the NPC to react to or even forbid travel in a direction other than the one s/he's trying to lead the PC.

`cancel ( )` | `actor.t[7715]`

Cancel this FollowAgendaItem before its normal termination.

`execute ( )` | `actor.t[7751]`

An AgendaItem initializer. For each agenda item that's initially active, we'll add the item to its actor's agenda.

`invokeItem ( )`OVERRIDDEN | `actor.t[7486]`

no description available

`noteArrival ( )` | `actor.t[7628]`

This method is invoked when our NPC arrives at his/her destination. By default we do nothing, but instances can override to provide code to handle the arrival, e.g. by changing the NPC's ActorState.

`registerItem ( )`OVERRIDDEN | `actor.t[7738]`

no description available

`resetItem ( )`OVERRIDDEN | `actor.t[7630]`

no description available

`sayDeparting (conn)` | `actor.t[7697]`

Display a message to say that our actor is leaving via conn. This would normally describe the player character following our actor via conn.

`showSpecialDesc ( )` | `actor.t[7685]`

Show a specialDesc for this NPC when this TravelAgendaItem is active. If we've just moved this turn we display the arrivingDesc(), otherwise we show the specialDesc.

`specialDesc ( )` | `actor.t[7646]`

The specialDesc to display when our actor is waiting for the PC to follow it. By default we just show a plain vanilla message to the effect, "The NPC is waiting for you to follow him/her north" or whatever, but game code may wish to override this to provide a more customized message.

`travelBlocked (conn)` | `actor.t[7611]`

This method is called when our NPC attempts to travel via conn but the travel is blocked (by a locked door, for example). By default we do nothing here but game code can override this method to display an appropriate message or take any other action that might be needed in this situation.

If this method displays anything, the default "You wait in vain for the traveler to go anywhere" message will be suppressed.

Adv3Lite Library Reference Manual
Generated on 13/06/2025 from adv3Lite version 2.2.1