FAQ

🚀 Getting Started

What is InfinityUI?

InfinityUI is a development framework for creating advanced, customizable menus in FiveM. It's not a plug-and-play script but a tool for developers to build their own menu systems.

Is InfinityUI a complete script?

No. InfinityUI is a framework/library. You need to:

• Write your own scripts that use InfinityUI

• Or adapt existing scripts to use InfinityUI

Think of it like a toolbox for building menus.

What's included in InfinityUI?

Included:

• ✅ Core menu framework (ui.lua)

• ✅ Configuration system

• ✅ Complete documentation

• ✅ Example code snippets

NOT included:

• ❌ Job builder (shown in videos)

• ❌ Ready-made shop systems

• ❌ Complete gameplay scripts

What are the requirements?

• FiveM server (txAdmin or standalone)

• ox_lib resource (required)

• Basic Lua scripting knowledge

• FiveM Keymaster access (for escrow)

---

🔧 Installation & Setup

Where do I put the config file?

In the InfinityUI folder

infinityUI/
├── fxmanifest.lua
├── config.lua  ← Here
└── client/
    └── ui.lua

See the Installation Guide for details.

How do I know if InfinityUI is installed correctly?

Checklist:

1. Check server console for Started resource infinityUI

2. No errors in F8 console

3. Type /infinityui_jump_to in-game (should show a dialog)

"CONFIG FILE NOT FOUND" error — Solution

1. Make sure config.lua is loaded before @infinityUI/client/ui.lua in your fxmanifest.lua

2. Check that InfinityUIConfig = {} is at the top of your config file

Example:

client_scripts {
    '@infinityUI/config.lua',     -- FIRST
    '@infinityUI/client/ui.lua', -- THEN
    'client/main.lua'
}

---

💻 Development

Can I rename the InfinityUI resource?

No. The resource must be named infinityUI (case-sensitive) because other resources reference it with @infinityUI/client/ui.lua. If you rename it, you'll get No such export errors, or worse, broken functions.

How do I create my first menu?

Example:

-- Create menu
local MyMenu = InfinityUI.CreateMenu("Title", "Subtitle")

-- Add items
Citizen.CreateThread(function()
    while true do
        Wait(0)
        if InfinityUI.IsVisible(MyMenu) then
            InfinityUI.Button("Option 1", "Description", {}, true, {
                onSelected = function()
                    print("Selected!")
                end
            })
            InfinityUI.IsVisible(MyMenu)
        end
    end
end)

-- Open menu
RegisterCommand("mymenu", function()
    InfinityUI.Visible(MyMenu, true)
end)

See more in the API Reference.

Can I use InfinityUI with ESX/QBCore?

Yes. InfinityUI works with any framework (or no framework).

Configure the integration in your config:

-- ESX
InfinityUIConfig.CoreResource = "es_extended"

-- QBCore  
InfinityUIConfig.CoreResource = "qb-core"

-- No framework
InfinityUIConfig.CoreResource = "core"

See Configuration Guide.

How do I add a search feature to my menu?

Add this at the top of your menu:

InfinityUI.FilterButton("🔍 Search", "Filter items")

Then wrap your buttons:

for _, item in ipairs(items) do
    if InfinityUI.ShouldShowButton(item.name) then
        InfinityUI.Button(item.name, item.description)
    end
end

See Search System.

---

🎨 Customization

Can I change the menu colors?

Yes. Edit your config:

InfinityUIConfig.Colors = {
    Primary = { 255, 0, 0, 255 },     -- Red
    Background = { 50, 50, 50, 255 },
    -- etc...
}

See Configuration Guide.

Can I change menu sounds?

Yes.

Disable sounds:

InfinityUIConfig.EnableSounds = false

Or change sound profile:

InfinityUIConfig.AudioProfile = "NativeUI" -- or "InfinityUI"

Can players choose menu side (left/right)?

Yes. Implement GetPlayerMenuSide() in the config:

function InfinityUIConfig.GetPlayerMenuSide()
    local side = GetResourceKvpString("menu_side") or "left"
    return side
end

-- Let players toggle
RegisterCommand("togglemenu", function()
    local current = GetResourceKvpString("menu_side") or "left"
    local new = (current == "left") and "right" or "left"
    SetResourceKvp("menu_side", new)
end)

Can I translate InfinityUI to my language?

Yes. All text is in the config. Example (French):

InfinityUIConfig.JumpDialog = {
    Title = "Aller au bouton",
    Label = "Numéro du bouton (1 - %d)",
    Placeholder = ""
}

InfinityUIConfig.SearchDialog = {
    Title = "Filtrer",
    Label = "Recherche",
    Description = "Entrez un texte à rechercher",
    Placeholder = ""
}

---

🐛 Troubleshooting

My menu doesn't appear

Checklist:

• Is InfinityUI.IsVisible(Menu) in a Citizen.CreateThread?

• Did you call InfinityUI.Visible(Menu, true) to open it?

• Check F8 console for errors

• Is ox_lib installed and started?

Debug code:

print("Menu created:", MyMenu ~= nil)
print("Menu open:", InfinityUI.Visible(MyMenu, nil))

Buttons don't respond to clicks

Possible causes:

1. Enabled = false: Check the 4th parameter

InfinityUI.Button("Test", nil, {}, true, {...}) -- true = enabled

1. Missing callback: Make sure you have an onSelected function

2. Thread not running: Verify your while loop is running

"attempt to index a nil value"

Common causes:

Cause 1: Config not loaded

-- Solution: Load config BEFORE ui.lua
client_scripts {
    'infinityui_config.lua',
    '@infinityUI/client/ui.lua'
}

Cause 2: Missing config field

-- Solution: Add all required fields
InfinityUIConfig.MappingSettings = {
    Command = "infinityui_jump_to",
    Description = "Menu: Jump to a button"
}

Performance issues / FPS drops

Solutions:

1. Reduce Wait time when menu closed:

Wait(InfinityUI.Visible(Menu, nil) and 0 or 500)

1. Don't recreate menus every frame:

-- ❌ BAD - Creates menu in loop
while true do
    local Menu = InfinityUI.CreateMenu(...)
end

-- ✅ GOOD - Create once
local Menu = InfinityUI.CreateMenu(...)
while true do
    -- Use menu
end

1. Enable auto garbage collection:

InfinityUIConfig.AutoGarbageCollect = true

Sounds not working

Solutions:

1. Enable sounds

InfinityUIConfig.EnableSounds = true

1. Check PlaySound function

function InfinityUIConfig.PlaySound(audioName, audioRef)
    if InfinityUIConfig.EnableSounds then
        PlaySoundFrontend(-1, audioName, audioRef, 1)
    end
end

---

🔐 Licensing & Purchase

Is InfinityUI open source?

No. InfinityUI is delivered via FiveM Escrow (Keymaster). The code is encrypted.

Can I use InfinityUI on multiple servers?

Check your Keymaster license. Typically:

• ✅ Development server + Production server = OK

• ❌ Multiple production servers = Need multiple licenses

Can I modify InfinityUI?

Limited. You can:

• ✅ Configure all settings

• ✅ Extend functionality through your own scripts

• ❌ Modify the core ui.lua (it's encrypted)

Can I resell scripts I make with InfinityUI?

Yes — you can sell scripts that use InfinityUI, but:

• ✅ You can sell your own scripts

• ❌ You cannot resell InfinityUI itself

• ❌ Buyers need their own InfinityUI license

---

📚 Learning Resources

I'm new to Lua, where do I start?

Resources:

1. Lua Tutorial

2. FiveM Documentation

3. CFX Forums

Tips:

• Start with simple buttons and menus

• Copy and modify the examples

• Ask questions in Discord

Where can I find examples?

• API Documentation - Examples Section

• Discord #examples channel

• Community showcases

Are there video tutorials?

Coming soon! Check:

• Discord announcements

• YouTube channel (if applicable)

---

🆚 Comparison

InfinityUI vs RageUI?

Feature	RageUI	InfinityUI
Search	❌	✅
Quick Jump	❌	✅
Menu Side Toggle	❌	✅
Actively Maintained	❌	✅
Modern Features	❌	✅

InfinityUI vs CoraUI?

Feature	CoraUI	InfinityUI
Search	❌	✅
Quick Jump	❌	✅
Sound Toggle	❌	✅
Performance	⚠️	✅

InfinityUI vs NativeUI?

InfinityUI is based on NativeUI but with:

• ✅ Better performance

• ✅ More features (search, jump)

• ✅ Active development

• ✅ Better customization

---

❓ Still Have Questions?

• 📖 Check the API Reference

• 💬 Ask in Discord

• 🐛 Report bugs properly (see Support)

Can't find your answer? Join our Discord and ask the community!