Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:28Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=WorldObject}}
Makes a window follow a world object (a player, creature or other object) on screen.

<pre>
AttachWindowToWorldObject(windowName, worldObjectId)
</pre>

== Arguments ==
;windowName : <code>string</code> – Name of the window to attach.
;worldObjectId : <code>number</code> – ID of the world object, as given by the game data and events.

== Returns ==
Nothing.

== Details ==
* The window is added to the object's list of attached windows. One object can have several windows, and the client does not check whether the window is already in the list.
* Every frame, the client projects each attached object's position to the screen. For each attached window:
** the window is shown when the point is on screen and hidden when it is not;
** when the projected point moves, the window is moved so that it is centred horizontally on the point with its bottom edge on the point, then kept inside the screen.
* For player objects the point is taken from the character's model when one is available.
* When the object no longer exists, its attachments are removed automatically. The window itself is not destroyed.
* The function needs at least two arguments and only reads the last two.

== Errors ==
* <code>Error in function call 'AttachWindowToWorldObject': window %s does not exist</code>

== Example ==
Attaching an event-text anchor to its target, from <code>default/easystem_eventtext/source/system_eventtext.lua</code>:
<pre>
-- Have to use MoveWindowToWorldObject() like
-- MoveWindowToWorldObject(self.m_Anchor, self.m_TargetObject, self.m_AttachHeight)
-- if we want to have scaled attachment? Or modify AttachWindowToWorldObject() at some point.
AttachWindowToWorldObject(anchorWindowName, targetObjectNumber)
</pre>

== See also ==
* [[API:DetachWindowFromWorldObject|DetachWindowFromWorldObject]]
* [[API:ForceUpdateWorldObjectWindow|ForceUpdateWorldObjectWindow]]
* [[API:MoveWindowToWorldObject|MoveWindowToWorldObject]]

API:AttachWindowToWorldObject - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)