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.
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:
ensure phone
add_ace group.admin phone.admin allowReinicia 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:
- Renombra tu carpeta
screenshot-basicactual (por ejemplo ascreenshot-basic.bak) y sácala deresources, para poder volver a ponerla. - Copia la nuestra en
resourcescon el mismo nombre,screenshot-basic, y mantén la misma líneaensure screenshot-basic. - 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.
- Si algo se comporta de forma distinta, borra nuestra copia, vuelve a poner tu carpeta antigua como
screenshot-basicy 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"yset 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.