Nelqz Website

Scripts & Utilities

โ† Back

Leon UI Library Docs

A lightweight Roblox UI library for script hubs, written in Luau. Everything here comes from the official example script. Repository โ†—

Getting started

Load the library, then set the theme before you create a window.

local Library = loadstring(game:HttpGet("https://raw.githubusercontent.com/nelqz/leon-ui-library/refs/heads/main/leon-ui-library-open.luau"))()

Library.Theme.Accent = Color3.fromRGB(255, 255, 255)

Window

Library:CreateWindow({...}) returns the window object. Options used in the example:

  • Name: window title
  • Keybind: key that opens and closes it (Enum.KeyCode.RightShift)
  • Launcher and LauncherText: show a launcher button with short text
  • AutoOpen: open on load
  • Blur: blur the background while open
  • Size: a UDim2, e.g. UDim2.fromScale(0.7, 0.75)

Tabs and sections

  • Window:CreateTab(name) creates a tab
  • Tab:CreateSection(name) adds a titled section
  • Tab:Select() switches to that tab

Elements

Create them on a tab, e.g. Main:CreateButton({...}). Each returns an object you can update later.

Label

CreateLabel(text) ยท Set(text)

Button

Name, Callback() ยท SetText(text)

Toggle

Name, Default, Callback(on) ยท Set(bool), Get()

Slider

Name, Min, Max, Step, Default, Suffix, Callback(value) ยท Set(n), Get()

Dropdown

Name, Options, Default, Callback(value) ยท SetOptions(list), Set(value), Get()

Input

Name, Default, Placeholder, Callback(text) ยท Set(text), Get()

Keybind

Name, Default, Callback() ยท Set(key), Get()

The example also calls Toggle:Set(false, true) and Slider:Set(25, true) with a second argument. It does not say what that does, so check the library source before relying on it.

Window controls

  • Window:Notify(text, seconds) shows a notification
  • Window:SetBlur(on) toggles the blur
  • Window:SetOpen(open) opens or closes the window
  • Window:Toggle() flips open and closed
  • Window:Destroy() removes the UI (good for an Unload button)

Full example

local Library = loadstring(game:HttpGet("https://raw.githubusercontent.com/nelqz/leon-ui-library/refs/heads/main/leon-ui-library-open.luau"))()

Library.Theme.Accent = Color3.fromRGB(255, 255, 255)

local Window = Library:CreateWindow({
	Name = "My Hub",
	Keybind = Enum.KeyCode.RightShift,
	LauncherText = "MH",
	Launcher = true,
	AutoOpen = true,
	Blur = true,
	Size = UDim2.fromScale(0.7, 0.75),
})

local Main = Window:CreateTab("Main")
local Settings = Window:CreateTab("Settings")

Main:CreateSection("Elements")

local Label = Main:CreateLabel("Status: idle")

local Button = Main:CreateButton({
	Name = "Click me",
	Callback = function()
		Label:Set("Status: clicked")
		Window:Notify("Button clicked", 3)
	end,
})

local Toggle = Main:CreateToggle({
	Name = "Toggle",
	Default = false,
	Callback = function(on)
		print("Toggle", on)
	end,
})

local Slider = Main:CreateSlider({
	Name = "Slider",
	Min = 0,
	Max = 100,
	Step = 1,
	Default = 50,
	Suffix = "%",
	Callback = function(value)
		print("Slider", value)
	end,
})

local Dropdown = Main:CreateDropdown({
	Name = "Dropdown",
	Options = { "One", "Two", "Three" },
	Default = "One",
	Callback = function(value)
		print("Dropdown", value)
	end,
})

local Input = Main:CreateInput({
	Name = "Input",
	Default = "",
	Placeholder = "Type here...",
	Callback = function(text)
		print("Input", text)
	end,
})

local Keybind = Main:CreateKeybind({
	Name = "Keybind",
	Default = Enum.KeyCode.F,
	Callback = function()
		print("Keybind pressed")
	end,
})

Settings:CreateSection("Window")

Settings:CreateToggle({
	Name = "Blur",
	Default = true,
	Callback = function(on)
		Window:SetBlur(on)
	end,
})

Settings:CreateButton({
	Name = "Close window",
	Callback = function()
		Window:SetOpen(false)
	end,
})

Settings:CreateButton({
	Name = "Toggle window",
	Callback = function()
		Window:Toggle()
	end,
})

Settings:CreateButton({
	Name = "Go to Main tab",
	Callback = function()
		Main:Select()
	end,
})

Settings:CreateButton({
	Name = "Unload",
	Callback = function()
		Window:Destroy()
	end,
})

Button:SetText("Click me!")
Toggle:Set(true)
Toggle:Set(false, true)
Slider:Set(75)
Slider:Set(25, true)
Dropdown:SetOptions({ "A", "B", "C" })
Dropdown:Set("B")
Input:Set("Hello")
Keybind:Set(Enum.KeyCode.G)

print(Toggle:Get(), Slider:Get(), Dropdown:Get(), Input:Get(), Keybind:Get())

Window:Notify("Loaded", 3)