El problema con el acceso predeterminado a vehículos en FiveM
De forma predeterminada, GTA V y FiveM permiten que cualquier jugador entre y conduzca cualquier vehículo sin restricciones. No hay llaves, no hay mecánicas de propiedad, no hay consecuencias por subirse al coche de un desconocido y salir disparado. Para servidores casuales esto apenas importa, pero para cualquier comunidad de roleplay seria este comportamiento es un destructor de inmersión fundamental. Cada coche se convierte en un taxi comunal. El robo de vehículos pierde todo su significado. Aparcar el coche cerca del banco mientras haces un trabajo se convierte en una apuesta contra otros jugadores que se lo llevan.
Un script de llaves de vehículo para FiveM resuelve este problema a nivel de framework. Vincula la propiedad y llaves físicas a cada vehículo spauneado o comprado en el servidor, exigiendo que los jugadores tengan el objeto llave correcto en su inventario para desbloquear, arrancar y conducir un coche. Los vehículos sin llave están bloqueados — un jugador que intente entrar simplemente es rechazado. Para conducir un coche que no es tuyo, necesitas pedir prestada la llave, usar la mecánica de hotwire o forzar la cerradura. Estas tres mecánicas juntas transforman la interacción con vehículos de un no-evento en una capa significativa de fricción de roleplay.
En 2026, Agency-Vehiclekeys es la elección destacada para los servidores que quieren implementar este sistema de forma limpia, con integración profunda en QBCore y ESX, un mini-juego de hotwire atractivo y un precio único muy asequible. Esta guía cubre todo lo que necesitas saber.
Qué ofrece Agency-Vehiclekeys
Agency-Vehiclekeys se construye sobre cinco pilares funcionales principales que juntos hacen que la propiedad de vehículos se sienta real:
1. Objetos de llave físicos
Cuando un jugador spawnea o compra un vehículo, se coloca un objeto llave único en su inventario. Este objeto es el único modo de desbloquear y arrancar ese vehículo específico — está vinculado al ID de red o a la matrícula del vehículo. La llave puede entregarse físicamente a otro jugador, tirarse al suelo, guardarse en un almacén o perderse. Si pierdes tu llave, no puedes arrancar tu coche sin usar el hotwire o llamar a un cerrajero (una mecánica de trabajo que puedes configurar). Esta única decisión de diseño — convertir las llaves en objetos reales de inventario — crea una cascada de escenarios de roleplay auténticos que FiveM por defecto simplemente no puede proporcionar.
2. Compartir llaves
El sistema de compartir llaves permite al propietario del vehículo crear una copia y entregársela a cualquier otro jugador. Esto es esencial para vehículos co-propiedad, coches familiares, talleres mecánicos que necesitan mover vehículos y tripulaciones criminales que comparten un coche de huida. El intercambio se realiza mediante una interacción sencilla en el juego — apunta al jugador, selecciona «Dar llave de vehículo», y la copia aparece en su inventario. El propietario conserva su llave; el destinatario recibe una copia funcional idéntica al original. Los propietarios también pueden revocar todas las llaves compartidas en cualquier momento, bloqueando el acceso a cualquiera que la tuviera anteriormente.
3. Mini-juego de hotwire
Cuando un jugador intenta entrar en un vehículo bloqueado para el que no tiene llave, se le presenta la opción de hacer hotwire. Agency-Vehiclekeys incluye un pulido mini-juego NUI de hotwire — un reto de combinación de cables cronometrado que requiere la habilidad del jugador en lugar de un simple lanzamiento de dados. Completar el mini-juego con éxito arranca el coche pero desencadena eventos en el lado del servidor que otros scripts pueden interceptar: alertar al propietario del coche, notificar a la policía, registrar el incidente en el MDT. La dificultad y el límite de tiempo del mini-juego son totalmente configurables, y puedes establecer diferentes niveles de dificultad según la clase del vehículo (coches económicos más fáciles, supercars más difíciles).
4. Sistema de ganzúa
El sistema de lockpick cubre el paso de desbloqueo de la puerta por separado del hotwire. Un jugador con un objeto ganzúa en su inventario puede intentar forzar la cerradura de la puerta de un vehículo. Esto es un requisito previo para entrar en el vehículo en absoluto al hacer hotwire — fuerzas la puerta y luego haces hotwire. La apertura de cerraduras tiene su propio mini-juego y su propia tasa de éxito configurable y probabilidad de consumo del objeto. Los intentos fallidos pueden romper la ganzúa (configurable) y opcionalmente enviar una notificación a los jugadores cercanos o a la policía. Este proceso de dos pasos — forzar la cerradura y luego hacer hotwire — hace que el robo de vehículos sea significativamente arriesgado y lento, exactamente como debería ser en el RP serio.
5. Integración profunda con QBCore y ESX
Agency-Vehiclekeys se integra directamente con el inventario de QBCore (compatible con ox_inventory) y el inventario de ESX desde el primer momento. Los objetos llave aparecen como objetos de inventario correctos con iconos y metadatos. La propiedad del vehículo se vincula con la base de datos de propiedad de vehículos de QBCore (player_vehicles) y su equivalente ESX. Cuando un jugador recoge su coche del concesionario o del depósito, su llave se genera automáticamente y se coloca en su inventario. Todas las notificaciones — confirmaciones de bloqueo/desbloqueo, alertas de hotwire, intentos de ganzúa — utilizan el sistema de notificación nativo de tu framework para que coincidan con el resto de la interfaz de tu servidor.
Funcionalidades adicionales
Más allá de los cinco pilares principales, Agency-Vehiclekeys incluye varias mecánicas de calidad de vida:
- Animaciones de bloqueo/desbloqueo: El personaje realiza una animación realista de extensión del brazo al bloquear o desbloquear un vehículo, con un sonido de clic audible.
- Bloqueo por proximidad: Bloquea y desbloquea desde una distancia configurable usando un atajo de teclado o una opción del menú radial — sin necesidad de estar justo al lado de la puerta.
- Alarma de vehículo: Activa opcionalmente una alarma de coche cuando se realiza un intento de ganzúa o hotwire. La alarma llama la atención de los jugadores cercanos y puede notificar al propietario mediante notificación telefónica (si Agency Phone está instalado).
- Vehículos exentos por trabajo: Define una lista de vehículos de trabajo (coches de policía, ambulancias, grúas) que están exentos del sistema de llaves — los agentes pueden entrar en los vehículos de trabajo libremente sin necesitar un objeto llave.
- Integración con el depósito: Cuando un vehículo es llevado al depósito, la llave asociada se invalida automáticamente. Cuando el vehículo es recuperado del depósito, se genera una nueva llave.
- API de exportación: Una API de exportación limpia permite que otros scripts comprueben la propiedad de llaves, generen llaves de forma programática o revoquen llaves — útil para scripts de mecánico, concesionario e integraciones de trabajos personalizados.
Instalación: paso a paso
Paso 1 — Comprar Agency-Vehiclekeys
Dirígete a shop.agencyg.de/es/products/vehiclekeys y completa la compra única de 5,99 €. Tras el pago recibes acceso de descarga a través del portal de la tienda Agency Scripts. Sin suscripción, sin renovación — lo posees permanentemente.
Paso 2 — Colocar el recurso
Extrae el archivo descargado y coloca la carpeta agency-vehiclekeys dentro del directorio resources de tu servidor (o en una subcarpeta como resources/[scripts]/).
Paso 3 — Añadir al server.cfg
Abre tu server.cfg y añade la línea ensure después de los recursos de tu framework e inventario:
ensure agency-vehiclekeys
Paso 4 — Configurar Config.lua
Abre agency-vehiclekeys/config/Config.lua y establece tu framework, sistema de inventario y preferencias de funcionalidades. Consulta el ejemplo abajo para una configuración representativa.
Paso 5 — Añadir objetos llave a tu inventario
Si usas QBCore o ESX, añade la definición del objeto llave a tu archivo de objetos compartidos. La definición exacta del objeto se proporciona en la documentación en docs.agencyg.de/vehiclekeys. Para usuarios de ox_inventory, añade el objeto a tu items.lua.
Paso 6 — Reiniciar y probar
Reinicia tu servidor. Spawnea un vehículo, comprueba tu inventario para ver el objeto llave, bloquea el vehículo, aléjate, vuelve e intenta entrar sin la llave. Luego prueba la entrega de llave a otro jugador, la interacción de ganzúa y el mini-juego de hotwire.
Ejemplo de Config.lua
A continuación se muestra una configuración representativa con las opciones más importantes de Agency-Vehiclekeys:
-- Agency-Vehiclekeys: Config.lua
Config = {}
-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"
-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"
-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"
-- Item name for lockpicks
Config.LockpickItem = "lockpick"
-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0
-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30 -- seconds
-- Hotwire mini-game settings
Config.Hotwire = {
enabled = true,
timeLimit = 20, -- seconds to complete mini-game
difficulty = "medium", -- "easy", "medium", "hard"
-- Per-class overrides (GTA vehicle class numbers)
classOverrides = {
[6] = "easy", -- off-road: easier
[7] = "hard", -- supercars: harder
[14] = "hard", -- military: very difficult
},
}
-- Lockpick settings
Config.Lockpick = {
enabled = true,
breakChance = 0.25, -- 25% chance lockpick breaks on failure
alertPolice = true, -- send notification to online police on attempt
alertRadius = 30.0, -- metres within which police are notified
}
-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }
-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"
-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true
Compatibilidad de framework e inventario
Agency-Vehiclekeys admite las siguientes combinaciones desde el primer momento:
- QBCore + qb-inventory: Integración completa — las llaves aparecen en la interfaz de inventario de QBCore, la propiedad del vehículo se sincroniza con
player_vehicles - QBCore + ox_inventory: Integración completa — llaves renderizadas como objetos ox con metadatos, compatibles con todas las funcionalidades de ox_inventory
- ESX + inventario ESX: Integración completa — llaves en el sistema de inventario ESX, propiedad sincronizada con la tabla de vehículos ESX
Si usas un sistema de inventario diferente, la API de exportación y el código Lua abierto facilitan añadir un bridge personalizado. La documentación incluye una plantilla de bridge.
Documentación
La documentación completa — todas las opciones de configuración, definiciones de objetos de inventario, referencia de API de exportación, configuración de trabajos exentos y preguntas frecuentes — está disponible en docs.agencyg.de/vehiclekeys. La documentación se mantiene actualizada con cada lanzamiento e incluye definiciones de objetos listas para copiar y pegar para QBCore, ESX y ox_inventory.
Precio: 5,99 € pago único
Agency-Vehiclekeys cuesta 5,99 € como pago único a través de la tienda Agency Scripts. Sin suscripción, sin renovación, sin tarifa por servidor. Paga una vez y tenlo para siempre — todas las actualizaciones futuras de la versión principal actual están incluidas sin coste adicional. A menos de seis euros, es uno de los scripts FiveM premium más rentables del mercado. Un sistema de llaves de vehículo comparable de otro desarrollador con modelo de suscripción costaría eso en un solo mes; Agency-Vehiclekeys te ofrece la misma calidad o mejor por un precio único que la mayoría de los propietarios de servidores gastan en café en una semana.
¿Para quién es Agency-Vehiclekeys?
Agency-Vehiclekeys es la elección correcta para:
- Servidores de RP serios que quieren que la propiedad de vehículos tenga peso real — ya no más saltar a cualquier coche que veas
- Comunidades de RP criminal que quieren mecánicas auténticas de hotwire y ganzúa que hagan del robo de vehículos una actividad hábil y arriesgada
- Servidores con concesionarios de coches — la integración perfecta significa que la generación de llaves es automática en el punto de venta
- Servidores de RP policial — las alertas de alarma y las notificaciones a la policía en intentos de ganzúa/hotwire crean escenarios de respuesta genuinos
- Servidores de QBCore y ESX que buscan una solución de llaves lista para usar y bien mantenida que respeta las convenciones existentes del framework
Resumen
Las llaves de vehículo son una mecánica fundamental para cualquier servidor que se tome el roleplay en serio. Agency-Vehiclekeys entrega el paquete completo — objetos llave físicos, compartir llaves, un mini-juego de hotwire basado en habilidades, un sistema de ganzúa en dos etapas, alarmas de vehículos e integración profunda de framework — por un pago único de 5,99 €. Es, objetivamente, una de las compras con mejor relación calidad-precio que puedes hacer para tu servidor FiveM. Visita la tienda, hazte con él y transforma hoy mismo cómo funcionan los vehículos en tu servidor.