v3.0.1

Summary

This release adds Player ESP and NPC ESP, lets you rename a character while they are online, and lets server owners put their own information on the player profile. Staff can now pick the panel's language in game, and the panel got a round of fixes for phones.

There are no database changes. permissions.json has one new permission, self.esp.

What's New

ESP

  • Two new Quick Menu toggles: Player ESP and NPC ESP. Both can also go on your radial menu
  • Each ped gets a box, their ID and name, the distance and a health bar, plus armor when they have any. Close up, a skeleton is drawn too
  • Players are green when you have a clear line of sight, red when they are behind something and grey when dead. NPCs are blue and orange, so you can tell them apart with both toggles on
  • It works up to 400 metres and is only drawn for the staff member who turned it on
  • Both toggles need the new self.esp permission, and turning them on or off is written to the staff logs

Rename characters

  • The Name row on an online player's profile can now be edited by staff with the offline_player.update_name permission
  • The new name shows right away, and renaming someone who is logged in no longer gets undone the next time the framework saves them (ESX, QBCore, Qbox and vRP)
  • Last names with more than one word, like "Ana Van Der Berg", are now saved in full
  • Renames are written to the staff logs

Your own info on the player profile

  • Server owners can add their own facts to a player's profile with RegisterPlayerInfo in config/custom_functions/server.lua: playtime, level, VIP tier, a framework ID, anything you can look up
  • A field can go on the line under the name, in the row of tags, or in the identifiers row as a chip that copies its value
  • Each registration can name a permission, so only the staff groups you choose see those fields
  • It works in game and on the web panel. Other resources can register fields too, with exports.luxu_admin:registerPlayerInfo(name, callback, permission)
  • There is a commented example at the bottom of config/custom_functions/server.lua

Language

  • The account menu in the in-game panel now has a Language picker, the same one the web panel has. Each staff member can pick their own language or follow the server's

Phones

  • The player search opens at the top of the screen, so the on-screen keyboard no longer covers the field
  • Bans and jail sentences show the player, the reason and when it ends; tap a row for the rest and the actions
  • The sidebar has its own close button when it covers the whole screen
  • The inventory fills the drawer it opens in
  • Statistics cards and the money chart no longer squeeze their titles and labels on a narrow screen
  • Click to copy now works on iPhone and iPad

Web panel

  • On a team's settings page, Open Admin Panel now shows whether the server is online. If the panel cannot open, it tells you why: the server is offline, or your Discord account is not on its staff list with web panel access
  • Opening a team's panel is faster, and a progress bar shows while the page loads

Bug Fixes

  • Fixed long character IDs running into the money column in the Player Rich List. The full ID is still copied when you click it
  • Fixed a dialog closing by itself when you tapped inside a drawer opened from it
  • Fixed the cursor staying on screen after pressing Reload on the update notice in game
  • Fixed the hosted UI sometimes running the previous version after an update
  • Removed the minimum server build requirement from fxmanifest.lua

Before you update

  • permissions.json: add the new self.esp line shown below, then give it to the staff groups that should have ESP on the Staff page.
  • Bridge files: bridge/server/player.lua and bridge/vrp2/server.lua each got one new function for renaming a loaded character. If you changed these files, add the function from the diff below. Without it, renaming an online player is still saved to the database but the old name stays until they reconnect.
  • config/database/queries.js: changeOfflinePlayerName now keeps every word of the last name. If you changed this file, apply the diff below.
  • Translations: 8 new texts were added for ESP and the rename log. Missing texts fall back to English, so custom translations keep working.

File Changes

⚙️ Configuration & Bridge Files

These files are not encrypted. Review the changes below — you may need to manually apply updates to your server's config files.

fxmanifest.lua

 author 'luxu-gg'
 description 'Admin menu for FiveM'
-version '3.0.0'
+version '3.0.1'

 dependencies {
     'oxmysql',
-    '/server:28009'
 }

config/permissions.json

     "self.delete_vehicle": "perm_self_delete_vehicle",
     "self.entity_controls": "perm_self_entity_controls",
     "self.entity_inspector": "perm_self_entity_inspector",
+    "self.esp": "perm_self_esp",
     "self.delete_entities": "perm_self_delete_entities",
     "self.freeze": "perm_self_freeze",
     "self.give_vehicle": "perm_self_give_vehicle",

config/custom_functions/server.lua

         formatToCash = true -- if you want the value to be formatted to cash, set this to true, make the value a number
     }
 end)
+
+--- Custom Player Info: extra facts on a player's profile, in the panel and the web panel.
+--- `source` is the staff member looking (nil from the web panel), `target` the player's server ID.
+--- Return a list of fields. `section` says where each one shows:
+---   "details"     the line under the name, after server ID, bucket, ping and jobs
+---   "badges"      the row of tags under it (icon and color are optional, value too)
+---   "identifiers" the identifiers row, as a chip that copies "label:value"
+--- The callback runs each time a profile opens, so keep it fast and cache slow lookups.
+--[[
+RegisterPlayerInfo("example_player_info", function(source, target)
+    local playtime = Player(target).state.playtime or 0
+    return {
+        { section = "details", label = "Playtime", value = ("%dh"):format(playtime // 60) },
+        { section = "badges", label = "VIP", icon = "mdi:crown", color = "#f59e0b" },
+        { section = "identifiers", label = "citizenid", value = "ABC12345" },
+    }
+end, nil) -- optional permission as the third argument, e.g. "player.view_money_accounts"
+]]

config/custom_functions/types.lua

 ---@field name string
 ---@field identifiers string[]

+---@class PlayerInfoField
+---@field section? 'details' | 'badges' | 'identifiers' -- where it shows on the profile; defaults to 'details'
+---@field label string -- up to 40 characters
+---@field value? string | number | boolean -- required for 'details' and 'identifiers'; up to 120 characters
+---@field icon? string -- badges only, e.g. "mdi:crown"
+---@field color? string -- hex color, e.g. "#f59e0b"; badges and the value in 'details'
+
 ---@class Zone
 ---@field id string
 ---@field points [number, number][]
 ---@param name string
 ---@param handler fun(): ZoneHandlerReturn
 function RegisterZoneHandler(name, handler) end
+
+--- Adds extra facts to a player's profile (server.lua only). Up to 24 fields show per player.
+--- `source` is the staff member looking at the profile, or nil when they use the web panel.
+--- `target` is the server ID of the player being looked at.
+--- Defined in sv_user_addon.lua.
+---@param name string
+---@param callback fun(source: number?, target: number): PlayerInfoField[] | PlayerInfoField | nil
+---@param permission? string -- staff without it do not get these fields
+function RegisterPlayerInfo(name, callback, permission) end

config/database/queries.js

    * @returns {Promise<boolean>}
    */
   async changeOfflinePlayerName(charId, newName) {
-    const [firstname, lastname] = newName.split(' ');
+    // The first word is the first name, everything after it is the last name.
+    const [firstname, ...rest] = String(newName).trim().split(/\s+/);
+    const lastname = rest.join(' ');
     if (Framework.name === 'esx') {
       return (
         (await oxmysql.update('UPDATE users SET firstname = ?, lastname = ? WHERE identifier = ?', [
           firstname,
-          lastname ?? '',
+          lastname,
           charId,
         ])) === 1
       );
       return (
         (await oxmysql.update('UPDATE vrp_character_identities SET firstname = ?, name = ? WHERE character_id = ?', [
           firstname,
-          lastname ?? '',
+          lastname,
           charId,
         ])) === 1
       );

bridge/server/player.lua

     return "NOT FOUND"
 end

+--- Renames a loaded character in the framework's memory, so the new name shows
+--- right away and is not written back over on the next save. The database row
+--- is updated separately (changeOfflinePlayerName in config/database/queries.js).
+---@param source number
+---@param firstname string
+---@param lastname string
+---@return boolean success
+function player.setCharName(source, firstname, lastname)
+    local playerObj = player.getPlayerObject(source)
+    if not playerObj then return false end
+
+    if Framework.name == 'esx' then
+        if not playerObj.setName then return false end
+        playerObj.setName(firstname .. " " .. lastname)
+        -- esx_identity keeps the two parts as player variables.
+        if playerObj.set then
+            playerObj.set("firstName", firstname)
+            playerObj.set("lastName", lastname)
+        end
+        return true
+    elseif Framework.name == 'qb' or Framework.name == 'qbx' then
+        local charinfo = playerObj.PlayerData.charinfo
+        if not charinfo or not playerObj.Functions.SetPlayerData then return false end
+        charinfo.firstname = firstname
+        charinfo.lastname = lastname
+        playerObj.Functions.SetPlayerData('charinfo', charinfo)
+        return true
+    elseif Framework.name == 'vrp' then
+        return VRP.setCharName(source, firstname, lastname) == true
+    end
+
+    return false --[[ CUSTOM FRAMEWORK ]]
+end
+
 ---@param playerObj table
 ---@return string
 function player.getCharBirthday(playerObj)

bridge/vrp2/server.lua

     return true
 end

+--- Renames a loaded character in memory. The identity row is updated by the caller.
+function api.setCharName(source, firstname, lastname)
+    local user = getUserBySource(source)
+    if not isReady(user) then return false end
+
+    local identity = getIdentity(user.cid)
+    if not identity then return false end
+
+    identity.firstname = firstname
+    identity.name = lastname
+    return true
+end
+
 function api.revive(source)
     source = toNumber(source)
     if not source then return false end

locales/en.json

{
  "esp": "Player ESP",
  "npc_esp": "NPC ESP",
  "perm_self_esp": "ESP (see players and NPCs through walls)",
  "log_action_enabled_esp": "enabled player ESP",
  "log_action_disabled_esp": "disabled player ESP",
  "log_action_enabled_npc_esp": "enabled NPC ESP",
  "log_action_disabled_npc_esp": "disabled NPC ESP",
  "log_action_updated_character_name": "renamed character to {name}"
}

Full list of files changed

Change File
Modified bridge/server/player.lua
Modified bridge/vrp2/server.lua
Modified client/cl_main.lua
Modified client/modules/actions.lua
Added client/modules/esp.lua
Modified client/modules/gamer_tags.lua
Modified config/custom_functions/server.lua
Modified config/custom_functions/types.lua
Modified config/database/queries.js
Modified config/permissions.json
Modified fxmanifest.lua
Modified locales/en.json
Modified server/utils/sv_user_addon.lua
Modified server/index.js
Modified web/