MrPoulpi UI troubleshooting and FAQ

Start by setting Config.Debug = true: openings, actions and callback errors are printed in the F8 console and the server console.

“No such export … in resource mrpoulpi_ui”

• The resource is not started, or starts after the script calling it. Move ensure mrpoulpi_ui higher in server.cfg and add dependency 'mrpoulpi_ui' to your script manifest.
• The folder was renamed. It must be called mrpoulpi_ui.
• You are calling a client export from the server, or the other way round. For example, Input, Confirm and Choice only exist client side. The list is in API and hooks.

“You do not have permission” with /uimenu

• The player has neither the mrpoulpi_ui.menu ACE, nor a group from Config.Permissions.groups, nor a job from Config.Permissions.jobs.
• On Qbox and in standalone, groups are read through ACE: check add_principal identifier.license:… group.admin in server.cfg.
• To open the menu to everyone: Config.Permissions.enabled = false.

F7 does nothing

The player may have changed the key, or joined before you changed it in the config: GTA keeps their choice. They can set it in Settings → Key Bindings → FiveM. /uimenu always works.

Notifications are not above the minimap

• Check Config.Layout.notifications = 'minimap'.
• Your server uses a modified minimap (round, moved, enlarged): adjust Config.Minimap.gap, turn off matchWidth, or pick another position.
• Hidden minimap: notifications move to the bottom of the screen, as intended.

A server action never arrives

• It is not registered with RegisterServerAction and the window was not opened by the server. The log shows unknown_action.
• It comes from a window opened by the server without RegisterServerAction and the player does not have the menu permission: action_denied. Register it with RegisterServerAction.
• A client action with the same name is registered: it takes priority and the action is not sent to the server.
• The option does not have server = true.
• The player clicks too fast: one action every Config.Security.actionCooldown milliseconds.

The input does not submit

• required is true (default) and the field is empty.
• inputType = 'number' and the value is not a number.

A picture does not show

• The address does not start with https://, nui:// or assets/.
• The file is not in html/assets/, or the path does not match the case.
• The site hosting the picture blocks display from other sites. Host it somewhere else (Fivemanage, Discord, your own server) or put it in html/assets/.

The player is stuck with the cursor

A window stayed open. Escape closes it. If your script opens a window with cancel = false, always provide an option that closes it, or call CloseUI().

“Framework … unavailable, falling back to standalone”

The framework set in Config.Framework is not started or does not answer. Keep auto, or start the framework before the resource. In standalone, jobs are not available: company announcements only work for staff.