Skip to main content

ignore gui inset

forces fullscreen rendering for all screen guis.

overview

the ignore gui inset feature makes all screen guis render edge-to-edge by setting IgnoreGuiInset = true on all screenguis.

what is gui inset?

the safe area

by default, roblox guis have a "safe area" inset:

  • top bar area reserved for roblox ui
  • prevents your ui from overlapping roblox's
  • creates a gap at the top of screen

ignoreguiinset property

when IgnoreGuiInset = true:

  • gui renders behind roblox's top bar
  • fills entire screen
  • gives edge-to-edge appearance

how it works

on enable

  1. applies to existing guis:

    for _, gui in ipairs(playerGui:GetChildren()) do
    if gui:IsA("ScreenGui") then
    gui.IgnoreGuiInset = true
    end
    end
  2. watches for new guis:

    childAddedConnection = playerGui.ChildAdded:Connect(function(gui)
    if gui:IsA("ScreenGui") then
    gui.IgnoreGuiInset = true
    end
    end)

any gui created after enable automatically gets fullscreen.

on disable

  1. restores all guis:

    for _, gui in ipairs(playerGui:GetChildren()) do
    if gui:IsA("ScreenGui") then
    gui.IgnoreGuiInset = false
    end
    end
  2. disconnects listener:

    • stops watching for new guis
    • cleans up connection

use cases

edge-to-edge screenshots

capture without the top bar gap.

fullscreen recordings

record with gui covering entire screen.

professional look

cleaner, more polished appearance.

technical details

screengui only

only affects screengui instances:

  • billboardguis not affected
  • surfaceguis not affected
  • only screen-space 2d ui

persistent effect

once set, ignoreguiinset persists on the gui until changed. disabling lcs restores original state.

event handling

childadded listener ensures:

  • loading screens get fullscreen
  • dynamic ui gets fullscreen
  • any new gui gets fullscreen

limitations

doesn't hide roblox top bar

this feature makes YOUR guis fullscreen. roblox's own top bar is still there unless hidden by freecam.

some guis might look wrong

guis designed with inset in mind might:

  • have content hidden by top bar
  • need repositioning for fullscreen
  • have layout issues

source code

location: features/ignoreGuiInset.lua

components:

  • initial application loop
  • childadded listener
  • connection tracking
  • cleanup on disable

troubleshooting

guis still have gap

  • might not be screenguis
  • check if feature is enabled
  • some games override this property

content hidden by top bar

  • some guis positioned assuming inset
  • this is expected behavior
  • toggle off if problematic

doesn't affect my ui

  • check if your ui is a screengui
  • verify lcs is active
  • check console for errors