ai-vehiclekeys
Llaves de vehículos, cierre con mando a distancia, forzar cerraduras y puentear, y el bloqueo del motor sin llave.
ai-vehiclekeys decide quién puede cerrar, abrir y arrancar un vehículo. Un jugador sin la llave no puede arrancar el motor; con una ganzúa puede intentar abrir una puerta cerrada o puentear el coche.
Qué hace en el juego
- Quién tiene llave. El dueño de un vehículo en propiedad siempre tiene su llave, y todos los miembros del trabajo o banda dueños de un vehículo de flota también la tienen. Estas llaves nunca se guardan: siguen la propiedad en ai-vehicles, así que vender un coche mueve la llave con él. Otros scripts pueden dar llaves extra (un alquiler, un vehículo de trabajo, una prueba de conducción, un vehículo sacado por un administrador); esas duran hasta que el jugador sale del servidor o cambia de personaje.
- Cierre. Pulsa U cerca de un vehículo del que tengas la llave. Las luces parpadean y el claxon suena una vez cuando vas a pie.
- Motor. En el asiento del conductor sin llave, el motor se queda apagado: el jugador no puede arrancarlo acelerando, y la entrada del motor del menú radial también lo rechaza. M apaga y vuelve a encender el motor para un conductor que tiene la llave.
- Dar las llaves. Sentado en un vehículo del que tienes la llave, la sección de vehículo del menú radial muestra Hand over the keys. El otro jugador más cercano a menos de 3 m recibe una copia (tú conservas la tuya). Los dos reciben una notificación.
- Forzar cerraduras. Usa un objeto
lockpickjunto a un vehículo cerrado (a menos de 3 m) para abrir sus puertas. Úsalo en el asiento del conductor de un vehículo del que no tienes llave para puentearlo: si sale bien, el jugador tiene la llave hasta salir del servidor. El orden es: el minijuego (si hay uno configurado), una barra de progreso y después la tirada de probabilidad. El jugador debe quedarse a menos de 4 m del vehículo hasta el final. Un intento fallido puede romper la ganzúa.
Instalación
Lo instala la receta de AI Core. A mano: ensure ai-vehiclekeys después de ai-core y ai-vehicles. Añade un objeto lockpick a tu inventario si no tiene ninguno: ai-vehiclekeys lo registra como usable con el inventario que esté en uso.
En el panel de administración, Server > General > Key script elige el sistema de llaves. Automatic usa ai-vehiclekeys cuando no está en marcha ningún otro script de llaves soportado.
Ajustes del panel
Panel de administración > Vehicle keys > pestaña Keys and locks. Los valores por defecto vienen de data/settings.json.
Tecla de cierre
| Ajuste | Qué cambia | Unidad | Por defecto |
|---|---|---|---|
| Lock reach | A qué distancia del vehículo debe estar el jugador para cerrarlo o abrirlo. 2-30. | m | 6 |
Forzar cerraduras
| Ajuste | Qué cambia | Unidad | Por defecto |
|---|---|---|---|
| Door chance | Probabilidad de que una ganzúa abra una puerta cerrada. 0-100. | % | 60 |
| Door time | Cuánto dura la barra de progreso de una puerta. 1-60. | s | 5 |
| Hotwire chance | Probabilidad de que arranque el motor; el jugador tiene entonces las llaves hasta salir del servidor. 0-100. | % | 35 |
| Hotwire time | Cuánto dura la barra de progreso para puentear. 1-120. | s | 10 |
| Break chance | Probabilidad de que la ganzúa se rompa cuando falla un intento. 0-100. | % | 25 |
| Minigame | Se juega antes de la barra de progreso: None, Skill check o Lockpick. Una ganzúa que se rompe en el minijuego de ganzúa se gasta. La probabilidad de arriba se sigue tirando tras ganar el minijuego: ponla al 100 % para que decida solo el minijuego. | Lockpick | |
| Difficulty | Easy, Medium o Hard. Solo se muestra cuando se elige un minijuego. | Medium |
Comandos
Ninguno.
Teclas
Cada jugador puede cambiarlas en los ajustes de teclas de GTA (sección FiveM); el dueño cambia los valores por defecto en el panel de administración (Keybinds).
| Tecla por defecto | Qué hace |
|---|---|
| U | Cierra o abre el vehículo más cercano del que tengas la llave. |
| M | Encender / apagar el motor (solo en el asiento del conductor). Sin llave muestra "You do not have the keys to this vehicle". |
A qué sustituye
fxProvide: qbx_vehiclekeys. exports.qbx_vehiclekeys:HasKeys, GiveKeys, RemoveKeys, SetLockState e IsPlayerNearVehicle llegan a ai-vehiclekeys.
Otros scripts de llaves
Puedes usar otro script de llaves en su lugar: la capa de llaves de AI Core habla con qbx_vehiclekeys, qb-vehiclekeys, wasabi_carlock, Renewed-Vehiclekeys, MrNewbVehicleKeys, vehicles_keys (Jaksam), mVehicle, las llaves de cd_garage y tgiann-hotwire. Elígelo en el panel de administración (Server > General > Key script) y detén ai-vehiclekeys. Todos los scripts ai-* dan llaves a través de la capa, así que siguen funcionando.
Límites conocidos
- Las llaves extra (puenteadas, entregadas, dadas por scripts) solo duran la sesión: desaparecen cuando el jugador sale o cambia de personaje.
- Forzar cerraduras necesita que el objeto
lockpickexista en la lista de objetos de tu inventario.