Handset (beta)

Handset es el teléfono dentro del juego para servidores FiveM, hecho por CursedTech. Es gratis con CAdmin y por ahora está en beta.

Qué hace:

• contactos y un número de teléfono para cada personaje;
• mensajes uno a uno, incluidas ubicaciones compartidas;
• llamadas a través de pma-voice;
• una cámara y una galería;
• una app de staff de CAdmin con las alertas que te asignan.

El teléfono está en inglés, español y portugués de Brasil.

Tu servidor de juego sigue al mando de todo: los números de teléfono, los mensajes, las llamadas y las fotos viven en tu servidor y en tu base de datos, no en CursedTech.

Beta. Handset funciona, pero es nuevo. Pruébalo en un servidor de pruebas antes de activarlo para tus jugadores y cuéntanos lo que encuentres (consulta "Obtener ayuda" más abajo).

Qué necesitas

• CAdmin conectado a tu network, con el instalador de CursedTech (versión 0.3.0 o posterior). Consulta Primeros pasos.

• Para el modo in-place, FXServer build 35245 o posterior. En un build anterior, el instalador solo deja las versiones preparadas para que las copies a mano.

• oxmysql con MariaDB o MySQL.

• pma-voice 7.x, para las llamadas. Sin él, el teléfono funciona y las llamadas aparecen como no disponibles.

• Opcional, para la cámara:

  • screenshot-basic. Lo instalas tú; el instalador no lo hace.
  • La dirección pública https:// de tu servidor de juego, para las fotos (handset_photo_origin, más abajo).

  Sin ambos, la cámara y la galería quedan desactivadas y todo lo demás funciona.

Instalación

Handset se instala y se actualiza con el instalador de CursedTech, igual que CAdmin. No copias archivos a mano.

Disponible con el instalador 0.3.0. La entrega de Handset necesita el instalador de CursedTech 0.3.0 o posterior, que se está publicando ahora. Hasta que tu instalador indique 0.3.0, estos pasos todavía no se aplican.

1. Activa Handset para el servidor en el dashboard

Primero el dashboard muestra lo que encontró en el servidor:

• cualquier otro teléfono;
• si screenshot-basic está presente;
• si pma-voice está en ejecución.

Confirma ahí.

2. Permite la instalación en server.cfg

El instalador solo instala Handset cuando tu propio server.cfg lo permite. El dashboard puede pedirlo, pero no puede instalar nada por sí mismo:

set handset_install 1

set handset_install 0, o ninguna línea, significa que el instalador nunca descarga ni toca Handset.

3. Modo in-place: crea la carpeta una vez

La mayoría de los servidores usan el modo in-place del instalador. FXServer no deja que el instalador cree la carpeta de un resource, así que la creas tú una vez, a mano (con el administrador de archivos de txAdmin, o en el disco).

Crea la carpeta:

resources/[cursedtech]/cursedtech_handset/

Agrega un archivo provisional. La carpeta debe contener un archivo llamado fxmanifest.lua cuando el servidor inicie, con exactamente este contenido:

fx_version 'cerulean'
game 'gta5'
version '0.0.0'

La versión 0.0.0 lo marca como provisional, y el instalador lo reemplaza por la versión firmada.

Agrega la línea de permiso. En el bloque de CursedTech de server.cfg, antes de ensure cursedtech, agrega la línea de Handset junto a la de CAdmin:

add_filesystem_permission cursedtech write cadmin
add_filesystem_permission cursedtech write cursedtech_handset
add_ace resource.cursedtech command.refresh allow
add_ace resource.cursedtech command.ensure allow
add_ace resource.cursedtech command.stop allow
add_ace resource.cursedtech command.start allow
set cursedtech_mode "inplace"
set handset_install 1
ensure cursedtech

No agregues ensure cadmin ni ensure cursedtech_handset: el instalador inicia lo que instala. Asegúrate de que oxmysql y pma-voice se inicien en server.cfg antes de ensure cursedtech.

Reinicia el servidor. Entonces el instalador verifica la versión firmada de Handset y la instala. Para actualizarlo a mano más adelante, ejecuta cursedtech update cursedtech_handset en la consola del servidor.

4. Activa el teléfono

set handset_enabled 1

Cualquier otro valor, o ninguna línea, mantiene el teléfono totalmente apagado.

5. Inicia el servidor

En el primer inicio, Handset crea sus tablas en la base de datos, todas con el nombre handset_.... Nunca modifica, elimina ni reescribe otras tablas. Si ya existe una tabla handset_ con una estructura distinta, la app afectada queda desactivada y la consola del servidor explica por qué.

Las actualizaciones llegan de la misma forma y nunca bajan de versión. Tus fotos y ajustes se conservan, y los jugadores mantienen sus propias teclas asignadas.

Teclas

Los jugadores abren y cierran el teléfono con F1. Es la única tecla que Handset usa mientras el teléfono está cerrado.

Mientras el teléfono está abierto:

• los jugadores se mueven por él con las flechas o el teclado numérico;
• Enter selecciona y Backspace vuelve atrás;
• Home va a la pantalla de inicio;
• caminar y conducir siguen funcionando.

Contestar y colgar, el obturador de la cámara y el cursor del mouse funcionan dentro del teléfono. Los jugadores que quieran una tecla para alguna de esas acciones la asignan ellos mismos en los ajustes del juego, en las teclas de FiveM. Todas las teclas aparecen en el teléfono, en Ajustes > Atajos.

Junto a otro teléfono

Si tu servidor ya usa otro teléfono (por ejemplo lb-phone, qb-phone, npwd o gksphone), Handset nunca lo toca. Tú eliges qué ocurre con handset_coexist:

Valor	Qué ocurre
unbound (predeterminado)	Handset funciona junto al otro teléfono. Su tecla de apertura no tiene valor predeterminado; los jugadores asignan la suya
ignore	Handset funciona con normalidad y con sus teclas predeterminadas. Úsalo cuando vas a pasarte solo a Handset
off	Handset permanece apagado mientras el otro teléfono funcione, y se activa solo cuando ya no esté

Handset no registra ningún ítem de teléfono ni el comando /phone. Para quedarte solo con Handset, detén o elimina tú el otro teléfono.

Configuración

Ajuste	Predeterminado	Qué hace
handset_enabled	0	1 activa el teléfono
handset_install	sin definir	1 permite que el instalador instale y actualice Handset
handset_coexist	unbound	comportamiento junto a otro teléfono (ver arriba)
handset_photo_origin	sin definir	la dirección pública de tu servidor de juego, solo como https://host (sin puerto, ruta ni credenciales), desde la que el teléfono carga las fotos. Sin ella, la cámara y la galería quedan desactivadas
handset_photo_bytes_max	2 GB	almacenamiento total de fotos en este servidor. Al llegar al tope se rechazan las fotos nuevas; no se borra nada
handset_number_format	###-####	patrón del número de teléfono, donde # es un dígito
handset_call_channel_base	4000	primer canal de llamadas de pma-voice que usa Handset. Mantén libre ese rango
handset_key_toggle	F1	tecla predeterminada para abrir y cerrar. Vacío significa sin asignar; los jugadores siempre pueden reasignarla

Elige el formato de número antes de que tu primer jugador abra el teléfono. Los números ya entregados nunca se reescriben, y un número que ya no cumple el patrón no se puede escribir.

Límites en esta versión:

• 200 contactos y 200 fotos por personaje, a 600 KB por foto;
• mensajes de hasta 500 caracteres;
• 20 mensajes y 6 llamadas salientes por minuto por personaje;
• las llamadas suenan durante 30 segundos.

Lo que los jugadores deben saber

Puedes mostrar este texto a tus jugadores, o adaptarlo:

Los contactos, mensajes, historial de llamadas y fotos de tu teléfono se guardan en este servidor de juego. El staff no lee el contenido del teléfono. Puedes borrar tus propias fotos en la Galería.

El staff no ve mensajes, listas de llamadas, contactos ni fotos en CAdmin. Esta versión no tiene un botón para reportar mensajes o fotos.

Fuera de esta versión

• mensajes grupales;
• fotos en los mensajes;
• una app de mapas;
• reportar un mensaje o una foto;
• modo streamer;
• alojamiento de fotos por CursedTech;
• vincular un teléfono real;
• la app de despacho.

Una ubicación compartida aparece como "Ubicación compartida", sin nombre de calle.

Límites conocidos de esta beta

• Cámara y galería: necesitan tu propio screenshot-basic y handset_photo_origin. Todavía no se han probado en un servidor en vivo con una dirección https real.
• Guardado de fotos interrumpido: si el servidor se detiene mientras se guarda una foto, la galería puede mostrar una entrada sin su imagen. Elimina esa entrada en la Galería.
• Frameworks: en el juego, Handset se ha probado con ESX. QBCore, Qbox y CLRPV2 son compatibles y se prueban de forma automática, pero todavía no se han jugado.
• Rendimiento: el rendimiento en el cliente todavía no se ha medido en un cliente real del juego. Las pruebas de carga del lado del servidor pasan.
• Instalador: las actualizaciones in-place en servidores Windows todavía no están probadas. Las actualizaciones grandes tardan alrededor de un minuto.
• Llamadas y mensajes entre jugadores: probados con jugadores de prueba automáticos, todavía no entre dos clientes reales del juego.
• Otras apps: ninguna app de terceros está aprobada por defecto, y la aprobación se aplica a todo el servidor.
• Comprobación de la pantalla del teléfono: la comprobación más estricta del origen de los mensajes de la pantalla del teléfono se está implementando. En esta versión solo registra.

Obtener ayuda

Ejecuta la comprobación del propio teléfono. En la app Teléfono, marca *#0*#. Handset ejecuta sus diagnósticos (pantalla, teclas, ida y vuelta con el servidor, almacenamiento, notificaciones, mensajes, llamadas y reloj) y muestra un resumen. Marca *#06# para ver la versión y el id del dispositivo del teléfono.

Contacta con soporte. Usa tu canal habitual de soporte de CAdmin e incluye:

• la versión de Handset (desde *#06#);
• el resumen de los diagnósticos;
• lo que hiciste;
• cualquier línea de la consola F8 o de la consola del servidor.

Nunca envíes claves de licencia, tokens ni contraseñas.