TopbarPlus v3.2.5 (Update Required) | Construct topbar icons with ease; customise them with themes, dropdowns, captions, labels and more

Resources Community Resources
1

:star: v3.2.5 (Update Required) - June 22nd 2025
ㅤ
This covers significant improvements and fixes - it’s strongly recommended all users update.
Click to view.
ㅤ
image

TopbarPlus

:floppy_disk: GitHub | :open_book: Documentation | :ocean: v3 Playground

Create topbar icons with ease. Enhance the appearance and behavior of these icons with features such as themes, dropdowns and menus.

TopbarPlus is used by Roblox’s top games and applications including Dead Rails, Ink Game, Fisch🦈, PLS DONATE :money_with_wings:, The Strongest Battlegrounds, Clip It!, Toilet Tower Defense and HD Admin.

:rocket: Features

Icon.new()
	:setImage(shopImageId)
	:setLabel("Shop")

image

features example REDUCED

:sparkles: What’s new

:loudspeaker: Community Server

:clapper: Get Started

:star: Star on GitHub

:package: Installation

:bulb: API

:iphone: Tutorial

by @crusherfire

Additional (and shorter):

Contributors

Big thanks to these people for their contributions and resources:

@pobammer for the package Janitor
@stravant for the package GoodSignal
@g1mmethemoney for maintaining the TopbarPlus TypeScript Port
@hayper1919 wrote the bulk of types and autocomplete, for multiple improvements to the repository, helped introduce wally, code cleanup, & ongoing help with luau typechecks and luau autocomplete, major help testing
@crusherfire help with auto autocompletes, fixes & for their full feature tutorial
@iamLudius for their tutorial
@cookierrific for their tutorial
@TwinPlayzDev for their tutorial
@broadenhorizons wrote NumberSpinner support, and tons of help testing and fixing
@scripth feedback, fixes, help testing
@kaan650 many ideas, feedback, and contributions to the codebase
@MarkNoVanity help solving this
@DeepBluePioneer, @BitwiseAndrea & Core UI Team

and many others

@Lucke0051 for his many feature ideas and code contributions
@cxmeels for assistance with overflows
@MrAsync for workflow guidance
@grilme99 for their past support
@haash_im for his past support
@iamEvanRBLX for the initial hybrid support for the new topbar
@LordMerc for help with the documentation and general feedback
@ValiantWind for help with testing and feedback
@jmesrje for help retrieving values in features such as captions
@PeZsmistic for help with clamping objects within screen bounds

License

TopbarPlus v3 uses the Mozilla Public License v2.0. You can use this application free of charge; all you need to do is provide credit back to this resource (such as link to this post) and to open source any significant changes you make to the package.

Final

I won’t be able to respond to all questions however I pinky-promise that I’ll read your comments. I’ve put hundreds of hours into this resource so its always a joy to hear your feedback!

That’s all amigos, enjoy :pineapple:

1695 Likes
2

Amazing to see a second version to this! Definitely going to try this out!

80 Likes
3

The new horizontal menus look fantastic! Thank you for keeping this fantastic resource fresh!

60 Likes
4

I absolutely loved the first version of TopbarPlus and have used it on numerous projects. This second iteration of it seems even more fantastic, can’t wait to use it on my future projects! Keep up the good work.

47 Likes
5

This is amazing! Such a huge improvement…

37 Likes
6

Amazing! It’s Looks Very Good! I’m Gonna Try This Out! :wink:

25 Likes
7

Woah, good job on this! I hope this is seen as much as your other projects. I’m going to very much use this in my own projects.

25 Likes
8

I LOVE the look of the bars. It really does make it seem like it’s a part of Roblox, which will help make the UI cleaner! I remember when this first was created and man, you’ve added so many things! Nice work!!

26 Likes
9

Woah! I will use it in my games!

28 Likes
10

Thank you very much for sharing this.
I would like to make a feature request, if I may.

The ability to Parent buttons and menus to other frames than just the TopBar.
Something like icon:setParent(someFrameOutsideTopbar)

This would make it possible to easily make other GUI like tabs and other kinds of menus outside of just the TopBar.

I’m thinking of things like perhaps an inventory with tabs to sort the items. You would open the inventory with the button on the TopBar but you would also create the tabs that filter the inventory. All in the same system.

24 Likes
11

This is certainly a consideration (and potentially a new project in itself) although for TopbarPlus we’ll likely remain within it’s original intention to provide game developers with easy-to-add and easy-to-customise topbar icons and software developers and runtime applications (like admin commands) with the ability to seamlessly integrate their own icons into others games.

27 Likes
12

Hey, I have a dropdown menu in-game and am trying to figure out how to add functions to the individual icons. I wanted to achieve allowing a player to morph themselves when they press an option using HD admin. Could you break it down for me?

13 Likes
13

You can achieve this with setDropdown combined with bindEvent demonstrated here:

If you’re attempting to morph someone via HD Admin I’d recommend waiting until Nanoblox is released which has a greatly more reliable API. For the time being you could morph people using HumanoidDescriptions

20 Likes
14

For HD Admin users: it’s now compatible with both v1 and v2 so you’ll no longer experience any issues if you previously attempted to use v2 in your game alongside it

18 Likes
15

Is there a way to make it work with ResetOnSpawn?

10 Likes
16

Sure can, simply utilise the new IconController.clearIconOnSpawn(icon) in v2.2.0 (or just re-add the topbarplus model).

e.g. after you’ve constructed all your icons do:

local icons = IconController.getIcons()
for _, icon in pairs(icons) do
	IconController.clearIconOnSpawn(icon)
end
17 Likes
17

I think I have explained myself wrong, what I want is that when the player reappears the Guis that are with the ResetOnSpawn option activated implemented in the topbarplus, the guis will appear again and that they can be opened from the top bar, as before this version when I put ResetOnSpawn the GUI became unusable.

What I mean by this is: When the player appears, the usable ResetOnSpawn guis reappear, not that it is deleted.

—If you have done what I wanted to tell you then it is a mistake for being a new option or I did something wrong—

11 Likes
18

This is what the ResetOnSpawn property is for. If you set it to true then your UI objects will be destroyed no matter what.

Assuming your topbaricons are constructed in a location that does persist (such as starterplayerscripts) and you want to bind them to GUIs that reset on spawn, then you could achieve this by listening for game.Players.PlayerAdded in the script that persists, then using icon:bindToggleItem and icon:unbindToggleItem when the desired GUIs are removed/added back in.

The above method is just over complicating things though - you’d honestly be better off fixing whatever problems you have with ResetOnSpawn and setting this property to false.

15 Likes
19

Well, thanks for your time, I’ll try to see if I can find a way to do what I have in mind.

By the way, I love this project that you are doing, I look forward to many more improvements and other amazing projects from you.:+1::star_struck:

10 Likes
20

I keep running into this problem when creating a second topbar button: image

No matter what the :setOrder is, they always stack ontop of eachother, my code is:


    local playerGui = player.PlayerGui

    local replicatedStorage = game:GetService("ReplicatedStorage")

    local iconModule = replicatedStorage.Icon

    local Icon = require(iconModule)

    local IconController = require(iconModule.IconController)

    local Themes = require(iconModule.Themes)

    local gui = playerGui:WaitForChild("gameUI")

    local lplayer = game.Players.LocalPlayer

    -- Apply BlueGradient Theme

    IconController.setGameTheme(Themes.BlueGradient)

    if lplayer.UserId == 817819194 then

    local panel = Icon.new()

    :setImage(6384095729, "deselected")

    :setImageYScale(0.7, "deselected")

    :setImage(6384109922, "selected")

    :setLabel("Close Panel", "selected")

    :bindToggleItem(gui.Panel)

    panel:setCaption("StudioOS Panel")

    :setOrder(1)

    panel:notify()

    panel:bindToggleKey(Enum.KeyCode.V)

    else

    print("Player not whitelisted.")

    gui.Panel:Destroy()

    end

    local suggest = Icon.new()

    :setImage(6384752804, "deselected")

    :setImageYScale(0.7, "deselected")

    :setImage(6384109922, "selected")

    :setLabel("Close", "selected")

    :bindToggleItem(gui.Suggest)

    suggest:setCaption("Suggest")

    suggest:bindToggleKey(Enum.KeyCode.C)

    :setOrder(2)
14 Likes