Skip to content

Home

Jump to bottom
Carri byLcarma edited this page Apr 13, 2025 · 1 revision

📘 Wiki - adn_esx_ownedcarthief

Sistema de robo de vehículos, alarmas y venta ilegal para servidores ESX. Compatible con oxmysql y preparado para localización multilenguaje.

🔧 Requisitos

  • oxmysql
  • es_extended
  • esx_vehicleshop

⚙️ Instalación

  1. Clona o descarga el repositorio.

  2. Añade el recurso a tu server.cfg:

    ensure adn_esx_ownedcarthief

  3. Importa la SQL:

    • esx_ownedcarthiefES.sql si tu servidor está en español.
    • O cualquiera de los otros archivos sql traducidos.

  4. Verifica que usas oxmysql. Si no, debes adaptar manualmente a mysql-async (no recomendado).

⚙️ Configuración - config.lua

Este archivo controla todos los aspectos de configuración del script adn_esx_ownedcarthief. A continuación, se explican cada uno de sus parámetros.

🔐 Seguridad y vehículos

Config.SuccesChance = 60

Probabilidad de éxito al intentar forzar un vehículo. (0-100%)

Config.OnlyPlayerCar = true
  • true: solo se pueden robar coches de jugadores.
  • false: se pueden robar coches NPC también.
Config.Locale = 'en'

Idioma de los textos. Puedes usar 'en', 'fr', 'br' o añadir más.

👮 Reacción policial

Config.PoliceNumberRequired = 0

Número mínimo de policías conectados para permitir un robo.

Config.AlertPolice = true

Si está activado, la policía será notificada al activarse una alarma.

Config.CallCopsChance = 60

Probabilidad de que se llame a la policía cuando se active una alarma.

Config.BlipTime = 40

Tiempo en segundos que un blip de alerta estará visible en el mapa.

🏚️ Casa de empeño

Config.SellCarBlackMoney = false

Define si el dinero recibido es negro (true) o legal (false).

Config.WaitTime = 15

Minutos de espera entre venta de vehículos.

Config.ExpireVehicle = 7

Días para que un vehículo robado pueda ser recomprado antes de ser público.

Config.ResellPercentage = 10

Porcentaje del precio original que recibe el jugador al vender un vehículo.

Config.RebuyPercentage = 15

Porcentaje del precio original que debe pagar un jugador para recomprar.

Config.NpcCarPrice = 100

Precio fijo por la venta de coches NPC si está permitido.

Config.PawnShopBLJob = {
  { JobName = "police" },
  { JobName = "mechanic" },
  { JobName = "ambulance" }
}

Trabajos que no pueden vender vehículos en el garaje ilegal.

🛒 Precios de ítems

Config.Items = {
  HammerWireCutter = {name = "hammerwirecutter", price = 100},
  UnlockingTool = {name = "unlockingtool", price = 1000},
  Jammer = {name = "jammer", price = 10000},
  Alarm1 = {name = "alarm1", price = 10000},
  Alarm2 = {name = "alarm2", price = 20000},
  Alarm3 = {name = "alarm3", price = 30000},
  AlarmInterface = {name = "alarminterface", price = 100}
}

Define el nombre y precio de cada ítem de robo o alarma.

📍 Zonas de interacción

Config.Zones = {
  Shops = {
    PawnShop = {
      Name  = "pawnshop_menu_title",
      OnMap = true,
      Pos = {...},
      Size = 1.5,
      Color = 26,
      Sprite = 52
    },
    BlackGarage = {
      Name  = "black_menu_title",
      OnMap = false,
      Pos = {...},
      Size = 1.5,
      Color = 40,
      Sprite = 229
    }
  }
}

Define la posición y aspecto visual de las casas de empeño y garajes ilegales.

🚨 Funcionalidades principales

  • Roba vehículos con herramientas ilegales (hammerwirecutter, unlockingtool).
  • Sistema de alarmas por niveles: básica, módulo de enlace, GPS.
  • Interfaz de alarma para activarla/desactivarla.
  • Casas de empeño con rebuy de vehículos y caducidad por tiempo.
  • Aviso a policía mediante blips, GPS y notificaciones.
  • Soporte para black_money o dinero limpio al vender.

🗃️ Base de datos

Se requieren dos tablas nuevas:

  • pawnshop_vehicles → Para gestionar los coches en el sistema de empeño.
  • Dos nuevas columnas en owned_vehicles:
    • security (nivel de alarma)
    • alarmactive (estado de alarma)

Consulta el archivo .sql correspondiente para aplicar estos cambios.

🌍 Localización

El recurso utiliza el sistema de localización nativo de ESX:

  • locales/es.lua (por defecto)
  • Puedes añadir fácilmente más idiomas en la carpeta locales/.

✍️ Créditos

🛠️ Licencia

Este recurso ha sido adaptado y renombrado siguiendo la licencia GPLv3 del proyecto original esx_ownedcarthief.

Clone this wiki locally