https://github.com/depthso/roblox-imgui
🖼 A Roblox UI library that's a retained recreation of ImGui which doesn't need a Renderstep connection like Iris
https://github.com/depthso/roblox-imgui
gui imgui imgui-menu lua luau roblox roblox-gui roblox-lib roblox-library roblox-script roblox-scripts roblox-ui roblox-ui-lib ui-library
Last synced: 1 day ago
JSON representation
🖼 A Roblox UI library that's a retained recreation of ImGui which doesn't need a Renderstep connection like Iris
- Host: GitHub
- URL: https://github.com/depthso/roblox-imgui
- Owner: depthso
- License: mit
- Created: 2024-07-25T11:59:59.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-07T20:03:12.000Z (3 months ago)
- Last Synced: 2025-07-07T21:46:21.904Z (3 months ago)
- Topics: gui, imgui, imgui-menu, lua, luau, roblox, roblox-gui, roblox-lib, roblox-library, roblox-script, roblox-scripts, roblox-ui, roblox-ui-lib, ui-library
- Language: Luau
- Homepage: https://depso.gitbook.io/regui
- Size: 4.31 MB
- Stars: 104
- Watchers: 5
- Forks: 31
- Open Issues: 4
-
Metadata Files:
- Readme: docs/README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/depthso/Dear-ReGui/discussions)
- If you would like to fork this, please read the [Forking](#forking) section
- Technical documentation and addional infomation such as commonly asked questions can be found on the [Gitbook documentation](https://depso.gitbook.io/regui)
## 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](https://depso.gitbook.io/regui/getting-started/installing) section for more details
Once you have installed ReGUI into your project, it can be used by any client script anywhere!
```lua
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](https://create.roblox.com/store/asset/71968920594655)