CS Stories

CS Stories añade historias en vídeo de duración limitada a tu teléfono FiveM. Los jugadores graban vídeos cortos dentro del juego y los comparten en un feed de historias. Es un recurso independiente que funciona con cualquier framework y se puede conectar a cualquier teléfono basado en NUI de Lua. Viene con una extensa configuración, eventos, exports y algunos archivos fuente de cliente y servidor para que puedas personalizarlo.

Características

• Historias de vídeo breves y temporales con la ubicación y el nombre dentro del juego de quien las sube
• Las historias se muestran durante 24 horas por defecto y se guardan en el almacenamiento durante 24 horas por defecto; duración máxima de 30 segundos por defecto (unos 5 MB por vídeo de máxima duración sin miniatura); límite de tasa para proteger tu almacenamiento
• Los jugadores pueden eliminar sus propias historias; los jugadores autorizados pueden eliminar las historias de cualquiera
• Feed de historias simple con navegación completa por ratón y teclado
• Cambiar entre cámara trasera y delantera; modo de cámara experimental que permite al jugador moverse mientras graba
• Filtros de color (escala de grises, sepia, negativo, saturación y más) y filtros de imagen con seguimiento facial de ped en tiempo real (perro, gato y más)
• Se adapta a diferentes resoluciones de pantalla
• Muchos eventos y exports para comprobar y controlar el recurso
• Integraciones de teléfono incluidas: gcphone y qb-phone (también utilizables para teléfonos basados en ellos); las integraciones se pueden ajustar o crear para otros teléfonos
• Recurso opcional complementario cs-historias-dw para publicar historias en Discord para moderación o registro (sigue las políticas de webhooks de Discord)

Requisitos

• Un teléfono basado en NUI de Lua y el hilo recurso
• El servidor de alojamiento incluido es obligatorio. Almacena vídeos, miniaturas y metadatos, por lo que necesita red, ancho de banda y almacenamiento, además de un puerto TCP abierto adicional (35540 por defecto). También está disponible como una aplicación de node.js externa (cs-stories-ehs) que puedes ejecutar en otra máquina.
• Si tu teléfono usa fx_version "cerulean", enruta el servidor de alojamiento a través de HTTPS (por ejemplo, con un dominio y Cloudflare) o cambia el fx_version del teléfono a "bodacious".

Instalación

• Cerciorarse hilo está en tu carpeta de recursos, coloca cs-stories en tus resources y añade ensure cs-stories a la configuración de tu servidor antes que tu teléfono.
• En el archivo de tu teléfono __resource.lua o fxmanifest.lua, agregue '@cs-stories/client/hooks/core.lua' como el último script del cliente y '@cs-stories/server/hooks/core.lua' como el último script del servidor.
• En el archivo NUI de tu teléfono (normalmente index.html), agregar <script type="text/javascript" src="nui://cs-stories/client/hooks/core.js"></script> justo antes </body>.
• Lee todas las opciones en config.js y ajústalos a tu configuración.
• Con el servidor de alojamiento interno, abre el puerto TCP (35540 por defecto, entrante) en tu firewall.
• Ejecutar refresh y ensure cs-stories. Si tu teléfono utiliza un bucle de animación, añade un not CS_STORIES.ACTIVE comprueba antes de reproducir la animación, luego asegúrate de que tu teléfono.
• Con el servidor de alojamiento externo: instálalo con npm install, configura su config.js, ejecútalo con node (por ejemplo, con pm2) y añade su dirección IP a sv_proxyIPRanges en la configuración de tu servidor.

Información importante

• Se les pide a los jugadores la aprobación del micrófono. Si la deniegan por error, deben eliminar %AppData%\CitizenFX\media_access.json para reiniciarlo.
• Solo se graba la voz del jugador que está grabando, utilizando el micrófono predeterminado del sistema. El habla se detecta con la función nativa integrada; con un VoIP externo como TokoVoip, necesitas editar el gancho.
• Un jugador grabando no puede moverse (comportamiento predeterminado de la cámara GTA V) a menos que uses el modo de cámara experimental.
• Es posible que se producen retrasos o bloqueos en el renderizado de vídeo a resoluciones muy altas o en sistemas de muy bajos recursos.
• La grabación utiliza la captura del juego: todo en el juego se graba, incluidos los ajustes visuales y MODIFICACIONES y UI de juego, pero no NUIs.
• Si tu servidor funciona detrás de un proxy inverso que no puede gestionar un puerto TCP adicional, aloja el servidor de historias externamente en una máquina diferente.
• La subida y visualización de historias utiliza el ancho de banda de los jugadores y del servidor de alojamiento. Si tu servidor de alojamiento tiene un ancho de banda limitado, comprueba tu uso y almacenamiento regularmente.
• Los metadatos de las historias se almacenan en almacenamiento KV de FiveM,; en una configuración de múltiples servidores compartidos, establece sv_kvsName a algo único.
• Se comprueban el vídeo y la ubicación, pero dado que el cliente los envía, no se puede confiar plenamente en ellos.
• Las historias caducadas se eliminan cuando se inicia el recurso, por lo que la limpieza depende de la frecuencia con la que reinicies.

Solución de problemas

• Errores al ver o subir: revisa la nota sobre HTTPS/fx_version anterior. De lo contrario, la causa suele ser el bloqueo de TCP, una configuración de red compleja o protección anti-DDoS; prueba con un puerto alto diferente y asegúrate de que esté abierto para TCP, o aloja el servidor de historias externamente.
• Sin botón de la aplicación de historias: asegúrate de usar el hook correcto para tu teléfono y de que sus eventos y elementos DOM coincidan. Algunos hooks añaden la aplicación a la tienda de aplicaciones del teléfono en lugar de a la pantalla de inicio.
• yarn se sigue reinstalando: Editar package.json, añade o elimina un espacio y guárdalo.