Agency-Vehiclekeys: Cómo una pequeña dificultad hace que los coches parezcan reales

La función que no es una función negativa

Exigir una llave para arrancar un vehículo suena como una función negativa. ¿Quién quiere más pasos antes de conducir? Pero el RP inmersivo suele construirse precisamente con este tipo de fricción significativa. El robo de vehículos se convierte en un delito con consecuencias. Cerrar el coche con llave se convierte en una acción real. Aprender a arrancarlo haciendo un puente se convierte en una habilidad que se puede adquirir.

Estados de llaves que importan

Agency-Vehiclekeys modela tres estados de llave por vehículo: propia (tienes una llave física), compartida (alguien te dio una copia) y puenteada (acceso temporal con riesgo de que la policía detecte el rastro). Cada estado tiene señales de sonido, animaciones de arranque y comportamiento del motor distintos. Quienes toman prestado el coche de un amigo sienten que no son ladrones, como debe ser.

Minijuego de ganzúas

Incluimos un minijuego sencillo de ganzúas con 3 niveles que se ajusta a la clase del vehículo. Abrir un Sultan RS lleva más tiempo y falla con más frecuencia que abrir un Faggio. El minijuego se basa en la habilidad, pero no es punitivo: fallar cuesta tiempo y herramientas, no progreso del personaje. Esta es la curva de dificultad adecuada para una mecánica que debe generar tensión, no ser un obstáculo.

Integraciones con frameworks

La propiedad de vehículos de QBCore, los garajes de ESX y los registros personalizados de standalone se integran mediante un único conjunto de hooks. Las llaves se guardan como objetos del inventario, así que interactúan de forma natural con los objetos soltados, los intercambios y las búsquedas en el inventario. No hay casos especiales.

Impacto económico

El acceso a vehículos mediante llaves crea roles económicos realistas. La cerrajería se convierte en un trabajo viable. Los ladrones de coches pasan a ser una amenaza real. Las aseguradoras se vuelven útiles. El roleplay emergente surge de sistemas que interactúan entre sí; Agency-Vehiclekeys es una pieza de ese puzle.

Instalación y configuración

Agency-Vehiclekeys requiere oxmysql para conservar la propiedad de las llaves entre reinicios del servidor. Importa vehiclekeys.sql y coloca la carpeta del recurso en tu servidor, y añade ensure agency-vehiclekeys a server.cfg . El recurso lee los datos de propiedad de los vehículos del garaje o del registro de vehículos de tu framework. El paquete incluye adaptadores para QBCore y ESX, que se detectan automáticamente al iniciar.

Los objetos de las llaves deben registrarse en el sistema de objetos de tu framework. La configuración incluye nombres de objetos y definiciones de metadatos para QBCore y ESX. Las configuraciones de standalone definen la gestión de objetos mediante hooks de configuración.

Opciones de configuración

El config.lua ofrece un control preciso de cada mecánica de las llaves:

• Niveles de ganzúas, define la probabilidad de éxito y el comportamiento en caso de fallo para cada clase de vehículo. Es más difícil hacerle un puente a un superdeportivo que a un vehículo económico.
• Probabilidad de detección del puente, probabilidad de que un puente exitoso envíe una alerta a la policía por cada minuto de uso activo.
• Coste de duplicar llavesartículo y coste en dinero para crear una copia de una llave en el banco de cerrajería.
• Requisito del trabajo de cerrajero, limita opcionalmente el duplicado de llaves a los jugadores que tengan el trabajo de cerrajero.
• Cierre automático al salir, indica si los vehículos se cierran automáticamente cuando el conductor sale. Valor predeterminado: desactivado (más realista).
• Caducidad de las llaves compartidas, las llaves temporales pueden tener un límite de tiempo real antes de desactivarse automáticamente.

Compatibilidad con frameworks

El paquete incluye adaptadores completos para QBCore y ESX. Para configuraciones standalone, implementa cuatro funciones de configuración: consultar al propietario del vehículo, dar o quitar objetos, activar el aviso a la policía y comprobar el trabajo opcional de cerrajero. La máquina de estados de las llaves, las animaciones, el minijuego y la lógica de hotwire no requieren conocimientos de ningún framework.

Por qué esto importa para el roleplay

La propiedad de un vehículo sin controles de acceso reales es solo cosmética. Agency-Vehiclekeys hace que la diferencia entre ser propietario de un vehículo y poder acceder a él se sienta real. Un coche cerrado aparcado frente a un banco no es solo parte del paisaje, puede ser un objetivo potencial o un activo seguro, según quién lo mire.

La economía de la cerrajería es el mayor beneficio emergente. Cuando las llaves son objetos físicos que se pueden duplicar, perder o robar, los personajes cerrajeros tienen un servicio real que ofrecer. Quienes pierden su llave tienen que hacer hotwire (arriesgado) o encontrar un cerrajero (requiere confianza y negociación). Esa interacción es puro RP que no existía antes de instalar el script.

El rastro de detección de hotwire es lo que convierte el robo de vehículos en un riesgo calculado, en lugar de una acción trivialmente fácil. Quienes hacen hotwire y conducen durante una hora se arriesgan de verdad. Los ladrones experimentados aprenden a cambiar de vehículo con frecuencia. La policía aprende a estar atenta a los avisos de hotwire. El script genera roleplay criminal y policial de forma orgánica, sin eventos programados.

Preguntas frecuentes

¿Pueden los jugadores darle su llave a otro jugador?

Sí. Las llaves son objetos del inventario y se pueden intercambiar, dejar en el suelo o entregar mediante cualquier sistema de transferencia estándar del inventario. Esto incluye entregar una llave a través del mercado de Agency-Phone o dejarla en un lugar para que alguien la recoja, se aplica toda la economía de objetos.

¿Qué pasa si se pierde o se elimina un objeto de llave?

El registro de llaves del servidor hace un seguimiento de la propiedad independientemente del objeto. Quienes pierdan su objeto de llave físico pueden obtener un reemplazo en una cerrajería (cuesta tiempo y dinero) o mediante comandos de administración. El vehículo no queda inaccesible permanentemente.

¿Se puede desactivar el minijuego para determinados roles de jugador?

Sí. El minijuego de ganzúas se puede omitir para jugadores con determinados trabajos (por ejemplo, cerrajero experto) o ciertos objetos (un juego de ganzúas profesional en lugar de uno básico). Configura las condiciones para omitirlo en Config.LockpickItems.

¿Esto entra en conflicto con los scripts de garaje existentes?

Agency-Vehiclekeys consulta los datos de propiedad del garaje, pero no modifica el sistema de garaje. Los vehículos siguen apareciendo mediante el script de garaje que ya tienes. El sistema de llaves se añade por encima: cuando sacas un vehículo del garaje, se genera automáticamente un objeto de llave en tu inventario.

Requisitos

• Servidor FiveM (QBCore, ESX o standalone)
• oxmysql
• cuenta de cfx.re con una licencia válida de Agency-Vehiclekeys
• Sistema de propiedad de vehículos o garaje compatible

Interpretar a un cerrajero en un servidor con llaves

Agency-Vehiclekeys permite ejercer una auténtica profesión de cerrajero, que no existe en los servidores sin llaves. Así es cómo sería la jugabilidad de ese personaje en la práctica:

Un personaje cerrajero que ofrece servicios de duplicado de llaves necesita una forma de recibir solicitudes de sus clientes, y Agency-Phone se encarga de eso. Necesita un objeto de taller para la animación de duplicado de llaves. Coordina con el equipo de MLO de tu servidor o usa un objeto de taller vanilla. Cobra por el servicio y el dinero circula por el framework de economía. También puede llevar herramientas de ganzúas de nivel superior capaces de abrir vehículos que las herramientas de otros jugadores no pueden, lo que exige la confianza de clientes criminales que necesitan acceder a un vehículo concreto.

La dimensión de la confianza es especialmente interesante. Un cerrajero que hace copias de llaves sin autorización, que denuncia a la policía a sus clientes que solicitan duplicados o que daña vehículos deliberadamente mientras «trabaja en ellos» es un personaje con verdadera complejidad moral y consecuencias reales en el juego por sus decisiones. Agency-Vehiclekeys crea las condiciones para que ese personaje exista.