Difference between revisions of "GetPCSpeaker"

From NWN Lexicon
Jump to: navigation, search
(Undo revision 52532 by 209.160.126.132 (talk))
 
Line 1: Line 1:
 
+
{{DISPLAYTITLE:GetPCSpeaker()}}__NOTOC__
 
 
 
 
 
 
=GetPCSpeaker()=
 
 
 
 
Retrieves the PC that is currently in a conversation with an NPC.
 
Retrieves the PC that is currently in a conversation with an NPC.
 
 
<nwscript>
 
<nwscript>
 
object GetPCSpeaker();
 
object GetPCSpeaker();
Line 13: Line 7:
 
====Description====
 
====Description====
  
Returns the PC that is speaking in the current conversation. <br /><br /> It will return OBJECT_INVALID if there is no PC speaker, for example, with SpeakOneLinerConversation().
+
Returns the PC that is speaking in the current conversation.
 +
 
 +
It will return OBJECT_INVALID if there is no PC speaker, for example, with [[SpeakOneLinerConversation]]().
  
<br /><br />
 
  
 
====Remarks====
 
====Remarks====
  
This function can only be used in scripts that are called as part of a conversation, and always returns the PC talking. <br /><br /> Of course, if it is an NPC speaking to another NPC, it will return the NPC who is the one who takes the conversation choices (NPC's always take the first one after a short delay).
+
This function can only be used in scripts that are called as part of a conversation, and always returns the PC talking.
 +
 
 +
Of course, if it is an NPC speaking to another NPC, it will return the NPC who is the one who takes the conversation choices (NPC's always take the first one after a short delay).
  
<br />
 
  
 
====Version====
 
====Version====
Line 55: Line 51:
 
| width="1px" align="right" valign="top" | <font color="gray">functions: </font>
 
| width="1px" align="right" valign="top" | <font color="gray">functions: </font>
 
|
 
|
[[  GetLastSpeaker  | GetLastSpeaker ]]
+
[[  GetLastSpeaker  | GetLastSpeaker ]] [[SpeakOneLinerConversation]] [[BeginConversation]] [[ActionStartConversation]]
 
|-
 
|-
 
|-
 
|-

Latest revision as of 20:31, 6 December 2020

Retrieves the PC that is currently in a conversation with an NPC.

Description

Returns the PC that is speaking in the current conversation.

It will return OBJECT_INVALID if there is no PC speaker, for example, with SpeakOneLinerConversation().


Remarks

This function can only be used in scripts that are called as part of a conversation, and always returns the PC talking.

Of course, if it is an NPC speaking to another NPC, it will return the NPC who is the one who takes the conversation choices (NPC's always take the first one after a short delay).


Version

1.28

Example

// An "Actions Taken" script to set a quest variable on the PC
// in an NPC conversation
void main() {
  object oPC = GetPCSpeaker();
  SetLocalInt( oPC, "golden_duck", 100);
}
// --- end of the 'Actions Taken' example.
 
// a StartingConditional for the "Text Appears When"
// script of an NPC conversation. The conversation node
// this script is attached to will only appear when the PC
// variable "golden_duck" has set to 100.
int StartingConditional() {
  object oPC = GetPCSpeaker();
  int nDuckState = GetLocalInt( oPC, "golden_duck");
  if (100 == nDuckState) return TRUE;
  return FALSE;
}

See Also

functions: 

GetLastSpeaker SpeakOneLinerConversation BeginConversation ActionStartConversation

events: 

OnConversation Event



 author: Iskander Merriman, editor: Jasperre, additional contributor(s): Charles Feduke