Skip to content

🖼 A Roblox UI library that's a retained recreation of ImGui which doesn't need a Renderstep connection like Iris

License

Notifications You must be signed in to change notification settings

depthso/Dear-ReGui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dear ReGui

Dear ReGui is a retained dear ImGui library remake designed to be used on Roblox! This is perfect for beginners and performance.

Documentation: https://depso.gitbook.io/regui

Notices

  • For suggestions or questions, please visit the discussions page
  • If you would like to fork this, please read the Forking section
  • Technical documentation and addional infomation such as commonly asked questions can be found on the Gitbook documentation

Demo

The best way to learn ReGUI is to look through the Demo window which comes bundled with ReGUI. The demo window is updated every significant update such as an addition of an element or a flag has been renamed.

https://github.com/depthso/Dear-ReGui/blob/main/src/Demo%20window.lua

Usage

ReGui can be used on any GUI type you want such as CoreGui, PlayerGui, BillboardGui, PluginGui, and SurfaceGui. Installation is as simple as importing the rbxm model into your project and connecting a client script to begin using it!

ReGui requires prefabs as it does not generate the base elments required for many elements such as the Window.

See the Getting Started - Installing section for more details

Once you have installed ReGUI into your project, it can be used by any client script anywhere!

local Window = ReGui:Window({
	Title = "Hello world!",
	Size = UDim2.fromOffset(300, 200)
})

Window:Label({Text="Hello, world!"})
Window:Button({
	Text = "Save",
	Callback = function()
		MySaveFunction()
	end,
})
Window:InputText({Label="string"})
Window:SliderFloat({Label = "float", Minimum = 0.0, Maximum = 1.0})

Gallery

Advanced customization example Demo window

Forking

If you would like to create a fork of ReGui, please read the steps below

Custom Prefabs

Using custom prefabs with ReGUI is very simple. To use custom prefabs you can point the library's Prefabs to the custom prefabs in the :Init call. For externally using custom prefabs, replace rbxassetid://{ReGui.PrefabsId} with rbxassetid://PrefabsID and replace PrefabsID with the id of your custom prefabs that you have published on Roblox.

ReGui prefabs asset: Prefabs Gui - Roblox

About

🖼 A Roblox UI library that's a retained recreation of ImGui which doesn't need a Renderstep connection like Iris

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages