Para crear un servidor FivePD, comience con un FXServer que funcione, descargue el paquete FivePD de una fuente confiable, lea las notas de instalación del paquete, instale sus dependencias declaradas, agregue los recursos a server.cfg, y pruebe el recurso base antes de agregar llamadas. No copie ciegamente una base de datos antigua o un ejemplo de configuración: las distribuciones y complementos de FivePD no utilizan los mismos archivos, capa de almacenamiento o versiones de dependencia.
Revisado el 12 de agosto de 2026 según la documentación oficial de Cfx.re para configurando FXServer, recursos, manifiestos de recursos y comandos del servidor. Los nombres de archivo y las dependencias específicas de FivePD deben verificarse en el archivo exacto que instale.
Lo que necesita antes de descargar FivePD
- Una instancia limpia de FXServer que se inicie correctamente sin FivePD.
- Una clave de servidor Cfx.re válida y acceso a la consola del servidor.
- Un servidor de prueba o de ensayo separado. No experimente con la única copia en vivo.
- El archivo FivePD, su README o documentación, y cada dependencia nombrada allí.
- Una copia de seguridad de
server.cfg, la configuración de recursos y cualquier base de datos utilizada por el paquete.
Si el servidor FiveM subyacente aún no está listo, siga primero la configuración oficial de FXServer. Un paquete de servidor FivePD puede acortar la ruta de inicio, mientras que las opciones del servidor FiveM cubren compilaciones de servidor más amplias. En cualquier caso, verifique los archivos y requisitos incluidos en lugar de asumir que cada paquete tiene el mismo diseño.
Paso 1: pruebe que el FXServer base funciona
Inicie FXServer con una configuración mínima y conéctese una vez antes de instalar FivePD. Confirme que el servidor aparece, la consola está libre de fallas de inicio y un cliente puede unirse. Esto separa un problema de FXServer, firewall o clave de servidor de un problema de FivePD.
Registre el artefacto actual y las versiones de los recursos. Cfx.re recomienda artefactos de servidor actuales, pero cambiar el artefacto, la compilación del juego, el marco y el paquete FivePD en un solo intento dificulta el aislamiento de las fallas. Cambie una capa a la vez.
Paso 2: inspeccione la descarga de FivePD
Extraiga el archivo fuera del directorio resources en vivo primero. Busque su fxmanifest.lua o manifiesto heredado, README, archivos de configuración y declaraciones de dependencia. La carpeta de recursos colocada debajo de resources debe ser la carpeta que contiene el manifiesto; un directorio de archivo adicional encima de él es una razón común para “recurso no encontrado”.
Consulte el archivo para obtener instrucciones sobre importaciones de bases de datos, cadenas de conexión, permisos y orden de carga. Algunos paquetes o extensiones pueden necesitar almacenamiento en la base de datos; otros no. Solo cree esquemas o pegue SQL cuando el paquete instalado lo requiera explícitamente. Nunca publique contraseñas de bases de datos en un script de cliente, configuración compartida o repositorio público.
Paso 3: instalar dependencias antes del recurso principal
Coloque cada dependencia requerida en su propio directorio de recursos. Confirme que su nombre coincida con el manifiesto y la ensure línea que planea usar. Si la documentación especifica un orden, inicie las bibliotecas compartidas y los puentes de la base de datos antes de FivePD, luego inicie las llamadas después del recurso base.
Una forma de configuración simple es:
# Start required libraries first
ensure required_dependency
# Start the FivePD resource after its dependencies
ensure fivepd
# Add one compatible callout only after the base test passes
ensure example_calloutEstos nombres son ilustrativos. Use los nombres reales de directorio y recurso de su descarga. El comando de Cfx.re ensure inicia un recurso detenido o reinicia uno que ya está en ejecución.
Paso 4: configurar valores del lado del servidor de forma segura
Realice la configuración más pequeña necesaria para un primer inicio. Mantenga las credenciales y la configuración privilegiada en el lado del servidor. Cuando el paquete proporcione valores predeterminados, copie el ejemplo distribuido y cambie solo las claves documentadas. No invente campos de configuración de un tutorial no relacionado: una clave mal escrita puede ignorarse silenciosamente y una opción antigua puede que ya no exista.
Si se requiere una base de datos, use un usuario de base de datos dedicado con solo los permisos necesarios. Importe el esquema correspondiente del paquete una vez, luego confirme que las tablas existen. Una importación exitosa de SQL no prueba que el recurso pueda conectarse, así que verifique la consola del servidor durante el inicio.
Paso 5: probar el recurso base antes de las llamadas
- Inicie el servidor con dependencias y FivePD, pero sin llamadas opcionales.
- Observe el registro completo del servidor desde el descubrimiento de recursos hasta el inicio.
- Únase con un cliente limpio e inspeccione la consola F8 en busca de errores del cliente.
- Confirme solo los comandos e interfaces base documentados.
- Reinicie el recurso y vuelva a conectarse para exponer problemas de orden de carga o persistencia.
Luego agregue una llamada, reinicie y pruébela. Repita una a la vez. Una llamada escrita para otra compilación de FivePD puede fallar incluso cuando el recurso base está sano; mantenga la última versión funcional disponible para revertir.
Fallos comunes de instalación de FivePD
| Síntoma | Primero verifique | Siguiente acción segura |
|---|---|---|
| Recurso no encontrado | La carpeta que contiene fxmanifest.lua y el exacto ensure nombre |
Corrija el nivel del directorio o el nombre del recurso, luego vuelva a escanear/reiniciar |
| Dependencia o exportación faltante | La dependencia está instalada, es compatible y se inició primero | Usar la versión declarada del paquete y el orden de carga |
| Error de conexión a la base de datos | Valor de conexión solo del servidor, usuario de la base de datos y esquema requerido | Probar el acceso desde el servidor y comparar con la documentación del paquete |
| La base funciona, pero una llamada falla | Compatibilidad de la llamada y sus propias dependencias | Deshabilitar esa llamada y volver a la base que se sabe que funciona |
| El cliente se une, pero UI o los comandos fallan | Errores F8 y archivos de cliente faltantes en el manifiesto | Verificar el manifiesto de recursos y los archivos del navegador/NUI |
Orden de actualización segura
Haga una copia de seguridad del recurso en funcionamiento y sus datos, lea las notas de la versión, actualice en el entorno de prueba y vuelva a probar la base antes de las llamadas opcionales. No sobrescriba una configuración personalizada sin compararla. Si una actualización cambia la base de datos, conserve tanto el volcado previo a la actualización como la versión exacta del paquete necesaria para restaurarla.
Esta secuencia es deliberadamente conservadora: primero FXServer, luego las dependencias, luego FivePD, luego una llamada. Le da a cada falla un área de búsqueda pequeña y hace posible la reversión sin reconstruir todo el servidor.
