Agency-Repairkit: Reparaciones sencillas que los jugadores sí usan

El problema de las reparaciones en carretera

Tu vehículo sufre daños a mitad de una misión. El taller mecánico está a 10 minutos. Ese trayecto interrumpe el ritmo de la secuencia de acción en la que estabas. Pero repararlo al instante por tu cuenta parece injusto. Agency-Repairkit ofrece un punto medio con herramientas de reparación en carretera que puedes usar, pero tienen límites.

Tres niveles de kits

Los kits básicos reparan daños leves rápidamente. Los kits avanzados reparan daños moderados más despacio. Los kits profesionales se ocupan de daños graves, pero tardan bastante más en aplicarse. Los distintos niveles ofrecen a los jugadores opciones significativas según lo que lleven en el inventario y la situación en la que se encuentren.

Integridad de las animaciones

Todas las reparaciones usan una animación visible en la zona dañada del vehículo. Los jugadores no pueden reparar rápidamente desde el asiento del conductor: tienen que bajarse, acercarse al daño y completar la animación de reparación. Esto evita el abuso de las reparaciones en carretera durante el combate y hace que la acción se sienta merecida.

Las interrupciones importan

Recibir daño o ser golpeado durante una reparación la interrumpe y consume el kit. Las reparaciones se hacen fuera del combate, no en medio de este. Así se evita que las persecuciones se conviertan en un juego interminable en el que nada tiene consecuencias.

Integración con la economía

Los NPC mecánicos o los mecánicos jugadores pueden fabricar kits usando la cadena de suministro de metales de Agency-Minerjob. Toda la economía automotriz, minería, fabricación, reparaciones en carretera y reparaciones en talleres, se convierte en una red conectada. Los kits no son un objeto aislado, sino un elemento de un sistema más amplio.

Instalación y configuración

Descarga Agency-Repairkit desde tu biblioteca de Tebex y coloca la carpeta en el directorio de recursos. Añade ensure agency-repairkit a server.cfg . El recurso requiere oxmysql si quieres que el registro de kits persista tras los reinicios; sin él, las cantidades de kits solo se guardan durante la sesión y se restablecen al reiniciar el servidor.

Los objetos de los kits deben registrarse en la lista de objetos de tu framework. La configuración incluye los nombres de objeto correctos para QBCore y ESX. Para configuraciones standalone, el hook de registro de objetos consiste en una sola llamada a función en config.lua.

Opciones de configuración

El config.lua expone un control total sobre el comportamiento de los kits:

• Niveles de kit, define tantos tipos de kit como quieras, cada uno con una cantidad máxima de reparación, velocidad de reparación y duración de animación.
• Bloqueo por combate, si se pueden iniciar reparaciones cuando el jugador está marcado como en combate. Por defecto: desactivadas durante el combate.
• Umbral de daño para interrumpir, cuánto daño recibido cancela una reparación activa. Ponlo en 0 para que cualquier golpe la cancele.
• Animación según la zona dañada, se reproducen distintas animaciones para daños en el motor, la carrocería y los neumáticos.
• Integración con la economía, activa el evento de integración de fabricación para que el metal obtenido con Agency-Minerjob se pueda usar para fabricar kits.

Compatibilidad con frameworks

Agency-Repairkit incluye adaptadores integrados para QBCore y ESX. La detección del framework es automática, añade el recurso y detectará cuál estás usando. Para servidores standalone:

• Implementa Config.GetItem y Config.RemoveItem para conectar tu sistema de objetos.
• Implementa Config.GetVehicleHealth y Config.SetVehicleHealth para tu sistema de daños de vehículos.
• Todo lo demás (animaciones, interfaz, lógica de interrupción) funciona sin cambios.

Por qué esto importa para el roleplay

El daño a los vehículos es una de las fuentes más constantes de fricción en el RP. Cuando una misión sale mal a 15 minutos del taller mecánico más cercano, los jugadores deben elegir: avanzar a duras penas con el coche y arruinar el ritmo, rendirse y teletransportarse, o tener una opción viable para reparar en el lugar. Los kits de reparación ofrecen una tercera alternativa que se siente merecida, pero no gratuita.

El sistema de kits por niveles crea decisiones naturales sobre la economía del inventario. ¿Llevas un kit profesional "por si acaso" y asumes el coste de cargarlo? ¿O dependes de kits básicos y aceptas que los daños graves requerirán ir a un taller? Este tipo de microdecisiones significativas hacen que gestionar el inventario se sienta real y no arbitrario.

La mecánica de interrupción durante el combate es especialmente importante para el RP de persecuciones. Sin ella, un jugador perseguido podría reparar el vehículo en plena persecución, lo que elimina por completo la tensión. Con ella, las reparaciones se hacen después del conflicto o entre escenas, no como botón de emergencia.

Preguntas frecuentes

¿Pueden los mecánicos vender kits de reparación desde su menú?

Sí. Agency-Repairkit ofrece un evento del servidor agency-repairkit:giveKit que cualquier script de mecánico puede llamar. Pasa el ID del jugador en el servidor, el nivel del kit y la cantidad. Solo tienes que añadir una llamada al evento en la rutina de venta de tu script actual de tienda mecánica.

¿El kit funciona en barcos y aeronaves?

Sí. El sistema de daños usa las propiedades nativas de salud de vehículos de FiveM, que se aplican a todos los tipos de vehículos. Las aeronaves usan una animación simplificada (los jugadores no pueden caminar hasta una zona de daño específica en pleno vuelo), y los barcos se reparan desde el muelle. Ambos comportamientos se pueden configurar.

¿Puedo limitar qué niveles de kit pueden usar ciertos trabajos?

Los permisos de uso de kits según el trabajo se admiten en la definición del objeto. Configura requiredJob = 'mechanic' en un tipo de kit y solo los jugadores con ese trabajo podrán usarlo. Esto resulta útil si quieres que los kits profesionales sean una herramienta exclusiva de los mecánicos y no un producto a la venta.

¿Cómo interactúa el kit con los scripts de reaparición de vehículos?

Agency-Repairkit activa agency-repairkit:onRepairComplete con el vehicle netId y la cantidad reparada cuando se usa un kit correctamente. Cualquier script que escuche este evento puede responder en consecuencia, por ejemplo, tu script de persistencia de vehículos puede marcar el vehículo como reparado en el lugar para el registro.

Requisitos

• Servidor FiveM (QBCore, ESX o standalone)
• oxmysql (opcional, para el seguimiento persistente de kits)
• cuenta de cfx.re con una licencia válida de Agency-Repairkit
• Registro de los objetos del framework para los kits

Cómo equilibrar los kits de reparación en la economía de tu servidor

La pregunta económica que más se hacen los servidores sobre Agency-Repairkit es: ¿qué tan raros deberían ser los kits? La respuesta depende del equilibrio actual de la economía de tu servidor.

Si tu servidor tiene talleres mecánicos activos con buen roleplay, haz que los kits básicos y avanzados estén razonablemente disponibles, pero que los profesionales sean raros o exclusivos de los mecánicos. Así, las reparaciones importantes se hacen en los talleres, mientras que se permiten las reparaciones menores en el terreno, lo que mantiene viable el roleplay de mecánico.

Si tu servidor tiene dificultades para mantener la participación de los jugadores en los trabajos de mecánico, reduce la disponibilidad de kits de campo y asegúrate de que los kits fabricados por mecánicos sean mejores que los disponibles comercialmente. El incentivo económico para acudir a un mecánico jugador debe ser real, no solo narrativo.

Si tu servidor tiene una economía criminal sólida, los precios de fabricación de los kits a través de Agency-Blackmarket o la fabricación por parte de jugadores crean un mercado paralelo. Los kits de reparación de grado militar como artículos del mercado negro generan un roleplay logístico interesante sin perjudicar el mercado de mecánicos civiles.

El principio clave: las reparaciones en el terreno deben ser una opción útil, no la mejor. Si los jugadores nunca visitan los talleres mecánicos, tus kits son demasiado potentes o demasiado baratos. Ajusta la capacidad de reparación y el precio a la vez, no por separado.