ZerØ Network
Inicio/Documentación/ZerØ Rent Vehicle

Manual de Instrucciones y Guía de Uso — ZerØ Rent

Versión: 1.0.1 | Autor: ZerØ Network | Frameworks: QBCore, Qbox, ESX Legacy, Standalone
Rendimiento: 0.00 ms (CPU en reposo y conducción) | Persistencia: Dual-JSON WAL (Sin dependencias SQL)

Índice

  1. Descripción General
  2. Requisitos del Sistema
  3. Instalación Paso a Paso
  4. Configuración de Permisos Administrativos
  5. Guía de Administración (/zerorent)
  6. Guía de Controles del Modo Fantasma 3D
  7. Guía para el Jugador (Cliente)
  8. Resolución de Problemas Frecuentes (FAQ)

1. Descripción General

ZerØ Rent es un sistema autónomo, modular y de alto rendimiento para el alquiler de vehículos en FiveM. A diferencia de los scripts tradicionales, zero_rent:

  • No depende de base de datos SQL: Utiliza un sistema contable de doble archivo JSON (Write-Ahead Logging) que previene pérdida de datos ante caídas o reinicios.
  • Rendimiento adaptativo: El streaming usa 1500 ms de fábrica y la lectura por fotograma sólo se activa junto al NPC o dentro del editor. El objetivo de consumo en reposo es 0.00 ms.
  • Modo Fantasma 3D: Permite colocar NPCs y bahías de salida con una cámara libre en tiempo real, proyectando la colisión sobre el suelo tanto en exteriores como dentro de hangares o garajes (MLOs).
  • Detección secuencial inteligente: Detecta de forma estricta bahías de estacionamiento individuales (1.40 m para coches, 1.0 m para motos/bicis, 3.5 m para botes y 7.5 m para aeronaves) sin falsos positivos de bloqueo.
  • Bloqueo Universal de Garajes: Impide que los coches alquilados sean guardados en cualquier sistema de garajes existente.

2. Requisitos del Sistema

  • Artefactos del Servidor: FXServer 3500 o superior (recomendado 7290+).
  • OneSync: Requiere OneSync activado (set onesync on o set onesync_enableInfinity 1).
  • Frameworks compatibles:
    • QBCore (detectado automáticamente).
    • Qbox (detectado automáticamente).
    • ESX Legacy (detectado automáticamente).
    • Standalone (sin framework, utilizando nativas de GTA V).
  • Scripts de Llaves / Notificaciones: Compatibilidad modular automática con zero_notify, ox_lib, okokNotify, mythic_notify, wasabi_carlock, qb-vehiclekeys, qbx_vehiclekeys, qs-vehiclekeys o ganchos personalizados.

3. Instalación Paso a Paso

  1. Descarga y Extracción:
    Coloca la carpeta zero_rent en el directorio de recursos de tu servidor (por ejemplo, resources/[zero]/zero_rent o resources/zero_rent).
  2. Añadir a server.cfg:
    Abre el archivo server.cfg de tu servidor y añade la siguiente línea asegurándote de que cargue después del framework:
    ensure zero_rent
  3. Comprobación de OneSync:
    Verifica que OneSync esté habilitado en server.cfg:
    set onesync on
  4. Verificación inicial:
    Inicia tu servidor. En la consola aparecerá el banner de inicio de ZerØ Network:
    =========================================================
               Z E R Ø   N E T W O R K
  zero_rent  |  Framework: qbcore  |  Versión: v1.0.1  |  Resmon objetivo en reposo: 0.00ms
=========================================================
[ZERØ NETWORK] zero_rent está actualizado a la última versión (v1.0.1).

4. Configuración de Permisos Administrativos

El panel administrativo se abre mediante el comando /zerorent en el chat o en la consola F8. Para otorgar acceso a los administradores:

Opción A: Permisos ACE de FiveM (Recomendado)

Añade las siguientes líneas en tu server.cfg:

# Otorgar permiso general de comando a administradores
add_ace group.admin command allow

# O bien, otorgar permiso específico únicamente para zero_rent:
add_ace group.admin command.zerorent allow

# Vincular a tu identificador (Steam, License o Discord):
add_principal identifier.license:TU_LICENCIA_AQUI group.admin

Opción B: Grupos del Framework

zero_rent comprueba automáticamente los grupos definidos en Config.Admin.Groups dentro de shared/config.lua:

  • QBCore: 'god', 'admin'
  • Qbox: 'admin', 'god'
  • ESX: 'superadmin', 'admin'

5. Guía de Administración (/zerorent)

Al ejecutar /zerorent siendo administrador, se abrirá la interfaz de gestión visual:

+-----------------------------------------------------------------------+
|  [Puntos]  [Ubicación]  [Salidas]  [Catálogo]  [Opciones]  [Diario]   |
+-----------------------------------------------------------------------+

Creación de Puntos de Alquiler

  1. En la columna lateral izquierda, pulsa el botón "+ Nuevo punto".
  2. Asigna un ID único y un nombre tanto en español como en inglés (ejemplo: "Renta - Legion Square").

Colocación del Encargado (NPC)

  1. En la pestaña "Ubicación", introduce el modelo del ped deseado (por ejemplo, a_m_m_business_01).
  2. Haz clic en "Colocar NPC en modo fantasma".
  3. La interfaz se ocultará y entrarás en el modo cámara 3D.
  4. Mueve la cámara y el cursor hacia el lugar exacto donde deseas colocar al NPC.
  5. Gira la orientación con las teclas Q y E.
  6. Haz Clic Izquierdo para confirmar la colocación. Las coordenadas se rellenarán automáticamente en el formulario.

Colocación de Espacios de Salida (Spawns)

  1. Ve a la pestaña "Espacios de salida".
  2. Escribe el modelo que deseas usar como referencia visual para colocar (ejemplo: blista, faggio, dinghy).
  3. Haz clic en "Añadir espacio".
  4. En el modo fantasma 3D:
    • Verás el vehículo fantasma activo proyectado sobre el suelo.
    • Los demás vehículos del punto aparecerán como modelos fantasma translúcidos estáticos, permitiéndote ver exactamente dónde queda cada plaza para evitar que se solapen o queden muy juntas.
    • El indicador superior te mostrará la distancia al NPC: la colocación no puede exceder los 50 metros del NPC. Si superas ese radio, el sistema cancelará la colocación y te devolverá al panel por seguridad.
  5. Haz Clic Izquierdo para fijar la plaza.

Edición Interactiva de Spawns Existentes (Botón Lápiz)

Si ya creaste una plaza pero deseas ajustar su posición o rotación:

  1. En la lista de bahías de salida, cada tarjeta cuenta con un botón con icono de lápiz (pencil) junto al de eliminar.
  2. Haz clic en el botón de Editar.
  3. El modo fantasma 3D se activará situando la cámara a 5 metros por detrás del spawn existente enfocado directamente en su ubicación actual.
  4. Puedes rotar el vehículo, moverlo o elevarlo.
  5. Al hacer Clic Izquierdo, las coordenadas del spawn se actualizarán al instante en el formulario.

Configuración del Catálogo de Vehículos

  1. Dirígete a la pestaña "Catálogo".
  2. En el formulario inferior, escribe:
    • Modelo: Nombre de spawn de GTA o de tu coche addon (ej: blista, comet6, havok).
    • Nombre: Etiqueta visible en pantalla.
    • Categoría: Automóvil (car), Motocicleta (motorcycle), Bicicleta (bicycle), Embarcación (boat) o Aeronave (aircraft).
    • Precio por minuto: Tarifa básica de alquiler.
  3. Pulsa "Añadir vehículo". El sistema asignará automáticamente el icono correspondiente (car, zap, bike, ship, plane o helicopter).

Opciones del Punto y Blips

En la pestaña "Opciones" puedes:

  • Auto-reparación: Activar o desactivar la reparación completa del vehículo cuando el usuario renueva el contrato.
  • Blip en el mapa: Configurar el icono (sprite), color y escala del marcador en el mapa y minimapa.

Publicación y Guardado

  1. En la pestaña "General", activa el interruptor "Punto publicado".
  2. En la barra inferior derecha, haz clic en el botón pulsante "Guardar cambios".
  3. El punto quedará operativo en vivo sin necesidad de reiniciar el servidor.

Resolución del Diario de Transacciones (WAL)

Si el servidor experimentó un corte abrupto de energía durante un cobro bancario, la pestaña "Diario" mostrará las transacciones pendientes. Puedes pulsar "Aplicar" para confirmar la operación o "Descartar" para anularla y devolver los créditos al jugador.

6. Guía de Controles del Modo Fantasma 3D

Control Acción
W / A / S / D Desplazar la cámara en el plano horizontal (adelante, izquierda, atrás, derecha).
Espacio (Space) Elevar la cámara verticalmente hacia arriba.
Control Izquierdo (Ctrl) Descender la cámara verticalmente hacia abajo.
Shift (Mantener) Multiplicador de velocidad de cámara rápida (3x).
Movimiento del Ratón Orientar el ángulo de visión de la cámara 3D.
Q / E (o R) Rotar el modelo fantasma sobre su propio eje.
Rueda del Ratón Ajustar la elevación vertical del modelo respecto al suelo.
Shift + Rueda Acercar o alejar la distancia de proyección del fantasma respecto a la cámara.
Clic Izquierdo Confirmar colocación: Guarda las coordenadas exactas y regresa al panel.
Clic Derecho / Esc Cancelar colocación: Vuelve al panel sin aplicar cambios.

[!NOTE] Mientras te encuentras en el modo editor, las animaciones, agachado, saltos y ataques de tu personaje quedan totalmente inmovilizados para evitar desplazamientos accidentales.

7. Guía para el Jugador (Cliente)

Interacción y Menú

  • Acércate a cualquier NPC de alquiler debidamente señalizado en el mapa.
  • Presiona la tecla E (o interactúa con el menú contextual si usas ox_target o qb-target).

Selección de Categorías y Vehículos

  • La cabecera superior del menú te permite filtrar por:
    • 🚗 Automóviles: Sedanes, deportivos, SUVs y compactos.
    • ⚡ Motocicletas: Motos de calle y de cross.
    • 🚲 Bicicletas: BMX, bicicletas de paseo y carreras.
    • ⛵ Embarcaciones: Lanchas, botes y motos de agua.
    • ✈️ Aeronaves: Aviones ligeros y helicópteros.
  • Cada tarjeta muestra la imagen, nombre, tarifa por minuto y el desglose de costes.

Selector de Color Interactivo

  • Antes de alquilar, puedes seleccionar el color exterior del vehículo:
    • Blanco, Negro, Rojo, Azul, Amarillo, Verde, Naranja, Púrpura, Rosa o Gris.
  • El vehículo aparecerá pintado en el color elegido tanto en pintura primaria como secundaria.

Tiempos de Alquiler y Pagos

  • Selecciona la duración deseada: 15 min, 30 min, 60 min o 120 min.
  • El importe total se debitará automáticamente de tu cuenta bancaria.
  • El vehículo aparecerá en la bahía de salida libre y tu personaje se montará con el motor encendido.

HUD Flotante de Contratos

  • En la esquina superior derecha de tu pantalla aparecerá una tarjeta informativa para cada vehículo alquilado:
    • Modelo del vehículo y matrícula.
    • Temporizador en cuenta regresiva (minutos y segundos).
    • Indicador de estado (Azul = Activo; Amarillo = Menos de 5 minutos; Rojo = Vencido).
    • Etiqueta de "Prestado" si se trata de un vehículo que te compartió otro jugador.

Avisos de Vencimiento

  • Recibirás notificaciones en pantalla cuando queden 5, 4, 3, 2 y 1 minuto.
  • Al llegar a 0, el motor se apagará automáticamente y el vehículo quedará inmovilizado. Dispondrás de un tiempo de gracia antes de su retirada.

Renovación del Alquiler

  • Si deseas conservar el vehículo por más tiempo:
    1. Abre el menú en cualquier punto de alquiler.
    2. Ve a la pestaña "Mis contratos".
    3. Pulsa "Renovar" en el vehículo deseado y elige el tiempo adicional.
    4. Si el punto tiene activa la auto-reparación, el vehículo se reparará y limpiará por completo.

Compartir Llaves con Otros Jugadores

  • Puedes prestar tu vehículo a amigos sin entregarles tu titularidad:
    1. En la pestaña "Mis contratos", introduce el ID de servidor del otro jugador (por ejemplo: 12).
    2. Pulsa "Prestar llaves" (o usa /zerorent share 12).
    3. El otro jugador podrá arrancar y conducir el vehículo, y verá el HUD con el tiempo restante.
    4. Puedes retirar el acceso en cualquier momento pulsando el botón de revocar.

Devolución y Reembolso

  • Si terminas antes de tiempo:
    1. Conduce el vehículo cerca del punto de alquiler.
    2. En el menú, pulsa "Entregar vehículo".
    3. Recibirás un reembolso del 20 % del importe total abonado directamente en tu banco.

Penalización por Destrucción

  • Si el vehículo explota o queda completamente destruido (salud <= 0), el contrato se cancela y se registra una penalización del 30 % del valor del alquiler en tu cuenta contable.

8. Resolución de Problemas Frecuentes (FAQ)

¿Por qué aparece "No hay un espacio de salida disponible para este vehículo"?

  • El sistema detecta si hay otros coches, peatones o jugadores bloqueando las bahías de salida configuradas. Asegúrate de retirar cualquier vehículo que esté sobre la plaza.
  • Si colocaste pocas bahías, abre el panel con /zerorent y añade más plazas de salida en ese punto.

¿Cómo cambio el sistema de llaves o notificaciones?

  • Abre shared/config.lua y ajusta Config.Keys.System o Config.Notify.System.
  • Si tu servidor utiliza un script no estándar, coloca Config.Keys.System = 'custom' y edita las funciones en bridge/server.lua (ver Documentación Técnica).

¿Puedo guardar un coche de alquiler en un garaje?

  • No. Por diseño y seguridad económica, zero_rent incluye bloqueos automáticos en el cliente y servidor para que ningún vehículo alquilado pueda ser ingresado ni almacenado en ningún garaje.

¿El script consume rendimiento cuando nadie alquila?

  • Objetivo de 0.00 ms en reposo. El streaming utiliza SleepFarMs (1500 ms de fábrica), la cercanía reduce progresivamente la espera y la lectura por fotograma sólo se activa dentro del radio de interacción. Comprueba el valor final con resmon 1 en tu servidor, porque también depende del artefacto y de las integraciones instaladas.