Skip to main content

hide billboards

hides overhead nametags and billboard guis.

overview​

the hide billboards feature removes overhead nametags and other billboard guis from the workspace.

specifically targets billboardguis named:

  • PlayerName
  • NameTagTemplate
  • NameTag

how it works​

on enable​

  1. searches workspace descendants for all billboardguis
  2. checks name against target list
  3. sets Enabled = false on matches

targeted approach​

only specific billboard names are hidden because:

  • some games use billboards for important ui
  • quest markers, health bars, indicators shouldn't be hidden
  • only overhead player nametags are visual clutter

why these names?​

  • PlayerName - default roblox player nametag
  • NameTagTemplate - common custom nametag name
  • NameTag - another common convention

these cover most roblox games' player nametags.

technical implementation​

local HIDE_BILLBOARD_NAMES = {"PlayerName", "NameTagTemplate", "NameTag"}

local function setBillboardsState(state)
    for _, desc in ipairs(Workspace:GetDescendants()) do
        if desc:IsA("BillboardGui") and table.find(HIDE_BILLBOARD_NAMES, desc.Name) then
            desc.Enabled = state
        end
    end
end

simple and efficient:

  • single loop through workspace
  • type check for billboardgui
  • name check against list
  • toggle enabled property

use cases​

clean screenshots​

remove floating names above players.

cinematic recording​

eliminate ui elements that break immersion.

tutorial videos​

focus on gameplay without nametag distractions.

on disable​

when disabled:

  • sets Enabled = true on all previously hidden billboards
  • billboardguis return to normal state

limitations​

doesn't catch all billboards​

only hides billboards with specific names. if a game uses different naming:

  • billboards won't be hidden
  • you'll need to modify the name list

doesn't hide new billboards​

billboards created after enable won't be automatically hidden. you'd need to:

  • toggle lcs off and on again
  • or add an event listener for new billboards (not implemented)

workspace only​

only searches workspace. billboards in other locations (playergui, etc) are not affected.

customization​

adding more names​

edit HIDE_BILLBOARD_NAMES:

local HIDE_BILLBOARD_NAMES = {
    "PlayerName",
    "NameTagTemplate", 
    "NameTag",
    "CustomNameTag",    -- add your own
    "DisplayName",      -- add more as needed
}

hiding all billboards​

remove the name check:

local function setBillboardsState(state)
    for _, desc in ipairs(Workspace:GetDescendants()) do
        if desc:IsA("BillboardGui") then
            desc.Enabled = state
        end
    end
end

warning: this may hide important game ui!

game-specific targeting​

some games have unique billboard systems. to target them:

  1. use explorer to find billboard names in game
  2. add those names to the list
  3. reload lcs

source code​

location: features/hideBillboards.lua

very simple module (~30 lines):

  • name list constant
  • toggle function
  • enable/disable exports

troubleshooting​

billboards not hiding​

  • check billboard names in game explorer
  • add those names to the list
  • fork repo and host your modified version

important ui disappeared​

  • some games use billboardguis for critical ui
  • toggle lcs off to restore
  • remove problematic names from list