FAQ

Common problems and their solutions.

---

Minigame not opening

Problem: Nothing happens when export function is called.

Solution:

1. Make sure ensure rs_minigames is in your server.cfg
2. Check if resource loaded successfully: /refresh and /restart rs_minigames
3. Check F8 console for errors

---

UI visible but not working

Problem: Minigame appears on screen but clicks/keys don’t work.

Solution: Could be NUI focus issue. In your client script:

exports['rs_minigames']:StartLockpicking('medium', function(success, cancelled)
    -- NUI focus automatically closes after callback
end)

---

Theme not applying

Problem: Changed theme in config but it looks the same.

Solution:

1. Make sure theme name is spelled correctly in config.lua
2. Available themes: default, dark, blue, purple, red, green, custom, chrome, synthnet

Config.Themes.lockpicking = "synthnet"  -- Correct
Config.Themes.lockpicking = "Synthnet"  -- Wrong (uppercase)

---

Language not changing

Problem: Set Config.Language = 'en' but still showing Turkish.

Solution:

1. Restart the server
2. Make sure locales/en.lua file exists

---

Callback not working

Problem: Callback function not called after minigame ends.

Solution: Make sure callback function is properly defined:

-- CORRECT
exports['rs_minigames']:StartLockpicking('medium', function(success, cancelled)
    if cancelled then
        print("Cancelled!")
    elseif success then
        print("Success!")
    else
        print("Failed!")
    end
end)

-- WRONG - no callback
exports['rs_minigames']:StartLockpicking('medium')

---

Difficulty level not found

Problem: Console shows “Invalid difficulty” error.

Solution: Each minigame has its own difficulty levels:

-- Lockpicking: easy, medium, hard, expert
exports['rs_minigames']:StartLockpicking('expert', callback)

-- Circuit: 1, 2, 3 (numbers)
exports['rs_minigames']:StartCircuitMinigame(2, 30, callback)

-- Most minigames: easy, medium, hard
exports['rs_minigames']:StartWordle('hard', 90, callback)

---

Where is the Bomb Defusal manual?

Problem: Can’t see the rules in bomb defusal game.

Solution: Manual opens separately:

-- Open manual for second player
exports['rs_minigames']:StartBombManual()

-- Start bomb defusal
exports['rs_minigames']:StartBombDefusal('medium', 180, callback)

---

Test commands not working

Problem: Commands like /testlockpick don’t work.

Solution: Make sure debug mode is enabled:

Config.Debug = true

Restart the server.

---

Performance issues

Problem: Minigames are laggy.

Solution:

1. Script already uses vanilla JavaScript, optimized
2. Check if other NUI scripts are conflicting
3. Take performance profile with browser devtools

---

How to add a new language?

1. Create new file in locales/ folder (e.g., locales/es.lua)

2. Copy contents of locales/en.lua

3. Translate all texts:

   Locales['es'] = {
       common = {
           success = "¡Éxito!",
           failed = "Fallido",
           -- ...
       },
       lockpicking = {
           title = "Abrir cerradura",
           -- ...
       }
   }

4. Set language in config.lua:

   Config.Language = 'es'

5. Add file to fxmanifest.lua:

   shared_scripts {
       'locales/es.lua'
   }

---

How to add custom logo?

In config.lua:

Config.GlobalTheme = {
    LogoPath = 'nui://rs_minigames/html/mylogo.png',
    -- ...
}

Place the logo file in html/ folder.

---

Support

If your issue is not resolved:

Join Discord