fx_version 'cerulean' game 'gta5' author 'Jit' description 'Skills system with configurable XP, levels and effects (qb-core / esx / standalone)' version '1.0.0' shared_script 'config.lua' server_scripts { 'server/db.lua', 'server/skills.lua', 'server/main.lua' } client_scripts { 'client/main.lua' } -- Optional dependency (used by many QB/ESX setups) dependency 'qb-core' Config = {} -- General Settings Config.Framework = 'qb-core' -- 'qb-core', 'esx', or 'standalone' Config.UseOxMySQL = true -- Set to false if using ghmattimysql Config.EnableDebug = false -- Enable debug prints -- UI Settings Config.OpenCommand = 'skills' -- Command to open skills menu Config.OpenKey = 'F7' -- Key to open skills menu (set to false to disable) Config.UseKeyMapping = true -- Enable key mapping -- Experience Settings Config.EnableXPGain = true -- Enable automatic XP gain Config.XPMultiplier = 1.0 -- Global XP multiplier Config.MaxLevel = 100 -- Maximum level for skills Config.ShowLevelUpNotification = true -- Show notification when leveling up Config.ShowXPNotification = false -- Show notification for XP gains -- Database Settings Config.SaveInterval = 300000 -- Save skills to database every 5 minutes (milliseconds) Config.AutoSave = true -- Enable auto-save -- Skills Configuration Config.Skills = { ['stamina'] = { name = 'Stamina', icon = 'fas fa-running', description = 'Increases running speed and endurance. Higher stamina allows you to run faster and for longer periods without getting tired.', enabled = true, startValue = 0, maxValue = 10000, activities = { running = { xp = 1, interval = 5000 }, -- XP per interval while running swimming = { xp = 2, interval = 5000 }, cycling = { xp = 1, interval = 3000 } }, effects = { [10] = { type = 'stamina_regen', value = 1.1 }, -- 10% faster stamina regen at level 10 [25] = { type = 'run_speed', value = 1.05 }, -- 5% faster running at level 25 [50] = { type = 'stamina_regen', value = 1.25 }, [75] = { type = 'run_speed', value = 1.1 }, [100] = { type = 'stamina_regen', value = 1.5, run_speed = 1.2 } } }, ['strength'] = { name = 'Strength', icon = 'fas fa-dumbbell', description = 'Increases melee damage and carrying capacity. Higher strength makes your punches more powerful and allows you to carry more items.', enabled = true, startValue = 0, maxValue = 10000, activities = { melee_combat = { xp = 5, interval = 1000 }, gym_workout = { xp = 3, interval = 2000 }, carrying_heavy = { xp = 1, interval = 10000 } }, effects = { [10] = { type = 'melee_damage', value = 1.1 }, [25] = { type = 'carry_weight', value = 1.1 }, [50] = { type = 'melee_damage', value = 1.25 }, [75] = { type = 'carry_weight', value = 1.25 }, [100] = { type = 'melee_damage', value = 1.5, carry_weight = 1.5 } } }, ['shooting'] = { name = 'Shooting', icon = 'fas fa-crosshairs', description = 'Improves weapon accuracy and reduces recoil. Higher shooting skill makes you more accurate with firearms and reduces weapon sway.', enabled = true, startValue = 0, maxValue = 10000, activities = { shooting_range = { xp = 2, interval = 1000 }, combat_shooting = { xp = 3, interval = 1000 }, headshot = { xp = 10, interval = 0 } -- Instant XP for headshots }, effects = { [10] = { type = 'weapon_accuracy', value = 1.05 }, [25] = { type = 'recoil_reduction', value = 0.9 }, [50] = { type = 'weapon_accuracy', value = 1.1 }, [75] = { type = 'recoil_reduction', value = 0.75 }, [100] = { type = 'weapon_accuracy', value = 1.2, recoil_reduction = 0.5 } } }, ['driving'] = { name = 'Driving', icon = 'fas fa-car', description = 'Improves vehicle handling and reduces crash damage. Higher driving skill makes vehicles more responsive and safer to drive.', enabled = true, startValue = 0, maxValue = 10000, activities = { driving = { xp = 1, interval = 10000 }, racing = { xp = 2, interval = 5000 }, perfect_parking = { xp = 5, interval = 0 } }, effects = { [10] = { type = 'vehicle_handling', value = 1.05 }, [25] = { type = 'crash_damage', value = 0.9 }, [50] = { type = 'vehicle_handling', value = 1.1 }, [75] = { type = 'crash_damage', value = 0.75 }, [100] = { type = 'vehicle_handling', value = 1.2, crash_damage = 0.5 } } }, ['flying'] = { name = 'Flying', icon = 'fas fa-plane', description = 'Improves aircraft control and reduces turbulence effects. Higher flying skill makes piloting smoother and more precise.', enabled = true, startValue = 0, maxValue = 10000, activities = { flying = { xp = 2, interval = 8000 }, helicopter_flying = { xp = 3, interval = 6000 }, aerobatics = { xp = 5, interval = 5000 } }, effects = { [10] = { type = 'aircraft_handling', value = 1.05 }, [25] = { type = 'turbulence_resistance', value = 1.1 }, [50] = { type = 'aircraft_handling', value = 1.15 }, [75] = { type = 'turbulence_resistance', value = 1.25 }, [100] = { type = 'aircraft_handling', value = 1.3, turbulence_resistance = 1.5 } } }, ['stealth'] = { name = 'Stealth', icon = 'fas fa-user-ninja', description = 'Reduces detection radius and footstep noise. Higher stealth allows you to move more quietly and remain undetected longer.', enabled = true, startValue = 0, maxValue = 10000, activities = { sneaking = { xp = 2, interval = 5000 }, stealth_takedown = { xp = 10, interval = 0 }, lockpicking = { xp = 3, interval = 0 } }, effects = { [10] = { type = 'detection_radius', value = 0.9 }, [25] = { type = 'footstep_noise', value = 0.8 }, [50] = { type = 'detection_radius', value = 0.75 }, [75] = { type = 'footstep_noise', value = 0.6 }, [100] = { type = 'detection_radius', value = 0.5, footstep_noise = 0.3 } } }, ['lung_capacity'] = { name = 'Lung Capacity', icon = 'fas fa-lungs', description = 'Increases underwater breathing time and swimming speed. Higher lung capacity allows you to stay underwater longer.', enabled = true, startValue = 0, maxValue = 10000, activities = { swimming = { xp = 2, interval = 3000 }, diving = { xp = 3, interval = 2000 }, underwater_activity = { xp = 4, interval = 1000 } }, effects = { [10] = { type = 'underwater_time', value = 1.1 }, [25] = { type = 'swim_speed', value = 1.05 }, [50] = { type = 'underwater_time', value = 1.25 }, [75] = { type = 'swim_speed', value = 1.15 }, [100] = { type = 'underwater_time', value = 1.5, swim_speed = 1.3 } } }, ['mechanic'] = { name = 'Mechanic', icon = 'fas fa-wrench', description = 'Improves vehicle repair speed and effectiveness. Higher mechanic skill allows you to fix vehicles faster and more efficiently.', enabled = true, startValue = 0, maxValue = 10000, activities = { repairing_vehicle = { xp = 5, interval = 1000 }, engine_work = { xp = 8, interval = 2000 }, tuning_vehicle = { xp = 3, interval = 5000 } }, effects = { [10] = { type = 'repair_speed', value = 1.1 }, [25] = { type = 'repair_effectiveness', value = 1.1 }, [50] = { type = 'repair_speed', value = 1.25 }, [75] = { type = 'repair_effectiveness', value = 1.25 }, [100] = { type = 'repair_speed', value = 1.5, repair_effectiveness = 1.5 } } }, ['hacking'] = { name = 'Hacking', icon = 'fas fa-laptop-code', description = 'Reduces hacking time and improves success rates. Higher hacking skill makes computer-based activities easier and faster.', enabled = true, startValue = 0, maxValue = 10000, activities = { hacking_attempt = { xp = 10, interval = 0 }, successful_hack = { xp = 25, interval = 0 }, advanced_hack = { xp = 50, interval = 0 } }, effects = { [10] = { type = 'hack_speed', value = 1.1 }, [25] = { type = 'hack_success_rate', value = 1.05 }, [50] = { type = 'hack_speed', value = 1.25 }, [75] = { type = 'hack_success_rate', value = 1.15 }, [100] = { type = 'hack_speed', value = 1.5, hack_success_rate = 1.3 } } }, ['lockpicking'] = { name = 'Lockpicking', icon = 'fas fa-key', description = 'Improves lockpicking success rate and speed. Higher lockpicking skill makes opening locks easier and faster.', enabled = true, startValue = 0, maxValue = 10000, activities = { lockpick_attempt = { xp = 5, interval = 0 }, successful_lockpick = { xp = 15, interval = 0 }, advanced_lock = { xp = 30, interval = 0 } }, effects = { [10] = { type = 'lockpick_speed', value = 1.1 }, [25] = { type = 'lockpick_success_rate', value = 1.1 }, [50] = { type = 'lockpick_speed', value = 1.25 }, [75] = { type = 'lockpick_success_rate', value = 1.25 }, [100] = { type = 'lockpick_speed', value = 1.5, lockpick_success_rate = 1.5 } } }, ['fishing'] = { name = 'Fishing', icon = 'fas fa-fish', description = 'Increases catch rate and reduces fishing time. Higher fishing skill improves your chances of catching fish and rare items.', enabled = true, startValue = 0, maxValue = 10000, activities = { fishing = { xp = 3, interval = 10000 }, catch_fish = { xp = 10, interval = 0 }, rare_catch = { xp = 50, interval = 0 } }, effects = { [10] = { type = 'catch_rate', value = 1.1 }, [25] = { type = 'fishing_speed', value = 1.1 }, [50] = { type = 'catch_rate', value = 1.25 }, [75] = { type = 'rare_catch_chance', value = 1.5 }, [100] = { type = 'catch_rate', value = 1.5, rare_catch_chance = 2.0 } } }, ['mining'] = { name = 'Mining', icon = 'fas fa-pickaxe', description = 'Increases mining speed and rare material chance. Higher mining skill allows you to extract resources more efficiently.', enabled = true, startValue = 0, maxValue = 10000, activities = { mining = { xp = 2, interval = 8000 }, successful_mine = { xp = 8, interval = 0 }, rare_material = { xp = 25, interval = 0 } }, effects = { [10] = { type = 'mining_speed', value = 1.1 }, [25] = { type = 'resource_yield', value = 1.1 }, [50] = { type = 'mining_speed', value = 1.25 }, [75] = { type = 'rare_material_chance', value = 1.5 }, [100] = { type = 'mining_speed', value = 1.5, rare_material_chance = 2.0 } } } } -- Webhook Settings (optional) Config.Webhook = { enabled = false, url = '', title = 'Skills System', color = 65535 -- Cyan color } -- Language Settings Config.Locale = 'en' Config.Locales = { ['en'] = { ['skills_menu'] = 'Skills Menu', ['level_up'] = 'Level Up!', ['skill_leveled_up'] = 'Your %s skill has reached level %s!', ['xp_gained'] = '+%s XP in %s', ['command_skills'] = 'Open the skills menu', ['no_permission'] = 'You do not have permission to use this command', ['skills_saved'] = 'Skills have been saved successfully', ['skills_loaded'] = 'Skills have been loaded successfully', ['skill_not_found'] = 'Skill "%s" not found', ['invalid_amount'] = 'Invalid XP amount', ['player_not_found'] = 'Player not found' }, ['sv'] = { ['skills_menu'] = 'Färdighetsmenyn', ['level_up'] = 'Nivå upp!', ['skill_leveled_up'] = 'Din %s färdighet har nått nivå %s!', ['xp_gained'] = '+%s XP i %s', ['command_skills'] = 'Öppna färdighetsmenyn', ['no_permission'] = 'Du har inte behörighet att använda detta kommando', ['skills_saved'] = 'Färdigheter har sparats framgångsrikt', ['skills_loaded'] = 'Färdigheter har laddats framgångsrikt', ['skill_not_found'] = 'Färdighet "%s" hittades inte', ['invalid_amount'] = 'Ogiltigt XP-belopp', ['player_not_found'] = 'Spelare hittades inte' } } return Config -- Simple DB wrapper: supports oxmysql or ghmattimysql (event) local Config = Config local function debugPrint(...) if Config.EnableDebug then print('[skills-db]', ...) end end local function savePlayerSkills(identifier, skills) if not identifier then return end local encoded = json.encode(skills) if Config.UseOxMySQL then -- Upsert pattern (adjust table/schema to your DB) exports.oxmysql:execute( "INSERT INTO skills_data (`identifier`, `data`) VALUES (@id, @data) ON DUPLICATE KEY UPDATE `data` = @data", { ['@id'] = identifier, ['@data'] = encoded }, function(rows) debugPrint('saved skills for', identifier) end ) else -- ghmattimysql TriggerEvent('ghmattimysql:execute', "INSERT INTO skills_data (`identifier`, `data`) VALUES (@id, @data) ON DUPLICATE KEY UPDATE `data` = @data", { ['@id'] = identifier, ['@data'] = encoded }, function(rows) debugPrint('saved skills for', identifier) end ) end end local function loadPlayerSkills(identifier, cb) if not identifier then cb(nil) return end if Config.UseOxMySQL then exports.oxmysql:execute("SELECT data FROM skills_data WHERE identifier = @id", { ['@id'] = identifier }, function(result) if result and result[1] and result[1].data then local ok, data = pcall(json.decode, result[1].data) if ok then cb(data) return end end cb(nil) end) else TriggerEvent('ghmattimysql:execute', "SELECT data FROM skills_data WHERE identifier = @id", { ['@id'] = identifier }, function(result) if result and result[1] and result[1].data then local ok, data = pcall(json.decode, result[1].data) if ok then cb(data) return end end cb(nil) end) end end return { save = savePlayerSkills, load = loadPlayerSkills } local Config = Config local db = require('server.db') or {} -- fallback in case require isn't used; resource load order uses shared config -- In-memory store: playersSkills[source] = { skillKey = xp, ... } local playersSkills = {} local function debug(...) if Config.EnableDebug then print('[skills]', ...) end end local function initDefaultSkills() local t = {} for k, v in pairs(Config.Skills) do t[k] = v.startValue or 0 end return t end local function getPlayerIdentifier(src) local identifiers = GetPlayerIdentifiers(src) return identifiers and identifiers[1] or nil end local function getSkillMaxValue(skillKey) local s = Config.Skills[skillKey] return s and s.maxValue or 10000 end local function calculateLevel(skillKey, xp) local max = getSkillMaxValue(skillKey) if max <= 0 then return 1 end local ratio = math.max(0, math.min(1, xp / max)) local level = math.floor(ratio * Config.MaxLevel) if level < 1 then level = 1 end if level > Config.MaxLevel then level = Config.MaxLevel end return level end local function applyEffects(src, skillKey, level) -- Placeholder: apply effects server-side or notify client to apply them TriggerClientEvent('skills:applyEffects', src, skillKey, level, Config.Skills[skillKey] and Config.Skills[skillKey].effects) end local function ensurePlayerSkills(src) if playersSkills[src] then return playersSkills[src] end playersSkills[src] = initDefaultSkills() return playersSkills[src] end local function loadPlayer(src) local id = getPlayerIdentifier(src) if not id then return end db.load(id, function(data) if data then playersSkills[src] = data TriggerClientEvent('skills:loaded', src, data) debug('loaded skills for', id) else playersSkills[src] = initDefaultSkills() TriggerClientEvent('skills:loaded', src, playersSkills[src]) debug('initialized default skills for', id) end end) end local function savePlayer(src) local id = getPlayerIdentifier(src) if not id then return end local skills = playersSkills[src] or initDefaultSkills() db.save(id, skills) TriggerClientEvent('skills:saved', src) debug('saved for', id) end local function addXP(src, skillKey, amount) if not src or not skillKey or amount == nil then return false, 'invalid' end if not Config.Skills[skillKey] then return false, 'not_found' end local skills = ensurePlayerSkills(src) skills[skillKey] = (skills[skillKey] or 0) + (amount * Config.XPMultiplier) local newXP = skills[skillKey] local level = calculateLevel(skillKey, newXP) TriggerClientEvent('skills:xpGained', src, skillKey, amount) applyEffects(src, skillKey, level) return true, { xp = newXP, level = level } end -- Auto-save loop CreateThread(function() while true do if Config.AutoSave then Wait(Config.SaveInterval) for src, _ in pairs(playersSkills) do savePlayer(src) end else Wait(60000) end end end) -- Public API return { loadPlayer = loadPlayer, savePlayer = savePlayer, addXP = addXP, getSkills = function(src) return playersSkills[src] or initDefaultSkills() end, setSkills = function(src, t) playersSkills[src] = t end } local Config = Config local skillModule = require('server.skills') or {} -- fallback if require missing -- When player loads in AddEventHandler('playerConnecting', function(name, setKickReason, deferrals) local src = source -- nothing synchronous here; loading will occur on spawn end) AddEventHandler('playerSpawned', function() local src = source -- Delay slightly to ensure identifiers are available CreateThread(function() Wait(1000) if skillModule and skillModule.loadPlayer then skillModule.loadPlayer(src) end end) end) -- Save on disconnect AddEventHandler('playerDropped', function(reason) local src = source if skillModule and skillModule.savePlayer then skillModule.savePlayer(src) end end) -- Command to open skills menu (client will show UI) RegisterCommand(Config.OpenCommand, function(source, args, raw) if source == 0 then return end TriggerClientEvent('skills:openMenu', source) end, false) -- Optional key mapping registration is handled client-side -- Server event to grant XP RegisterNetEvent('skills:serverAddXP', function(skillKey, amount) local src = source if not skillModule then return end if not skillKey or type(amount) ~= 'number' then return end local ok, res = skillModule.addXP(src, skillKey, amount) if ok then if Config.ShowXPNotification then TriggerClientEvent('chat:addMessage', src, { args = { string.format(Config.Locales[Config.Locale]['xp_gained'], tostring(amount), skillKey) } }) end end end) -- Admin command to save skills manually RegisterCommand('saveSkills', function(source, args, raw) if source == 0 then print('saveSkills: console invoked') return end local src = source if skillModule and skillModule.savePlayer then skillModule.savePlayer(src) TriggerClientEvent('chat:addMessage', src, { args = { Config.Locales[Config.Locale]['skills_saved'] } }) end end, false) local Config = Config local function debug(...) if Config.EnableDebug then print('[skills-client]', ...) end end -- Register command RegisterCommand(Config.OpenCommand, function() TriggerEvent('skills:openMenuClient') end, false) -- Key mapping if Config.UseKeyMapping and Config.OpenKey then RegisterKeyMapping(Config.OpenCommand, 'Open Skills Menu', 'keyboard', Config.OpenKey) end -- Events RegisterNetEvent('skills:openMenu', function() -- Placeholder UI open: send a chat message or trigger your NUI here if Config.Framework == 'qb-core' then TriggerEvent('chat:addMessage', { args = { Config.Locales[Config.Locale]['skills_menu'] } }) else print(Config.Locales[Config.Locale]['skills_menu']) end -- You can implement NUI to show full skills UI and request server data TriggerEvent('skills:openMenuClient') end) RegisterNetEvent('skills:applyEffects', function(skillKey, level, effects) -- Client should react to effects here (e.g., adjust player stats) debug('applyEffects', skillKey, level) -- Example: notify player if Config.ShowLevelUpNotification then TriggerEvent('chat:addMessage', { args = { string.format(Config.Locales[Config.Locale]['skill_leveled_up'], skillKey, tostring(level)) } }) end end) RegisterNetEvent('skills:xpGained', function(skillKey, amount) if Config.ShowXPNotification then TriggerEvent('chat:addMessage', { args = { string.format(Config.Locales[Config.Locale]['xp_gained'], tostring(amount), skillKey) } }) end end) -- Placeholder client event to open UI (implement NUI in your project) RegisterNetEvent('skills:openMenuClient', function() -- Example: print to console or use NUI print('Open Skills UI (implement NUI) - use this event to show the skills window') end) # FiveM Skills System Minimal skills system skeleton for FiveM (supports qb-core / esx / standalone). Includes: - config.lua (complete skills config and locales) - server-side DB wrapper (oxmysql / ghmattimysql placeholder) - server skill manager with auto-save - client command / key mapping to open menu (NUI not implemented) Installation: 1. Place this folder in your server resources. 2. Ensure you have a `skills_data` table in your MySQL database: CREATE TABLE `skills_data` ( `identifier` VARCHAR(64) PRIMARY KEY, `data` TEXT NOT NULL ); 3. Add `ensure your-folder-name` to server.cfg. 4. Start server. Use `/skills` or configured key to open (client-side UI must be implemented). Notes: - Implement NUI for full UI and call `TriggerServerEvent('skills:serverAddXP', skillKey, amount)` to grant XP. - Adjust DB queries to your schema and prepared statement style as needed.