Documentación de Pulse Phone

Pulse Phone — Guía rápida

Instala un solo resource llamado phone. Mantén tu framework actual y los scripts compatibles; Pulse los detecta al iniciar.

Para Pulse Phone 1.4.24 min de lecturaActualizado el

PhoneHub + Pulse es una edición aparte con su propia licencia y su propia copia de este teléfono. Si compraste esa edición, sigue su propia guía de instalación: un servidor usa un solo resource de teléfono.

1. Revisa tu servidor

Qué ¿Necesario?
OneSync activado, game build 2699 o superior Obligatorio
Una base de datos: oxmysql (o mysql-async, ghmattimysql) sobre MariaDB 10.6+ o MySQL 8 Recomendado. Sin un resource SQL, el teléfono guarda sus datos en el almacén clave/valor del servidor
Un resource de voz: pma-voice, mumble-voip, SaltyChat, TokoVOIP o YACA Recomendado. Sin uno, las llamadas conectan pero no hay audio
screenshot-basic Recomendado, para que la cámara pueda guardar fotos. El resource estándar funciona
Un framework y un inventario Opcional. Sin ellos, el teléfono funciona en modo standalone

Inicia tu base de datos, framework, inventario, resource de voz y screenshot-basic antes que Pulse. Consulta los requisitos y tu framework para ver el orden correcto.

Haz una copia de seguridad de tu base de datos antes del primer inicio. Pulse crea sus propias tablas. Si otro teléfono dejó tablas con los mismos nombres, se renombran a old_<name> (no se borra nada); los detalles están en los requisitos.

2. Copia la carpeta phone

Descarga tu compra desde tu cuenta de Cfx.re. Copia la carpeta phone que contiene fxmanifest.lua en los resources de tu servidor. Conserva su nombre. La clave de tu servidor debe pertenecer a la cuenta dueña del asset.

Si subes por FTP (un servidor en hosting): usa el modo Binary (FileZilla: Transfer > Transfer Type > Binary), o sube el zip y extráelo en el servidor. El modo Auto modifica los archivos bloqueados y el teléfono se niega a arrancar; los síntomas y la solución están en Solución de problemas. La carpeta que subas debe coincidir con esta tabla; la comprobación de inicio nombra cualquier archivo que falte o tenga un tamaño incorrecto.

La descarga de Pulse Phone 1.4.2:

Carpeta o archivo Archivos Tamaño
ui/ 3,932 78.3 MB
stream/ 40 30.5 MB
config/ 138 23.2 MB
d6c1e95a/ (el código bloqueado; su nombre cambia en cada versión) 7 5.5 MB
data/ 2 1.4 MB
bridge/ 55 0.5 MB
guides/ 13 0.2 MB
phone.sql 1 0.2 MB
fxmanifest.lua 1 6 KB
carpeta phone completa 4,204 139.7 MB

¿Actualizas una instalación existente? Sigue primero Actualizar para conservar los ajustes y los archivos multimedia de los jugadores. Detén el resource del teléfono anterior antes de cambiar a Pulse.

3. Añade los items al inventario

Abre Inventarios y sigue las instrucciones del inventario que ya usas. Las definiciones e imágenes incluidas están en config/items/. Añade las entradas a tu inventario; no sustituyas su archivo de items completo.

El inventario por defecto de ESX y QBCore pueden registrar automáticamente las definiciones que falten. Otros inventarios pueden necesitar las entradas incluidas. Copia las imágenes de los items donde las espera tu inventario. En standalone sin inventario no hacen falta items.

4. Inicia Pulse

Deja la detección automática en config/config.lua. La primera sección contiene el framework, el idioma, la selección de inventario, el item del teléfono y las teclas. Los ajustes opcionales están indexados en Configuración.

Añade esto después de tus dependencias actuales en server.cfg:

server.cfg
ensure phone
add_ace group.admin phone.admin allow

Reinicia el servidor. Pulse crea sus tablas de base de datos cuando la conexión SQL está disponible. Lee su comprobación en la consola y sigue las instrucciones de corrección que aparezcan. Ejecuta phone:health para repetirla.

5. Abre tu teléfono

Entra como administrador, abre F8 y escribe phone:setup. Confirma el framework y el inventario detectados y completa la configuración guiada. Pulsa F1 o usa /phone para abrir el teléfono. Si tu configuración requiere un item, compra primero un teléfono y usa su caja desde el inventario.

Los ajustes guardados en Settings → Server tienen prioridad sobre los ajustes equivalentes de los archivos. Restablece ahí un ajuste guardado si quieres que vuelva a aplicarse el valor del archivo.

6. Opcional: el screenshot-basic más ligero

Tu descarga también contiene una carpeta screenshot-basic. Es el screenshot-basic de CitizenFX (licencia MIT) con un cambio: el original redibuja la imagen del juego para su capa de captura en cada frame, aunque nadie esté haciendo una foto, y esta copia solo dibuja mientras se está haciendo una foto. El nombre del resource, sus exports (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) y sus eventos no cambian, y viene ya compilado, así que no necesita compilarse en el primer inicio. Los archivos modificados están en screenshot-basic/ZERODEV-CHANGES.md.

Pulse funciona con cualquiera de las dos copias, así que este paso es opcional. Otros scripts de tu servidor también usan screenshot-basic, así que haz el cambio primero en un servidor de pruebas si tienes uno:

  1. Renombra tu carpeta screenshot-basic actual (por ejemplo a screenshot-basic.bak) y sácala de resources, para poder volver a ponerla.
  2. Copia la nuestra en resources con el mismo nombre, screenshot-basic, y mantén la misma línea ensure screenshot-basic.
  3. Reinicia el servidor y prueba todos los scripts que hacen capturas: la cámara del teléfono y cualquier herramienta de informes, pruebas o bodycam que uses.
  4. Si algo se comporta de forma distinta, borra nuestra copia, vuelve a poner tu carpeta antigua como screenshot-basic y reinicia.

Configura las funciones que uses

  • Llamadas, vídeo y Live: resources de voz compatibles, controles de llamada y configuración de la conexión de vídeo en producción.
  • Fotos y vídeos: almacenamiento integrado, FiveManage y otras opciones de subida. Las claves privadas de los servicios se quedan en la configuración de tu servidor. En un servidor en hosting cuyo puerto web no es accesible, las fotos necesitan FiveManage: dos líneas en server.cfg (set phone_media_provider "fivemanage" y set phone_fivemanage_token "<token>").
  • Configuración: tiendas, apps, accesorios, idiomas y funciones opcionales.
  • Solución de problemas: busca el síntoma y sigue su solución.
  • Integraciones para desarrolladores: scripts personalizados y ajustes de conexión avanzados.

Una instalación normal no requiere editar bridge/, ui/ ni stream/. Mantén el resource completo junto, incluidos sus modelos y assets de mapa.

Traducido del inglés. Si algo de aquí no coincide con la página en inglés, la página en inglés es la correcta. English