Documentación de Pulse Phone

Detalles de instalación

Para Pulse Phone 1.4.26 min de lecturaActualizado el

1. Instalación rápida

Antes de copiar nada

Usa un artifact de servidor que cumpla los requisitos de abajo, OneSync activado y game build 2699 o superior. Para un servidor de roleplay normal, ten funcionando primero tu framework, inventario, oxmysql, resource de voz y screenshot-basic. Standalone también funciona sin framework; ahí los items de inventario son opcionales.

Descarga el resource desde tu cuenta de Cfx.re después de reclamar la compra. Usa la clave de servidor que pertenece a la cuenta dueña del asset. Si Cfx.re informa de un error de entitlement, arregla la asociación cuenta/clave; cambiar los ajustes del teléfono no puede conceder el entitlement.

Paso 1 — Pon el resource en tu servidor

Extrae el paquete y copia la carpeta del resource phone, que contiene fxmanifest.lua, en el directorio resources de tu servidor. No le cambies el nombre ni pongas en su lugar la carpeta exterior del ZIP/paquete.

En un servidor en hosting, sube en modo Binary o sube el zip y extráelo allí (por qué). La guía rápida (paso 2) indica el número de archivos y el tamaño de cada carpeta para esta build, y la comprobación de inicio nombra cualquier archivo que falte o tenga un tamaño incorrecto.

Detén tu resource de teléfono anterior antes de probar Pulse, para que dos teléfonos no compitan por la misma tecla y el mismo item. Haz una copia de seguridad de sus datos si piensas importarlos más adelante.

Paso 2 — Añade los items a tu inventario

Elige tu inventario actual; no necesitas sustituirlo.

Tu inventario Acción necesaria
ox_inventory Abre el archivo incluido config/items/ox_inventory.lua. Añade sus entradas a ox_inventory/data/items.lua, dentro de la tabla existente. No sustituyas el archivo completo del inventario. Conserva la entrada phone propia de ox_inventory: al usarla se abre Pulse Phone, y la línea Phone item de la comprobación de inicio lo confirma. Sustitúyela por la entrada que se muestra solo cuando esa línea diga que abre otro script. Copia las imágenes de config/items/images/ a ox_inventory/web/images/. Reinicia el servidor después de editar.
qb-inventory con QBCore Las definiciones de items que faltan se registran automáticamente al iniciar. Copia config/items/images/ a qb-inventory/html/images/. Si tu inventario requiere entradas compartidas permanentes, el config/items/qb-core.lua incluido está listo para añadir a qb-core/shared/items.lua.
Inventario por defecto de ESX Los items que faltan se añaden automáticamente. Si la consola pide un reinicio, reinicia una vez para que ESX los lea. Si tu cuenta de base de datos no puede añadirlos, usa config/items/esx.sql.
qs-inventory u otro inventario compatible Sigue la fila breve de tu inventario en Items e inventarios. Usa su propia lista de items y su carpeta de imágenes.
Standalone sin inventario No hacen falta entradas de inventario. Deja desactivados los requisitos de item.

La comprobación de inicio identifica las entradas que faltan y muestra solo las definiciones que aún necesitas. Un inventario que carga las definiciones de items al iniciar, como ox_inventory, necesita las entradas de arriba; Pulse no sobrescribe los archivos de otro resource.

Paso 3 — Revisa la configuración principal

Abre config/config.lua. Los valores por defecto detectan tu configuración actual:

Lua
Config.Framework = 'auto'

Deja inventory = 'auto' en la tabla Config.Providers existente. Si tienes varios resources de inventario, pon en ese valor el inventario que quieres usar, como 'ox_inventory'. No añadas una segunda tabla Config.Providers o Config.Item al final del archivo.

En la tabla Config.Item existente elige cómo funcionan los teléfonos:

Ajuste Qué hace
required = false, unique = false Cada personaje tiene un teléfono sin llevar ningún item. Útil para tu primera prueba.
required = true, unique = false El personaje necesita un item phone para abrir su propio teléfono. Regalar ese item no transfiere sus datos.
unique = true Cada item de teléfono tiene su propio número y sus propios datos. Pasar el item transfiere ese teléfono. Requiere ox_inventory, qb-inventory, qs-inventory, core_inventory o codem-inventory.
name = 'phone' Nombre del item en el inventario. Mantenlo salvo que cambies también la definición de item incluida.

Los teléfonos únicos siguen el bridge de inventario seleccionado. Deja Config.Item.inventory = 'auto'; esta sustitución antigua es solo para instalaciones avanzadas existentes. Config.Providers.inventory tiene prioridad cuando se define explícitamente.

No cambies Config.IdentityScope en un servidor existente. El valor por defecto, 'character', mantiene separados los teléfonos de los distintos personajes.

Opcional: teléfonos de inventario y servicio de pago

Para exigir un item de teléfono distinto para cada teléfono, pon required = true y unique = true dentro de la tabla Config.Item existente en config/config.lua, después de añadir las entradas de inventario. Usa uno de los inventarios de teléfonos únicos indicados arriba.

Para vender servicio de telefonía, pon Config.Carrier.enabled = true en el mismo archivo. Esto activa la app Carrier, donde los jugadores compran su plan. Los teléfonos nuevos necesitan un plan antes de tener llamadas normales, mensajes y apps de datos móviles. App Hub es donde los jugadores instalan apps, no la tienda del servicio. Pon Config.Coverage.enabled = true si también quieres zonas de cobertura. La cobertura y los planes de pago son opciones separadas; deja cualquiera de las dos desactivada si no quieres esa función.

Edita los ajustes existentes en lugar de añadir tablas duplicadas. Reinicia el servidor después de guardar. Si un ajuste del juego se guardó antes, restablécelo en Settings → Server para que se aplique el valor de tu archivo.

Paso 4 — Inicia las dependencias antes que Pulse

Mantén la conexión de base de datos y los ajustes de framework que ya tienes. Añade solo las líneas que falten; no inicies una segunda copia de ninguna dependencia.

Usa este orden con los resources que ya tienes instalados en tu servidor:

  1. El resource de base de datos y sus ajustes de conexión actuales.
  2. El framework y sus librerías necesarias, resources de identidad y de personajes.
  3. El inventario, con la configuración de ese inventario para tu framework.
  4. Un resource de voz compatible y screenshot-basic.
  5. ensure phone.

No instales ESX, QBCore ni otro inventario solo para Pulse. Elige tu configuración actual en Tu framework para ver su ejemplo concreto de orden de inicio. Qbox se detecta como Qbox aunque otro resource use sus exports compatibles con QBCore.

Para el acceso de administrador de Pulse, añade add_ace group.admin phone.admin allow. Tu cuenta de administrador ya debe pertenecer a group.admin para que se aplique ese permiso.

Paso 5 — Lee la comprobación del primer inicio

Reinicia el servidor. Pulse muestra un informe de inicio y crea sus tablas de base de datos automáticamente cuando la conexión SQL está disponible.

  • FIX / FAIL: una parte necesaria no puede funcionar. Sigue la línea de corrección antes de dejar que los jugadores lo usen.
  • NOTE / WARN: lee qué función se ve afectada; algunos avisos describen funciones opcionales que no has configurado.
  • Ejecuta phone:health en la consola del servidor para repetir la comprobación.
  • Ejecuta phone:diag para ver el framework, el inventario y los proveedores elegidos.
  • Como admin, entra, abre F8 y ejecuta phone:setup para la configuración guiada.

Los ajustes guardados en la configuración de admin del juego tienen prioridad sobre los ajustes equivalentes de los archivos. Si parece que se ignora un cambio en un archivo, revisa Settings → Server y restablece ese ajuste guardado antes de cambiar más archivos.

Paso 6 — Prueba como jugador

  1. Carga un personaje, pulsa F1 y completa la configuración del teléfono. Si los requisitos de item están activados, compra primero un teléfono en la tienda o da al personaje el item de teléfono configurado.
  2. Si compraste una caja precintada, usa la caja desde el inventario para desembalarla y termina la configuración. El teléfono llega encendido; con Config.Device.arrivesOn = false mantén primero End u O.
  3. Abre Messages, Contacts y Phone. Vuelve al inicio, abre el selector de apps y cierra cada app una tras otra.
  4. Haz una foto y un vídeo corto. Ábrelos en Photos, cierra y vuelve a abrir el teléfono, y confirma que siguen ahí.
  5. Vuelve a conectarte y comprueba que el mismo personaje sigue teniendo el mismo teléfono. Prueba las llamadas con un segundo jugador usando tu resource de voz instalado.

Dónde cambiar las cosas

Qué quieres cambiar Archivo o lugar
Framework, proveedor de inventario, item del teléfono, tienda, modelos, asignación de teclas config/config.lua
Proveedor de voz config/config.lua
Ajustes de apps y de servicios/trabajos config/apps.lua
Entradas de inventario e imágenes config/items/
Conexión de base de datos, orden de inicio de los resources, credenciales del hosting de multimedia server.cfg (mantén las credenciales privadas en el lado del servidor)
Integraciones para desarrolladores Integraciones avanzadas, el Developer Kit opcional (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) y los archivos bridge/ existentes; una instalación normal no requiere editarlos
Fotos y vídeos de los jugadores con el almacenamiento integrado media/; conserva esta carpeta al actualizar

Las secciones de abajo contienen la referencia detallada. No necesitas leer todos los ajustes de cada función para terminar la primera instalación.

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