Lightningbulb2 · May 8, 2026 · May 8, 2026 · May 8, 2026 · May 8, 2026 · May 8, 2026
diff --git a/changelog/snippets/graphics.7169.md b/changelog/snippets/graphics.7169.md
@@ -0,0 +1 @@
+- Improve scoreboard legibility with better alignment, tooltips, dropshadows, and text cropping (#7169).
diff --git a/changelog/snippets/other.7169.md b/changelog/snippets/other.7169.md
@@ -0,0 +1,4 @@
+- Add truncation for the Text control (#7169):
+  - Accessible with `SetTruncationEnabled()`
+    - Use `SetTruncationText()` to assign custom trailing characters like "..." when text is cropped
+  - `SetText()` is split into `SetText()` and its implicitly called `SetDisplayText()`. This allows for text preprocessing operations such as truncation.
diff --git a/loc/US/strings_db.lua b/loc/US/strings_db.lua
@@ -5964,6 +5964,10 @@ tooltipui0734="No Vote"
 tooltipui0735="Vote no to your team recalling from battle as a defeat."
 tooltipui0736="[Hide/Show] Mass Fabricator Panel"
 tooltipui0737="[Hide/Show] Voting Panel"
+tooltipui0738="Game Speed"
+tooltipui0739="[your requested speed] / [actual game speed]"
+tooltipui0740="Game Quality"
+tooltipui0741="Estimated game quality"
 
 -- External Factory and Auto-Deploy tooltips
 tooltipui0750 = "Mobile Factory"

diff --git a/lua/maui/text.lua b/lua/maui/text.lua
@@ -16,6 +16,11 @@ local LazyVarCreate = import("/lua/lazyvar.lua").Create
 Text = ClassUI(moho.text_methods, Control) {
 
     __init = function(self, parent, debugname)
+
+        self._truncationText = "..."
+        self._fullText = ""
+        self._truncationEnabled = false
+
         InternalCreateText(self, parent)
         if debugname then
             self:SetName(debugname)
@@ -33,6 +38,7 @@ Text = ClassUI(moho.text_methods, Control) {
         self._color.OnDirty = function(var)
             self:SetNewColor(var())
         end
+
     end,
 
     OnInit = function(self)
@@ -41,15 +47,138 @@ Text = ClassUI(moho.text_methods, Control) {
         self:SetClipToWidth(false)
     end,
 
-    SetClipToWidth = function(self, clipToWidth)
+    --- Directly sets displayed text
+    ---@see Text.SetText # To set the raw text
+    ---@type fun(self: Text, str: string | number)
+    SetDisplayText = moho.text_methods.SetText,
+
+    --- Directly gets the current displayed text
+    ---@see Text.SetText # To get the raw text
+    ---@type fun(self: Text): string
+    GetDisplayText = moho.text_methods.GetText,
+
+    --- Sets the raw text; actual displayed text is affected by operations like truncation
+    ---@see Text.SetDisplayText # To directly set the displayed text
+    ---@param text string | number
+    SetText = function(self, text)
+        local t_text = type(text)
+        if t_text ~= "string" and t_text ~= "number" then
+            error('Expected string or number but got ' .. t_text, 2)
+        end
+        self._fullText = tostring(text)
+        if self._truncationEnabled then
+            self:_applyTruncation()
+        else
+            self:SetDisplayText(self._fullText)
+        end
+    end,
+
+    --- Get the raw text before operations like truncation
+    ---@see Text.GetDisplayText # To directly get the displayed text
+    ---@return string
+    GetText = function(self)
+        return self._fullText
+    end,
+
+    --- Sets custom truncation trailing characters like "..." or "-".
+    ---@param text string
+    SetTruncationText = function(self, text)
+        self._truncationText = tostring(text)
+    end,
+
+    ---@param enabled boolean
+    SetTruncationEnabled = function(self, enabled)
+
+        -- prevent recursive OnDirty wrappers
+        if self._truncationEnabled == enabled then
+            return
+        end
+
+        self._truncationEnabled = enabled
+        if enabled then
+            -- Preserve any existing OnDirty callback before adding _applyTruncation
+            if self.Width.OnDirty then
+                self._originalWidthOnDirty = self.Width.OnDirty
+            end
+
+            self.Width.OnDirty = function(var)
+
+                if self._originalWidthOnDirty then
+                    self._originalWidthOnDirty(var)
+                end
+
+                self:_applyTruncation()
+            end
+
+            -- Apply truncation immediately so SetText() and SetTruncationEnabled() order doesn't matter
+            self:_applyTruncation()
+        else
+            -- Restore to the original OnDirty callback if it exists, otherwise set it to nil
+            if self._originalWidthOnDirty then
+                self.Width.OnDirty = self._originalWidthOnDirty
+                self._originalWidthOnDirty = nil
+            else
+                self.Width.OnDirty = nil
+            end
+            self:SetDisplayText(self._fullText)
+        end
+
+    end,
+
+    --- Adjusts text cropping behavior
+    ---@param clipToWidth boolean
+    ---@param truncationEnabled? boolean
+    ---@param customTruncationSymbol? string
+    SetClipToWidth = function(self, clipToWidth, truncationEnabled, customTruncationSymbol)
         if clipToWidth then
             self.Width:Set(function() return self.Right() - self.Left() end)
         else
+            self:SetTruncationEnabled(false)
             self.Width:Set(function() return math.floor(self.TextAdvance()) end)
         end
+
+        if truncationEnabled ~= nil then
+            self:SetTruncationEnabled(truncationEnabled)
+        end
+
+        if customTruncationSymbol ~= nil then
+            self:SetTruncationText(customTruncationSymbol)
+        end
+
         self:SetNewClipToWidth(clipToWidth)
     end,
 
+    --- Internal function to fit the truncation string inside the max width
+    _applyTruncation = function(self)
+
+        -- Avoid unnecessary truncation, and no width issues
+        if self._fullText == "" then return end
+
+        local initialized, maxWidth = pcall(function () return self.Width() end)
+        if not initialized or maxWidth <= 0 then
+            self:SetDisplayText(self._fullText)
+            return
+        end
+
+        local truncationText = self._truncationText
+        local str = self._fullText
+        if str == nil then return end
+        -- restore full text if it now fits
+        if self:GetStringAdvance(str) <= maxWidth then
+            self:SetDisplayText(str)
+            return
+        end
+
+        --iterate until string + truncation text fit
+        local i = STR_Utf8Len(str)
+        while i > 0 and self:GetStringAdvance(str .. truncationText) > maxWidth do
+            str = STR_Utf8SubString(str, 1, i - 1)
+            i = i - 1
+        end
+
+        self:SetDisplayText(str .. truncationText)
+    end,
+
     -- lazy var support
     SetFont = function(self, family, pointsize)
         if self._font then

diff --git a/lua/system/utils.lua b/lua/system/utils.lua
@@ -94,6 +94,7 @@ end
 ---@generic T
 ---@param t T
 ---@return T
+---@nodiscard
 function table.copy(t)
     if type(t) ~= 'table' then return t end
 

diff --git a/lua/ui/game/layouts/score_mini.lua b/lua/ui/game/layouts/score_mini.lua
@@ -66,6 +66,10 @@ function SetLayout()
     controls.timeIcon:SetTexture(UIUtil.UIFile('/game/unit_view_icons/time.dds'))
     LayoutHelpers.RightOf(controls.time, controls.timeIcon)
 
+    LayoutHelpers.RightOf(controls.gameSpeed, controls.time, 4)
+
+    LayoutHelpers.AtLeftTopIn(controls.gameQuality, controls.bgTop, 138, 6)
+
     LayoutHelpers.AtRightTopIn(controls.unitIcon, controls.bgTop, 10, 6)
     controls.unitIcon:SetTexture(UIUtil.UIFile('/dialogs/score-overlay/tank_bmp.dds'))
     LayoutHelpers.LeftOf(controls.units, controls.unitIcon)

diff --git a/lua/ui/game/score.lua b/lua/ui/game/score.lua
@@ -68,10 +68,14 @@ function updatePlayerName(line)
     end
 
     if sessionInfo.Options.Divisions then
-        line.name:SetText(playerClan .. playerName .. playerDivision)
+        line.division:SetText(playerDivision)
     else
-        line.name:SetText(playerClan .. playerName .. playerRating)
+        line.division:SetText(playerRating)
     end
+
+    line.name:SetText(playerClan .. playerName)
+    line.name:SetDropShadow(true)
+    LayoutHelpers.AnchorToLeft(line.name, line.division)
 end
 
 function armyGroupHeight()
@@ -119,14 +123,20 @@ function CreateScoreUI(parent)
 
     LayoutHelpers.SetWidth(controls.bgTop, 320)
 
-    controls.time = UIUtil.CreateText(controls.bgTop, '0', 12, UIUtil.bodyFont)
+    controls.time = UIUtil.CreateText(controls.bgTop, '0', 12, UIUtil.bodyFont, true)
     controls.time:SetColor('ff00dbff')
     controls.timeIcon = Bitmap(controls.bgTop)
     Tooltip.AddControlTooltip(controls.timeIcon, 'score_time')
     Tooltip.AddControlTooltip(controls.time, 'score_time')
+    controls.gameSpeed = UIUtil.CreateText(controls.bgTop, '', 12, UIUtil.bodyFont, true)
+    controls.gameSpeed:SetColor('ffbadaff')
+    Tooltip.AddControlTooltip(controls.gameSpeed, 'score_game_speed')
+    controls.gameQuality = UIUtil.CreateText(controls.bgTop, '', 12, UIUtil.bodyFont, true)
+    controls.gameQuality:SetColor('ff00dbff')
+    Tooltip.AddControlTooltip(controls.gameQuality, 'score_game_quality')
     controls.unitIcon = Bitmap(controls.bgTop)
     Tooltip.AddControlTooltip(controls.unitIcon, 'score_units')
-    controls.units = UIUtil.CreateText(controls.bgTop, '0', 12, UIUtil.bodyFont)
+    controls.units = UIUtil.CreateText(controls.bgTop, '0', 12, UIUtil.bodyFont, true)
     controls.units:SetColor('ffff9900')
     Tooltip.AddControlTooltip(controls.units, 'score_units')
 
@@ -303,14 +313,20 @@ function SetupPlayerLines()
         LayoutHelpers.AtVerticalCenterIn(group.name, group)
         group.name:SetColor('ffffffff')
 
+        group.division = UIUtil.CreateText(group, '', 12, UIUtil.bodyFont, true)
+        group.division:DisableHitTest()
+        LayoutHelpers.AtRightIn(group.division, group, 135)
+        LayoutHelpers.AtVerticalCenterIn(group.division, group)
+        group.division:SetColor('ffffffff')
+
         group.score = UIUtil.CreateText(group, '', 12, UIUtil.bodyFont)
         group.score:DisableHitTest()
         LayoutHelpers.AtRightIn(group.score, group, sw * 2 + 16)
         LayoutHelpers.AtVerticalCenterIn(group.score, group)
         group.score:SetColor('ffffffff')
 
         LayoutHelpers.AnchorToLeft(group.name, group.score, 5)
-        group.name:SetClipToWidth(true)
+        group.name:SetClipToWidth(true, true)
 
         if armyIndex ~= 0 then
             group.mass = Bitmap(group)
@@ -373,6 +389,19 @@ function SetupPlayerLines()
             Tooltip.AddControlTooltip(group.units, {text = '', body = bodyText}, 1)
         end
 
+        -- hover to see full name (incase they are cut off)
+        group.nameHover = Bitmap(group)
+        group.nameHover:SetAlpha(0)
+        LayoutHelpers.AnchorToLeft(group.nameHover, group.division)
+        LayoutHelpers.AtLeftIn(group.nameHover, group, 12)
+        group.nameHover.Height:Set(group.name.Height)
+        LayoutHelpers.AtVerticalCenterIn(group.nameHover, group)
+        Tooltip.AddAutoUpdatedControlTooltip(group.nameHover,
+            function() return group.name:GetText() or "" end,
+            function() return "" end,
+            0.5
+        )
+
         group.Height:Set(group.faction.Height)
         group.Width:Set(controls.armyGroup.Width)
         group.armyID = armyIndex
@@ -417,6 +446,7 @@ function SetupPlayerLines()
     observerLine:Hide()
     observerLine.OnHide = blockOnHide
     observerLine.name.Top:Set(observerLine.Top)
+    observerLine.name:SetDropShadow(true)
     LayoutHelpers.SetHeight(observerLine, 15)
 
     if SessionIsReplay() then
@@ -477,7 +507,7 @@ function SetupPlayerLines()
         end
 
         -- ui for share conditions
-        group.ShareConditions = UIUtil.CreateText(group, data.ShareConditionsTitle, 10, UIUtil.bodyFont)
+        group.ShareConditions = UIUtil.CreateText(group, data.ShareConditionsTitle, 10, UIUtil.bodyFont, true)
         Tooltip.AddForcedControlTooltipManual(group.ShareConditions, data.ShareConditionsTitle, data.ShareConditionsDescription)
         LayoutHelpers.AtLeftIn(group.ShareConditions, group)
         LayoutHelpers.AtVerticalCenterIn(group.ShareConditions, group)
@@ -486,15 +516,15 @@ function SetupPlayerLines()
         previous = AddDash()
 
         -- ui for map size
-        group.Size = UIUtil.CreateText(group, data.SizeText, 10, UIUtil.bodyFont)
+        group.Size = UIUtil.CreateText(group, data.SizeText, 10, UIUtil.bodyFont, true)
         LayoutHelpers.RightOf(group.Size, previous)
         LayoutHelpers.AtVerticalCenterIn(group.Size, group)
         group.Size:SetColor('ffffffff')
         previous = group.Size
         previous = AddDash()
 
         -- ui for map name
-        group.MapName = UIUtil.CreateText(group, data.MapTitle, 10, UIUtil.bodyFont)
+        group.MapName = UIUtil.CreateText(group, data.MapTitle, 10, UIUtil.bodyFont, true)
         Tooltip.AddForcedControlTooltipManual(group.MapName, data.MapTitle, data.MapDescription)
         LayoutHelpers.RightOf(group.MapName, previous)
         LayoutHelpers.AtVerticalCenterIn(group.MapName, group)
@@ -619,11 +649,17 @@ local prevPlayableWidth = sessionInfo.PlayableAreaWidth
 local prevPlayableHeight = sessionInfo.PlayableAreaHeight
 
 function _OnBeat()
-    local s = string.format("%s (%+d / %+d)", GetGameTime(), gameSpeed, GetSimRate())
+    local t = string.format("%s", GetGameTime())
+    controls.time:SetText(t)
+
+    local s = string.format("(%+d / %+d)",gameSpeed, GetSimRate())
+    controls.gameSpeed:SetText(s)
+
     if sessionInfo.Options.Quality then
-        s = string.format("%s Q:%.2f%%", s, sessionInfo.Options.Quality)
+        local q = string.format("Q:%.2f%%", sessionInfo.Options.Quality)
+        controls.gameQuality:SetText(q)
     end
-    controls.time:SetText(s)
+
 
     if sessionInfo.Options.NoRushOption and sessionInfo.Options.NoRushOption ~= 'Off' then
         local norush = tonumber(sessionInfo.Options.NoRushOption) * 60
@@ -666,6 +702,7 @@ function _OnBeat()
                         if GetFocusArmy() ~= index then
                             line.name:SetColor('ffa0a0a0')
                             line.score:SetColor('ffa0a0a0')
+                            line.division:SetColor('ffa0a0a0')
                         end
                         line.mass_in:SetColor('ffa0a0a0')
                         line.energy_in:SetColor('ffa0a0a0')
@@ -718,26 +755,36 @@ function _OnBeat()
             if line.armyID == prevArmy then
                 if line.OOG then
                     line.name:SetColor('ffa0a0a0')
+                    line.division:SetColor('ffa0a0a0')
                     line.score:SetColor('ffa0a0a0')
                 else
                     line.name:SetColor('ffffffff')
+                    line.division:SetColor('ffffffff')
                     line.score:SetColor('ffffffff')
                 end
                 line.name:SetFont(UIUtil.bodyFont, 12)
+                line.division:SetFont(UIUtil.bodyFont, 12)
                 line.score:SetFont(UIUtil.bodyFont, 12)
             elseif line.armyID == curFA then
                 line.name:SetColor('ffff7f00')
+                line.division:SetColor('ffff7f00')
                 line.score:SetColor('ffff7f00')
+
                 line.name:SetFont('Arial Bold', 12)
+                line.division:SetFont('Arial Bold', 12)
                 line.score:SetFont('Arial Bold', 12)
             end
         end
         if curFA < 1 then
             observerLine.name:SetColor('ffff7f00')
+            observerLine.division:SetColor('ffff7f00')
+            observerLine.division:SetFont('Arial Bold', 12)
             observerLine.name:SetFont('Arial Bold', 12)
         elseif prevArmy < 1 then
             observerLine.name:SetColor('ffffffff')
+            observerLine.division:SetColor('ffffffff')
             observerLine.name:SetFont(UIUtil.bodyFont, 12)
+            observerLine.division:SetFont(UIUtil.bodyFont, 12)
         end
         if observerLine:IsHidden() and ((curFA < 1) or (sessionInfo.Options.CheatsEnabled == 'true')) then
             table.insert(controls.armyLines, table.getsize(controls.armyLines), observerLine)

diff --git a/lua/ui/help/tooltips.lua b/lua/ui/help/tooltips.lua
@@ -1817,6 +1817,14 @@ Tooltips = {
         title = "<LOC tooltipui0473>Game Time",
         description = "",
     },
+    score_game_speed ={
+        title = "<LOC tooltipui0738>Game Speed",
+        description = "<LOC tooltipui0739>[your requested speed] / [actual game speed]",
+    },
+    score_game_quality = {
+        title = "<LOC tooltipui0740>Game Quality",
+        description = "<LOC tooltipui0741>Estimated game quality",
+    },
     score_units = {
         title = "<LOC tooltipui0474>Unit Count",
         description = "<LOC tooltipui0507>Current and maximum unit counts",
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		- Improve scoreboard legibility with better alignment, tooltips, dropshadows, and text cropping (#7169).