🖥️INSTALLATION

Here you’ll find the full documentation to help you install and configure the Punishment System from the iZaap Studios store.

🚀 How to Start the Script for Proper Operation

1. Download and install Oxmysql (required dependency): 👉 https://github.com/overextended/oxmysql

1. Add the following lines to your server.cfg

# iZaap Studios - Punishment System
ensure oxmysql
ensure izaap_punishment

🛠️ Insert the SQL and Configure Your Framework:

SQL

CREATE TABLE IF NOT EXISTS banned_players (
    citizenid VARCHAR(50) PRIMARY KEY,
    ban_time INT,
    reason TEXT,
    staff TEXT
);


CREATE TABLE IF NOT EXISTS izaap_register_banned (
    id INT AUTO_INCREMENT PRIMARY KEY,
    citizenid VARCHAR(50),
    name TEXT,
    reason TEXT,
    ban_time INT,
    staff TEXT,
    type VARCHAR(20) DEFAULT 'PED',
    timestamp DATETIME DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE IF NOT EXISTS cleaning_punishments (
    citizenid VARCHAR(50) PRIMARY KEY,
    sweeps_required INT NOT NULL,
    reason TEXT,
    staff TEXT,
    timestamp DATETIME DEFAULT CURRENT_TIMESTAMP
);


CREATE TABLE IF NOT EXISTS izaap_punishment_logs (
    id INT PRIMARY KEY,
    webhook_url TEXT
);

INSERT IGNORE INTO izaap_punishment_logs (id, webhook_url) VALUES (1, '');

QBCORE

--[[ 
    💼 Gracias por comprar en iZAAP STUDIOS
    📚 Documentación: https://izaap-studios.gitbook.io/izaap-studios
    ❓ Soporte disponible en nuestro Discord oficial: https://discord.gg/kNC9HJeskV

    Configura los valores a continuación según tu servidor.
]]

Config = {}

-- Framework en uso: 'qb' o 'esx'
Config.Framework = 'qb'

-- Comando para abrir el panel administrativo
Config.AdminCommand = 'panelcastigos'

-- Comandos para castigar manualmente (PED y desbaneo)
Config.BanCommand = 'baneo'
Config.UnbanCommand = 'desbaneo'

-- Modelo de castigo tipo PED
Config.BanPedModel = 'a_c_pug'

-- Coordenadas donde se envía al jugador con castigo PED
Config.BanCoords = vector4(-427.8036, 1123.9847, 325.8543, 108.6573)

-- Texto que se muestra sobre los castigados (solo si están cerca)
Config.PunishText = "~r~Me porté mal :("

-- Logo mostrado en la interfaz del castigo (URL directa a imagen)
Config.BanLogoURL = 'https://r2.fivemanage.com/PJDwcJBxdtv29rgZuuqbt/imagexcfcdf.png'

-- Eliminar todo el inventario al ser castigado (true = sí, false = no)
Config.ClearInventoryOnPunish = false

-- Tipo de sistema de ropa para recargar el skin del jugador al finalizar el castigo
-- Opciones válidas:
-- 'illenium'     → usa el evento: 'illenium-appearance:client:reloadSkin'
-- 'qb'           → usa el evento: 'qb-clothing:client:loadPlayerClothing'
-- 'esx_skin'     → obtiene el skin desde la base de datos y lo aplica con skinchanger

Config.ReloadSkinType = 'illenium' -- Cambia esto según tu sistema de ropa

ESX

--[[ 
    💼 Gracias por comprar en iZAAP STUDIOS
    📚 Documentación: https://izaap-studios.gitbook.io/izaap-studios
    ❓ Soporte disponible en nuestro Discord oficial: https://discord.gg/kNC9HJeskV

    Configura los valores a continuación según tu servidor.
]]

Config = {}

-- Framework en uso: 'qb' o 'esx'
Config.Framework = 'esx'

-- Comando para abrir el panel administrativo
Config.AdminCommand = 'panelcastigos'

-- Comandos para castigar manualmente (PED y desbaneo)
Config.BanCommand = 'baneo'
Config.UnbanCommand = 'desbaneo'

-- Modelo de castigo tipo PED
Config.BanPedModel = 'a_c_pug'

-- Coordenadas donde se envía al jugador con castigo PED
Config.BanCoords = vector4(-427.8036, 1123.9847, 325.8543, 108.6573)

-- Texto que se muestra sobre los castigados (solo si están cerca)
Config.PunishText = "~r~Me porté mal :("

-- Logo mostrado en la interfaz del castigo (URL directa a imagen)
Config.BanLogoURL = 'https://r2.fivemanage.com/PJDwcJBxdtv29rgZuuqbt/imagexcfcdf.png'

-- Eliminar todo el inventario al ser castigado (true = sí, false = no)
Config.ClearInventoryOnPunish = false

-- Tipo de sistema de ropa para recargar el skin del jugador al finalizar el castigo
-- Opciones válidas:
-- 'illenium'     → usa el evento: 'illenium-appearance:client:reloadSkin'
-- 'qb'           → usa el evento: 'qb-clothing:client:loadPlayerClothing'
-- 'esx_skin'     → obtiene el skin desde la base de datos y lo aplica con skinchanger

Config.ReloadSkinType = 'esx_skin' -- Cambia esto según tu sistema de ropa

4️⃣ Configure Skin Reload System

Depending on the clothing system your server uses, set the correct option in config.lua:

lConfig.ReloadSkinType = 'esx_skin' -- or 'qb' or 'illenium'

Supported skin reload types:

• 'illenium' → Uses illenium-appearance

• 'qb' → Uses qb-clothing

• 'esx_skin' → Uses esx_skin + skinchanger