Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:44:30Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Ability}}
Returns how full the morale bar must be, in percent, to reach a morale level.

<pre>
percent = GetMoralePercentForLevel(level)
</pre>

== Arguments ==
;level : <code>number</code> – Morale level, 1 to 4.

== Returns ==
;percent : <code>number</code> – Percentage, a whole number. 0 if <code>level</code> is outside 1 to 4.

== Details ==
* The client divides a fixed threshold for the level by the player's maximum morale and rounds down: <code>threshold × 100 / maximum</code>. The built-in thresholds are 360, 720, 1800 and 3600. When the player's maximum morale is 0, 3600 is used, which gives 10, 20, 50 and 100.
* If there is no player object, or the Lua state is not available, the function returns nothing.

== Errors ==
None besides the generic ''Invalid Parameters'' message when the argument is missing or not a number.

== Example ==
From <code>ea_moralewindow/source/moralewindow.lua</code>:
<pre>
for level = 1, GameData.NUM_MORALE_LEVELS
do
moraleBar.m_Buttons[level] = MoraleButton:Create (windowName.."ContentsButton"..level, windowName.."Contents", level)
moraleBar.m_PercentagesForLevel[level] = GetMoralePercentForLevel (level)
moraleBar.m_FillAmountsForLevel[level] = (MORALE_PERCENT_MAX / GameData.NUM_MORALE_LEVELS) * level
end
</pre>

== See also ==
* [[API:GetPlayerMoraleLevel|GetPlayerMoraleLevel]]
* [[API:GetMoraleBarData|GetMoraleBarData]]

API:GetMoralePercentForLevel - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)