fx_version 'cerulean' game 'gta5' author 'Darklosko' description 'Comprehensive Faction Management System for ESX' version '1.0.0' lua54 'yes' shared_scripts { 'config.lua', '@ox_lib/init.lua' } client_scripts { 'client.lua' } server_scripts { '@oxmysql/lib/MySQL.lua', 'server.lua' } dependencies { 'es_extended', 'ox_lib' } local Config = {} Config.AdminGroups = { 'admin', 'leadadmin', 'management' } Config.Ranks = { 'Leader', 'High Council', 'Big Homies', 'Members' } Config.FactionChatColor = '^4' -- Blue color for faction chat Config.MaxFactions = 50 -- Maximum number of factions allowed Config.MaxMembersPerFaction = 30 -- Maximum members per faction Config.KickCooldown = 60 -- Seconds before a kicked player can rejoin any faction return Config ESX = exports["es_extended"]:getSharedObject() local Config = exports[GetCurrentResourceName()]:getConfig() -- Faction chat command RegisterCommand('fchat', function(source, args) local message = table.concat(args, ' ') if message == '' then return end TriggerServerEvent('factions:sendFactionChat', message) end, false) -- Check current faction command RegisterCommand('f', function() TriggerServerEvent('factions:checkCurrentFaction') end, false) -- Manage faction command (for leaders) RegisterCommand('managefaction', function() TriggerServerEvent('factions:requestManageFaction') end, false) -- Admin faction management command RegisterCommand('factionmanagement', function() local playerGroup = ESX.GetPlayerData().group if not Config.AdminGroups[playerGroup] then return end TriggerServerEvent('factions:requestFactionManagement') end, false) -- Handle faction chat messages RegisterNetEvent('factions:receiveFactionChat') AddEventHandler('factions:receiveFactionChat', function(senderName, senderId, message) local formattedMessage = string.format('%s%s [%d]: %s', Config.FactionChatColor, senderName, senderId, message) TriggerEvent('chat:addMessage', { color = {0, 0, 255}, multiline = true, args = {formattedMessage} }) end) -- Handle faction notifications RegisterNetEvent('factions:notify') AddEventHandler('factions:notify', function(message, type) lib.notify({ title = 'Faction System', description = message, type = type or 'inform' }) end) ESX = exports["es_extended"]:getSharedObject() local Config = exports[GetCurrentResourceName()]:getConfig() -- Initialize database tables CreateThread(function() MySQL.ready(function() MySQL.query([[ CREATE TABLE IF NOT EXISTS factions ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255) NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, kills INT DEFAULT 0, UNIQUE KEY (name) ) ]]) MySQL.query([[ CREATE TABLE IF NOT EXISTS faction_members ( id INT AUTO_INCREMENT PRIMARY KEY, faction_id INT NOT NULL, identifier VARCHAR(255) NOT NULL, rank VARCHAR(50) NOT NULL DEFAULT 'Members', kills INT DEFAULT 0, last_kick TIMESTAMP NULL, FOREIGN KEY (faction_id) REFERENCES factions(id) ON DELETE CASCADE, UNIQUE KEY (faction_id, identifier) ) ]]) end) end) -- Get player's current faction ESX.RegisterServerCallback('factions:getPlayerFaction', function(source, cb) local xPlayer = ESX.GetPlayerFromId(source) local result = MySQL.query.await('SELECT f.name, fm.rank FROM faction_members fm JOIN factions f ON fm.faction_id = f.id WHERE fm.identifier = ?', {xPlayer.identifier}) if result and #result > 0 then cb(result[1]) else cb(nil) end end) -- Get all factions for admin management ESX.RegisterServerCallback('factions:getAllFactions', function(source, cb) local xPlayer = ESX.GetPlayerFromId(source) if not Config.AdminGroups[xPlayer.getGroup()] then return cb(nil) end local factions = MySQL.query.await('SELECT * FROM factions') for _, faction in ipairs(factions) do faction.memberCount = MySQL.scalar.await('SELECT COUNT(*) FROM faction_members WHERE faction_id = ?', {faction.id}) end cb(factions) end) -- Get faction members for management ESX.RegisterServerCallback('factions:getFactionMembers', function(source, cb, factionId) local xPlayer = ESX.GetPlayerFromId(source) local result = MySQL.query.await('SELECT * FROM faction_members WHERE faction_id = ?', {factionId}) local members = {} for _, member in ipairs(result) do local player = ESX.GetPlayerFromIdentifier(member.identifier) if player then member.name = player.getName() member.source = player.source else member.name = 'Offline' member.source = nil end table.insert(members, member) end cb(members) end) -- Create new faction RegisterNetEvent('factions:createFaction') AddEventHandler('factions:createFaction', function(factionName) local xPlayer = ESX.GetPlayerFromId(source) if not Config.AdminGroups[xPlayer.getGroup()] then return end local existing = MySQL.scalar.await('SELECT COUNT(*) FROM factions WHERE name = ?', {factionName}) if existing > 0 then TriggerClientEvent('factions:notify', source, 'A faction with this name already exists!', 'error') return end MySQL.insert.await('INSERT INTO factions (name) VALUES (?)', {factionName}) TriggerClientEvent('factions:notify', source, string.format('Faction %s created successfully!', factionName), 'success') end) -- Delete faction RegisterNetEvent('factions:deleteFaction') AddEventHandler('factions:deleteFaction', function(factionId) local xPlayer = ESX.GetPlayerFromId(source) if not Config.AdminGroups[xPlayer.getGroup()] then return end MySQL.query.await('DELETE FROM factions WHERE id = ?', {factionId}) TriggerClientEvent('factions:notify', source, 'Faction deleted successfully!', 'success') end) -- Invite player to faction RegisterNetEvent('factions:invitePlayer') AddEventHandler('factions:invitePlayer', function(factionId, targetId) local xPlayer = ESX.GetPlayerFromId(source) local xTarget = ESX.GetPlayerFromId(targetId) if not xTarget then TriggerClientEvent('factions:notify', source, 'Player not found!', 'error') return end -- Check if admin or faction leader local isAdmin = Config.AdminGroups[xPlayer.getGroup()] local isLeader = false if not isAdmin then local result = MySQL.query.await('SELECT rank FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xPlayer.identifier}) isLeader = result and #result > 0 and result[1].rank == 'Leader' end if not isAdmin and not isLeader then TriggerClientEvent('factions:notify', source, 'You do not have permission to invite players!', 'error') return end -- Check if player is already in a faction local inFaction = MySQL.scalar.await('SELECT COUNT(*) FROM faction_members WHERE identifier = ?', {xTarget.identifier}) if inFaction > 0 then TriggerClientEvent('factions:notify', source, 'Player is already in a faction!', 'error') return end -- Check kick cooldown local lastKick = MySQL.scalar.await('SELECT last_kick FROM faction_members WHERE identifier = ? ORDER BY last_kick DESC LIMIT 1', {xTarget.identifier}) if lastKick and os.difftime(os.time(), lastKick) < Config.KickCooldown then TriggerClientEvent('factions:notify', source, 'Player was recently kicked and cannot join a new faction yet!', 'error') return end -- Check faction member limit local memberCount = MySQL.scalar.await('SELECT COUNT(*) FROM faction_members WHERE faction_id = ?', {factionId}) if memberCount >= Config.MaxMembersPerFaction then TriggerClientEvent('factions:notify', source, 'Faction has reached maximum member limit!', 'error') return end -- Add player to faction MySQL.insert.await('INSERT INTO faction_members (faction_id, identifier, rank) VALUES (?, ?, ?)', {factionId, xTarget.identifier, 'Members'}) TriggerClientEvent('factions:notify', source, string.format('Successfully invited %s to the faction!', xTarget.getName()), 'success') TriggerClientEvent('factions:notify', targetId, string.format('You have been invited to faction ID %d!', factionId), 'success') end) -- Kick member from faction RegisterNetEvent('factions:kickMember') AddEventHandler('factions:kickMember', function(factionId, memberId) local xPlayer = ESX.GetPlayerFromId(source) local xTarget = ESX.GetPlayerFromId(memberId) if not xTarget then TriggerClientEvent('factions:notify', source, 'Player not found!', 'error') return end -- Check if admin or faction leader local isAdmin = Config.AdminGroups[xPlayer.getGroup()] local isLeader = false if not isAdmin then local result = MySQL.query.await('SELECT rank FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xPlayer.identifier}) isLeader = result and #result > 0 and result[1].rank == 'Leader' end if not isAdmin and not isLeader then TriggerClientEvent('factions:notify', source, 'You do not have permission to kick members!', 'error') return end -- Check if target is in the faction local inFaction = MySQL.scalar.await('SELECT COUNT(*) FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xTarget.identifier}) if inFaction == 0 then TriggerClientEvent('factions:notify', source, 'Player is not in this faction!', 'error') return end -- Remove player from faction MySQL.query.await('DELETE FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xTarget.identifier}) MySQL.query.await('UPDATE faction_members SET last_kick = CURRENT_TIMESTAMP WHERE identifier = ?', {xTarget.identifier}) TriggerClientEvent('factions:notify', source, string.format('Successfully kicked %s from the faction!', xTarget.getName()), 'success') TriggerClientEvent('factions:notify', memberId, 'You have been kicked from your faction!', 'error') end) -- Change member rank RegisterNetEvent('factions:changeRank') AddEventHandler('factions:changeRank', function(factionId, memberId, newRank) local xPlayer = ESX.GetPlayerFromId(source) local xTarget = ESX.GetPlayerFromId(memberId) if not xTarget then TriggerClientEvent('factions:notify', source, 'Player not found!', 'error') return end -- Check if admin or faction leader local isAdmin = Config.AdminGroups[xPlayer.getGroup()] local isLeader = false if not isAdmin then local result = MySQL.query.await('SELECT rank FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xPlayer.identifier}) isLeader = result and #result > 0 and result[1].rank == 'Leader' end if not isAdmin and not isLeader then TriggerClientEvent('factions:notify', source, 'You do not have permission to change ranks!', 'error') return end -- Check if target is in the faction local inFaction = MySQL.scalar.await('SELECT COUNT(*) FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xTarget.identifier}) if inFaction == 0 then TriggerClientEvent('factions:notify', source, 'Player is not in this faction!', 'error') return end -- Validate new rank local validRank = false for _, rank in ipairs(Config.Ranks) do if rank == newRank then validRank = true break end end if not validRank then TriggerClientEvent('factions:notify', source, 'Invalid rank specified!', 'error') return end -- Change rank MySQL.query.await('UPDATE faction_members SET rank = ? WHERE faction_id = ? AND identifier = ?', {newRank, factionId, xTarget.identifier}) TriggerClientEvent('factions:notify', source, string.format('Changed %s rank to %s!', xTarget.getName(), newRank), 'success') TriggerClientEvent('factions:notify', memberId, string.format('Your rank has been changed to %s!', newRank), 'success') end) -- Handle faction chat RegisterNetEvent('factions:sendFactionChat') AddEventHandler('factions:sendFactionChat', function(message) local xPlayer = ESX.GetPlayerFromId(source) local result = MySQL.query.await('SELECT f.id, fm.rank FROM faction_members fm JOIN factions f ON fm.faction_id = f.id WHERE fm.identifier = ?', {xPlayer.identifier}) if not result or #result == 0 then TriggerClientEvent('factions:notify', source, 'You are not in a faction!', 'error') return end local factionId = result[1].id local members = MySQL.query.await('SELECT identifier FROM faction_members WHERE faction_id = ?', {factionId}) for _, member in ipairs(members) do local player = ESX.GetPlayerFromIdentifier(member.identifier) if player then TriggerClientEvent('factions:receiveFactionChat', player.source, xPlayer.getName(), xPlayer.source, message) end end end) -- Check current faction RegisterNetEvent('factions:checkCurrentFaction') AddEventHandler('factions:checkCurrentFaction', function() local xPlayer = ESX.GetPlayerFromId(source) local result = MySQL.query.await('SELECT f.name, fm.rank FROM faction_members fm JOIN factions f ON fm.faction_id = f.id WHERE fm.identifier = ?', {xPlayer.identifier}) if result and #result > 0 then TriggerClientEvent('factions:notify', source, string.format('You are in faction %s as a %s', result[1].name, result[1].rank), 'success') else TriggerClientEvent('factions:notify', source, 'You are not in any faction!', 'error') end end) -- Request manage faction UI (for leaders) RegisterNetEvent('factions:requestManageFaction') AddEventHandler('factions:requestManageFaction', function() local xPlayer = ESX.GetPlayerFromId(source) local result = MySQL.query.await('SELECT f.id, fm.rank FROM faction_members fm JOIN factions f ON fm.faction_id = f.id WHERE fm.identifier = ?', {xPlayer.identifier}) if not result or #result == 0 then TriggerClientEvent('factions:notify', source, 'You are not in a faction!', 'error') return end if result[1].rank ~= 'Leader' then TriggerClientEvent('factions:notify', source, 'Only faction leaders can manage the faction!', 'error') return end TriggerClientEvent('factions:showManageFaction', source, result[1].id) end) -- Request faction management UI (for admins) RegisterNetEvent('factions:requestFactionManagement') AddEventHandler('factions:requestFactionManagement', function() local xPlayer = ESX.GetPlayerFromId(source) if not Config.AdminGroups[xPlayer.getGroup()] then TriggerClientEvent('factions:notify', source, 'You do not have permission to manage factions!', 'error') return end TriggerClientEvent('factions:showFactionManagement', source) end) -- Track kills RegisterNetEvent('factions:trackKill') AddEventHandler('factions:trackKill', function(victimId) local xPlayer = ESX.GetPlayerFromId(source) local xVictim = ESX.GetPlayerFromId(victimId) if not xVictim then return end -- Get killer's faction local killerFaction = MySQL.query.await('SELECT f.id, fm.rank FROM faction_members fm JOIN factions f ON fm.faction_id = f.id WHERE fm.identifier = ?', {xPlayer.identifier}) if not killerFaction or #killerFaction == 0 then return end -- Get victim's faction local victimFaction = MySQL.query.await('SELECT f.id, fm.rank FROM faction_members fm JOIN factions f ON fm.faction_id = f.id WHERE fm.identifier = ?', {xVictim.identifier}) if not victimFaction or #victimFaction == 0 then return end -- Update faction kills MySQL.query.await('UPDATE factions SET kills = kills + 1 WHERE id = ?', {killerFaction[1].id}) MySQL.query.await('UPDATE faction_members SET kills = kills + 1 WHERE faction_id = ? AND identifier = ?', {killerFaction[1].id, xPlayer.identifier}) end) -- Remove kills (for faction leaders) RegisterNetEvent('factions:removeKills') AddEventHandler('factions:removeKills', function(factionId, memberId, amount) local xPlayer = ESX.GetPlayerFromId(source) -- Check if admin or faction leader local isAdmin = Config.AdminGroups[xPlayer.getGroup()] local isLeader = false if not isAdmin then local result = MySQL.query.await('SELECT rank FROM faction_members WHERE faction_id = ? AND identifier = ?', {factionId, xPlayer.identifier}) isLeader = result and #result > 0 and result[1].rank == 'Leader' end if not isAdmin and not isLeader then TriggerClientEvent('factions:notify', source, 'You do not have permission to remove kills!', 'error') return end -- Remove faction kills if not memberId then MySQL.query.await('UPDATE factions SET kills = GREATEST(0, kills - ?) WHERE id = ?', {amount, factionId}) TriggerClientEvent('factions:notify', source, string.format('Removed %d kills from faction!', amount), 'success') return end -- Remove member kills MySQL.query.await('UPDATE faction_members SET kills = GREATEST(0, kills - ?) WHERE faction_id = ? AND identifier = ?', {amount, factionId, memberId}) TriggerClientEvent('factions:notify', source, string.format('Removed %d kills from member!', amount), 'success') end)