Mantén un script de FiveM conservando una versión reproducible, probando sus flujos de juego reales y manteniendo una reversión funcional. Que un recurso se inicie sin errores es solo la primera comprobación; los permisos, la persistencia y las rutas de fallo importan igual.
Registra la línea base de trabajo
Enumera la versión o el commit del recurso, la compilación de FXServer, el framework, el inventario, el controlador de la base de datos y los cambios de configuración. Mantén el código fuente editable en un repositorio privado y las credenciales fuera de él. Conserva el paquete con licencia original y las instrucciones de actualización del autor.
Usa un servidor de prueba aislado con una base de datos separada y acceso restringido. Deshabilita la entrega de pagos reales, los webhooks de producción y otras acciones externas en el entorno de prueba.
Revisa cada actualización antes de instalarla
- Lee las notas de la versión y compara la configuración, las dependencias, las exportaciones, los eventos y el SQL modificados. Identifica los cambios incompatibles con la versión anterior antes de reemplazar los archivos.
- Haz una copia de seguridad de la base de datos actual y de los archivos de recursos/configuración correspondientes. Confirma que la copia de seguridad se puede restaurar en la instancia de prueba.
- Aplica la actualización a la instancia de prueba en el orden requerido por el autor. Fusiona la configuración deliberadamente; no sobrescribas ciegamente los nuevos valores predeterminados con un archivo antiguo.
- Ejecuta escenarios normales y de fallo, luego compara los resultados persistidos después de la reconexión y el reinicio.
Usa un registro de prueba de juego
Para cada acción importante, registra el estado inicial, los pasos, el resultado esperado y el resultado observado. Para una compra en una tienda: el jugador tiene un saldo conocido, compra un artículo conocido, recibe exactamente un artículo, pierde exactamente su precio definido por el servidor y mantiene ese resultado después de la reconexión.
Repite con fondos insuficientes, inventario lleno, acceso no autorizado, nombres de artículos no válidos, solicitudes repetidas y una desconexión durante la operación. Para un garaje, prueba la propiedad, la prevención de duplicados de aparición y el almacenamiento después del reinicio. Para trabajos, prueba las restricciones de rango y servicio.
Inspecciona la seguridad y el rendimiento por separado
Revisa los eventos de red para la validación del lado del servidor de permisos, propiedad, cantidades y finalización de tareas. Un fallo crítico de autorización bloquea el lanzamiento, independientemente del buen rendimiento en otros aspectos.
Usa el monitor de recursos del cliente para el tiempo de los scripts del cliente y el perfilador de FXServer para el trabajo del servidor. Registra la escena, el número de jugadores y la duración. Compara cargas de trabajo idénticas; no impongas un presupuesto universal de milisegundos a recursos no relacionados.
Automatiza las comprobaciones que detectan errores reales
Ejecuta comprobaciones de sintaxis/lint de Lua adecuadas para el entorno de ejecución de FiveM y pruebas enfocadas para la lógica pura. Las pruebas de framework simuladas ayudan a detectar desajustes de argumentos y retornos, pero no verifican el framework real, el inventario o la integración de la base de datos. Mantén una lista de verificación del servidor de prueba en vivo junto a ellas.
Despliega un cambio reversible
Elige una ventana de mantenimiento, anuncia la interrupción esperada y ten lista la versión anterior. Actualiza solo el paquete revisado y las dependencias requeridas. Reinicia en el orden documentado, verifica los registros y repite el escenario clave del juego.
Si la verificación falla, detén las nuevas escrituras antes de la recuperación. Restaura el código coincidente y cualquier dato necesario, teniendo en cuenta los cambios realizados después de la copia de seguridad. No borres silenciosamente el progreso del jugador para que una prueba pase.
Mantén un informe de incidencia útil
Registra el primer error relevante, el recurso/versión afectado, los pasos de reproducción y el comportamiento esperado. Oculta las credenciales y los identificadores personales en los registros. Realiza un seguimiento de la resolución en el historial de cambios del recurso para que la próxima actualización pueda repetir la misma comprobación de regresión.
Documentación de referencia
Cfx.re — seguridad del servidor · Cfx.re — usando el profiler