Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:47:25Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Interface}}
Sets the translation (position offset) of the 3D model shown in a NifDisplay window.

<pre>
NifDisplaySetTranslation(windowName, x, y, z)
</pre>

== Arguments ==
;windowName : <code>string</code> – Name of a NifDisplay window.
;x, y, z : <code>number</code> – The translation along the three axes.

== Returns ==
Nothing.

== Details ==
* The three values are stored as the display's translation. They are not range-checked.
* The stock barber shop uses it to adjust the character shown in its "mirror", with different values for tall and short races (see the example). Its comment for orcs reads ''"need camera further back"''.
* The stock UI does not call it anywhere else.
* The function needs at least four arguments and only reads the last four.

== Errors ==
These are written to the UI log; the call returns normally.
* <code>Error in function call 'NifDisplaySetTranslation': Window %s does not exist</code>
* <code>Error in function call 'NifDisplaySetTranslation': Window %s is not a NifDisplay</code>

== Example ==
From <code>ea_barbershopwindow/source/barbershopwindow.lua</code>:
<pre>
-- For some characters, we need to tweak the NifDisplay to make sure they show up in the mirror appropriately
if ( ( ( GameData.Player.race.id == GameData.Races.HIGH_ELF ) or ( GameData.Player.race.id == GameData.Races.DARK_ELF ) ) and ( GameData.Player.gender == GameData.Gender.MALE ) )
then
-- Male high elves and dark elves are very tall
NifDisplaySetTranslation( mainWindowName.."CharacterNif", 0, -80, 66 )
...
elseif ( GameData.Player.race.id == GameData.Races.DWARF )
then
-- Dwarves are very short
NifDisplaySetTranslation( mainWindowName.."CharacterNif", 0, -110, 37 )
</pre>

== See also ==
* [[API:WindowSetDimensions|WindowSetDimensions]]

API:NifDisplaySetTranslation - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)