AZ XP System 1.0.1 includes QBCore and ESX code paths, persistent XP and circular or rectangular displays. Framework selection is explicit through Config.Framework, not automatic detection. The supplied manifest still requires qb-core and comments out es_extended, so changing the configuration alone does not prepare an ESX installation.
Match framework, manifest and database
Keep the azs-xpsystem folder containing fxmanifest.lua, client, server and html. Start oxmysql and the selected framework first. For ESX, adapt the manifest dependency to match Config.Framework before ensure azs-xpsystem. The resource creates player_xp using citizenid for QBCore or identifier for ESX. Back up existing XP data; CREATE TABLE IF NOT EXISTS does not migrate a table from the other framework.
Actual config.lua defaults are BaseXPPerLevel=1000, XPMultiplier=1.15, MaxLevel=100 and UIStyle=rectangular. The README example has different values. F5 is the default binding for /togglexp, and ShowTime=4000 controls the temporary display. Use the installed configuration when balancing progression.
Keep progression authoritative
Server exports include AddXP, AddLevel and GetPlayerXPData. Client exports can request grants too, and an unrestricted /addxp test command is included. Their network handlers accept client amounts without authorization or numeric bounds. Remove or restrict the test path and award progression from trusted server gameplay with validated amounts.
AddLevel changes level and resets current_xp but does not update total_xp. Loading XP later recalculates inconsistent level data from total_xp, so a direct level change may be reversed. Make those values consistent and test a grant followed by reopening the UI and reconnecting.
Database saves are asynchronous without a checked completion result, and UI requests reload data from the database. Test save failures and overlapping grants instead of treating a displayed notification as proof of persistence. At MaxLevel, AddXP can continue accumulating current_xp; define the desired cap behavior and check both display styles.
Reviewed on 11 September 2026 at revision 9d53320f9199ba84199f78c81beaa63e23997335. Lua, configuration, manifest, both SQL examples and NUI HTML/JavaScript were read. No XP grant, level change, game UI or database migration was executed.