Difference between revisions of "AddScriptPackage"
Added a note about interrupt packages
imported>Khadir (Documenting actor functions ... + Reference) |
imported>QQuix (Added a note about interrupt packages) |
||
| (10 intermediate revisions by 9 users not shown) | |||
| Line 1: | Line 1: | ||
'''Syntax''' | |||
''[ActorRefID.]''AddScriptPackage PackageID:ref | |||
Adds a script package to the calling actor. This package takes precedence over all other packages until it is done. | |||
== | ==Examples== | ||
AddScriptPackage MQ07BeggarToTavern | AddScriptPackage MQ07BeggarToTavern | ||
==Notes== | |||
* An actor can have only one script package at a time. When calling the function twice on the same actor, the second package replaces the first one added. | |||
* Unless the added package has some constraint on it ("must complete" and/or "must reach location"), it will be removed the next time the actor reevaluates his package. | |||
* This function does not work if the actor is currently running an interrupt package (e.g. dialogue). You may detect if the current package is an interrupt package by checking if the current package mod index is 255 (see [[GetSourceModIndex]]) or by comparing [[GetCurrentPackage]] (which returns an interrupt package) with [[GetCurrentEditorPackage]] (which will ignore interrupt packages and return the active package - the one that has been interrupted and will resume later). If they return different packages, the actor is running an interrupt package. | |||
== | ==See Also== | ||
*[[RemoveScriptPackage]] | |||
*[[EvaluatePackage]] | |||
[[Category: Functions]] | [[Category: Functions]] | ||
[[Category:Functions (CS)]] | |||
[[Category: Functions (CS 1.0)]] | |||
[[Category: AI Functions]] | [[Category: AI Functions]] | ||
[[Category: AI Functions (CS 1.0)]] | |||
[[Category: Actor Functions]] | |||
[[Category: Actor Functions (CS 1.0)]] | |||
<!-- Begin Search Terms | |||
Add | |||
Script | |||
Package | |||
End Search Terms --> | |||