Sets the transition target for oTransition.
- oTransition can be any valid game object, except areas.
- oTarget can be any valid game object with a location, or OBJECT_INVALID (to unlink).
- Rebinding a transition will NOT change the other end of the transition; for example, with normal doors you will have to do either end separately.
- Any valid game object can hold a transition target, but only some are used by the game engine (doors and triggers). This might change in the future. You can still set and query them for other game objects from nwscript.
- Transition target objects are cached: The toolset-configured destination tag is used for a lookup only once, at first use. Thus, attempting to use SetTag() to change the destination for a transition will not work in a predictable fashion.
You can also use it to override the default behaviour of default door tranistions to store something more interesting - perhaps you want a door that teleports you to a specifically created placeable, or even a creature instance that is moving around.
A secondary use is, as suggested by the description, a very fast-access single-sized Get/SetLocalObject() alternative (and even GetObjectByTag() alternative). If there is no tranisition functionality for the object it is "safe" to use as long as scripts don't clash. Demonstrationable speed improvements to a stored "array" (or rather linked list) is possible by using a simple object like a waypoint and chaining the waypoints together to refer to the next one along, compared to using dozens of GetObjectByTag() to loop objects with storage on them.
You could also conceptually use it to sort waypoint pathing, even dynamically or randomly, by having each waypoint point to the next location to use.
1.74.8149 - Note that the description of this function was omitted from the PDF release notes. The function is described in a readme in the lang/<language>/docs directory delivered with Neverwinter Nights Enhanced Edition, and in the toolset script editor.
|functions:||DestroyArea() CopyArea() CreateArea() GetTransitionTarget()|