Actually usable Overhead Gui

CosmicArmonica · June 26, 2025, 3:12pm

Hey yall, I thought I’ll come on here and share my overhead gui script, i have looked at all the other free ones and found out that they all horrid (using server sided scripts, not being able to see them from afar, or just look horrible.)

This script uses a local script, still viewable from afar, has subtitles, changes the health bar’s color according to the player’s team and special overheads for bosses.

This script comes with a config module which has a lot of settings for you to change:

Config

distancePoints = {80, 120}, -- where it starts to fade, and when it gone completely
size = UDim2.new(0, 260, 0, 110), -- sets the size of the overhead ui
studsAboveHead = 4.5, -- how far the gui will be above the players humanoidrootpart
hideSelfGui = false, -- hides the local players billboard from them
tweenHealthbar = true, -- tweens the healthbar giving it smooth animations
includeUsername = false, -- shows the players name next to their display name
	separateUsernameAndDisplayname = true, -- puts the username below the display name if includeUsername is on
giveUIToNpcs = true, -- gives the overhead to npcs
hideHealthBarWhenFull = true,
changeHealthBarColorToRepresentTeamColor = true,
debug = false, -- prints out messages
	
doNotShowOverheadUI = "NoOverhead", -- tag this on a character model to disable the ui
bossTag = "Boss", -- put a tag on a character model
npcSubTitle = "Title", -- put an attribute to a character model and put in a string
overheadTransparencyFollowsCharacterTransparency = true, -- if a character is transparent, so will the overhead
showOverheadThroughCollidableParts = true, -- shows overheads through parts

subTitles = {
	enabled = true, -- shows the <WOWOOOWOWOW>
	-- you can only have 3 labels on a gui, this is to prevent weird visual glitches
		
	textFormat = "<format>", -- will show the "<>" around the title you can remove this if you want

	showDeveloperLabel = true,
	showFriendLabel = true,
		
	groups = false, -- set this to true to show group roles
	groupId = 32493687, -- your group ID here

	-- custom sub titles for users
	userIds = {
		[00000000] = "Admin", -- example
	},
},

here are some screenshots of what it looks like

regular: