Bienvenido a FrutiSCRIPTS

En esta documentación encontrarás todo lo necesario para instalar, configurar y sacarle el máximo provecho a nuestros ecosistemas avanzados para FiveM.

Nuestra filosofía se basa en tres pilares: **Rendimiento absoluto**, **Interfaces modernas** e **Instalación simplificada**. Todos nuestros recursos están diseñados para servidores que buscan una estética premium sin comprometer la estabilidad.

Características Globales

Optimización 0.00ms

Código estructurado para reposo total. Los hilos solo se activan cuando el jugador está en el rango de acción.

UI Desbloqueada

Frontend de código abierto. Personaliza HTML, CSS y JS para adaptarlos a la marca de tu servidor.

Multi-Framework

Detección automática de QBCore, ESX Legacy o bases Standalone mediante comprobación de recursos.

Soporte Express

Acceso a un canal privado de tickets donde nuestros desarrolladores te ayudarán en tiempo récord.

¿Preparado para el despliegue?

El primer paso es asegurar que tu servidor cumple con los requisitos técnicos básicos.

Requisitos Previos

Asegúrate de configurar correctamente tu entorno de FiveM para evitar errores de inicio.

Server Artifacts

Debes correr la versión 5848 o superior de los artefactos de FiveM (Recomendado 6000+). De lo contrario, las funciones nativas más recientes fallarán y el script no iniciará.

Dependencias de Framework

Nuestros ecosistemas están testeados en las últimas versiones estables. Si usas versiones muy antiguas de estos frameworks, algunas exportaciones podrían no existir.

QBCore Framework: Versión actual de GitHub (qb-core update más reciente).
ESX Legacy: Versión 1.8.5 o superior (Compatible con ESX_Context).

Librerías Globales

oxmysql

Base de Datos

ox_lib

Librería Core

Target System

qb/ox_target

Orden de Carga (server.cfg)

El orden es crítico. Las librerías deben iniciarse siempre antes que el script.

server.cfg

# 1. Dependencias Base
                        ensure oxmysql
                        ensure ox_lib

                        # 2. Framework
                        ensure qb-core # o es_extended

                        # 3. Frutiscripts
                        ensure fruti_npcmanager

Instalación y Manifest

Pasos sencillos para arrancar tu sistema.

1. Colocar y Renombrar

Asegúrate de que la carpeta de tu recurso se llame exactamente fruti_npcmanager.

2. Server.cfg

server.cfg

ensure oxmysql
ensure ox_lib
# Tu framework aquí (es_extended / qb-core) si usas alguno
ensure fruti_npcmanager

Configuración Core

Ajustes básicos del sistema en `config.lua`.

Config = {}

Config.Debug = true
Config.Framework = "auto" -- "auto", "esx", "qb", o "standalone"

Config.AdminCommand = "npccreator" -- Comando para abrir la UI

Config.SpawnDistance = 120.0 -- A qué distancia (metros) renderizar los peds
Config.DespawnDistance = 180.0 -- Distancia para limpiarlos de memoria
Config.MaxNPCs = 50

Config.Brain = {
    wanderRadius = 15.0,  -- Distancia máxima si están en WANDER
    guardRadius = 20.0,   
    alertDistance = 25.0, -- Distancia de detección si son hostiles
    combatDistance = 10.0 
}

Módulos y Creación

Cómo usar la herramienta dentro del juego.

Comando Principal

Por defecto, el comando para abrir la interfaz completa es /npccreator.

Perfiles (Profiles)

Los perfiles son plantillas base. Creas un perfil (ej. "Guardia del Puerto") y configuras su:
• Modelo de ped (`s_m_m_security_01`).
• Comportamiento (`GUARD`, `PATROL`, `WANDER`, `DEALER`, `AMBIENT`, `IDLE_WATCH`, `FLEE`).
• Hostilidad y Armas (`BAJO`, `MEDIO`, `EXTREMO`).
Luego aplicas este perfil a un NPC individual o a un Batch/Zona.

Zonas (Zones)

Generan NPCs aleatoriamente dentro de un radio.
• Radio y Cantidad: Cuántos NPCs spawnear.
• Mix de Modelos: Puedes colocar varios modelos en la zona para que sea aleatorio.
• Blips: Se crean automáticamente en el mapa.

NPCs Colocados & Batches

Puedes spawnear NPCs estáticos con la Herramienta 3D.
Usa las flechas para rotar, Q/E para ajustar la altura, y ENTER para confirmar.
Si haces un Batch, puedes guardar varios NPCs bajo un solo grupo con configuraciones compartidas.

Props & Escenas

Coloca objetos estáticos en el mapa mediante el modo 3D.
Agrupa múltiples props para formar una Escena (ej. Barreras de policía, muebles). Todos pueden compartir el mismo temporizador de Despawn.

Sistema de Diálogos

Interactúa con tus Peds pulsando 'E'.

El editor de diálogos te permite crear árboles de conversación infinitos. Cada nodo representa lo que dice el NPC, y puedes agregar "Respuestas del Jugador".

Acciones y Triggers LUA

Al seleccionar una respuesta, el sistema no solo pasa al siguiente nodo, sino que puede ejecutar eventos en el backend:

Client Event: Ejecuta un TriggerEvent('tu_evento', npcId)

Server Event: Ejecuta un TriggerServerEvent('tu_evento', npcId)

Raw LUA: Escribe código LUA directamente desde la interfaz. Ejemplo: SetEntityHealth(npcPed, 0) o dar un item mediante exports.

Notificaciones

Puedes elegir el estilo visual al responder: Default Info/Success/Error, notificaciones nativas de GTA, o notificaciones directas del Framework (QBCore/ESX).

Exports (API)

Consulta la base de datos de NPCs y Zonas desde tus otros scripts.

Todos estos exports deben llamarse desde el lado del servidor (Server-Side).

GetProfile

local profile = exports['fruti_npcmanager']:GetProfile('profile_id_aqui')

GetNPCs

local allNPCs = exports['fruti_npcmanager']:GetNPCs()

GetZones

local allZones = exports['fruti_npcmanager']:GetZones()

Obtener el resto de entidades

local dialogs = exports['fruti_npcmanager']:GetDialogs()
                                local routes = exports['fruti_npcmanager']:GetRoutes()
                                local props = exports['fruti_npcmanager']:GetProps()