Uso

Abrir el teléfono#

Los jugadores abren el teléfono con una tecla o usando el ítem del teléfono. Cada tecla es un key binding de FiveM, así que los jugadores pueden cambiarla en Settings → Key Bindings → FiveM; los valores de abajo son solo los predeterminados.

Config.Phone = {
    openKey = 'F1',
    openByKeyPress = true,      -- false = only the item opens the phone
    requireItem = true,         -- false = everyone has a phone, no item needed
    itemName = 'phone',
    blockWhenRestricted = true, -- no phone while handcuffed
}

Con blockWhenRestricted, el teléfono no se puede abrir ni usar para llamadas mientras el jugador está esposado. La comprobación lee los indicadores habituales de esposas; para adaptarla a tu script de policía, edita framework:isPhoneRestricted() en custom/<framework>/client.lua y server.lua.

Pear, Nova y plegables#

El teléfono tiene dos skins de sistema: Pear y Nova. Cada una cambia el marco del dispositivo, las pantallas del sistema y el aspecto de las apps. En la config, Pear es 'ios' y Nova es 'android'. Config.Platform.mode decide cómo consigue un jugador cada una:

Config.Platform.default es la skin de los teléfonos que nunca eligieron una.

Teléfonos plegables#

Dos modelos plegables, cada uno con su propio ítem: phone_duo (Pear, pantalla exterior corta y ancha, pantalla interior horizontal) y phone_fold (Nova, pantalla exterior alta y estrecha, pantalla interior casi cuadrada). Siempre abren su propia skin, en ambos modos.

Config.Fold = {
    iosItemName = 'phone_duo',      -- false = disabled
    androidItemName = 'phone_fold', -- false = disabled
    key = 'T',
    disableControl = 245,           -- the GTA control on the same key (245 = chat); false = none
}

• Usa el ítem para abrir el teléfono. La primera vez, se abre plegado en la pantalla exterior.

• Pulsa T con el teléfono totalmente abierto para plegarlo o desplegarlo. No hace nada mientras escribes en un campo de texto, mientras hay un juego abierto, en la vista rápida o con el teléfono apagado.

• Cada teléfono recuerda si se dejó plegado o desplegado.

• El teléfono en la mano del jugador se pliega y despliega con la pantalla, y toma el color de marco elegido en Settings como los demás teléfonos.

• La tecla de plegado solo se configura en Config.Fold.key (una letra o un número). A diferencia de la tecla de abrir, los jugadores no pueden cambiarla en los key bindings de FiveM. disableControl bloquea el control de GTA en esa tecla mientras hay un plegable abierto.

Números de teléfono y tarjetas SIM#

Con Config.MetaSystem.enabled = true (por defecto), cada ítem de teléfono es su propio dispositivo: su propio número, contactos, mensajes, fotos y ajustes. Si le das el teléfono a otra persona, tendrá tu teléfono, protegido solo por tu código y Face Unlock.

Si lo pones en false, los datos pertenecen al personaje y cualquier ítem de teléfono muestra los mismos datos.

Config.MetaSystem = {
    enabled = true,
    phoneNumberPrefix = '555',          -- always a string: use '06', not 06
    phoneNumberLength = 7,              -- digits after the prefix
    phoneNumberMask = '(XXX) XXX-XXXX', -- X = digit; must add up to prefix + length
}

Para un número al estilo francés, usa el prefijo '06', longitud 8 y máscara 'XX XX XX XX XX'.

Números de servicio#

Números fijos que hacen sonar a la vez a todos los jugadores conectados con el trabajo adecuado. El primero en contestar toma la llamada. Aparecen en los contactos y favoritos de todos los jugadores, y nadie necesita ser su dueño.

Config.ServiceNumbers = {
    enabled = true,
    lines = {
        { number = '911', label = 'Emergency Services', avatar = '', jobs = { 'police', 'ambulance' }, minGrade = 0 },
        { number = '912', label = 'Police',             avatar = '', jobs = { 'police' },              minGrade = 0 },
        { number = '913', label = 'EMS',                avatar = '', jobs = { 'ambulance' },           minGrade = 0 },
    },
}

Llamadas#

Las llamadas de voz pasan por tu script de voz; las videollamadas necesitan el servidor TURN de Instalación. Las llamadas entrantes aparecen en la Dynamic Island y los jugadores pueden contestar con Q sin abrir el teléfono.

Cambiar a video. Durante una llamada de voz, cualquiera de los dos puede pedir activar el video. La otra persona elige Switch o Keep Audio, también con Q / E con el teléfono cerrado, y la llamada continúa sin colgar. Una solicitud sin respuesta caduca a los 30 segundos; añade videoUpgradeTimeoutMs a Config.PhoneCall para cambiarlo (mínimo 5000).

SOS de emergencia#

Cuando un jugador muere, el teléfono hace una cuenta atrás de 10 segundos con una alarma y luego envía por mensaje la ubicación del jugador a todos los médicos de servicio. El jugador puede cancelarlo durante la cuenta atrás, o enviarlo manualmente con /sos. Usa tu script de ambulancia automáticamente (consulta Integraciones).

Config.SOS = {
    enabled = true,
    jobs = { 'ambulance' }, -- who receives the SOS
    minGrade = 0,
    healthThreshold = 0,    -- 0 = only on death; > 0 = also below this health
    cooldownSeconds = 90,
    countdownSeconds = 10,
    alertSound = 'alarm',
}

Batería y carga#

La batería se descarga lentamente con el teléfono cerrado, más rápido con él abierto, y aún más rápido en apps pesadas. Al 0% el teléfono no tiene señal, así que las llamadas y las apps online dejan de funcionar hasta que se carga. El nivel se guarda con el teléfono.

Cambia el consumo de cualquier app en Config.Battery.apps, o desactiva todo el sistema con Config.Battery.enabled = false. Los jugadores cargan de tres formas:

Señal#

El mapa tiene zonas de cobertura con cuatro niveles de señal: full, mid, low y none. Fuera de cualquier zona la señal es completa. Las zonas por defecto cubren Mount Chiliad, Raton Canyon, las colinas de Tongva, el túnel de Humane Labs, el mar alrededor de Cayo Perico y otros lugares remotos.

Añade una zona (por ejemplo, un MLO en un sótano) en Config.Signal.zones con coordenadas, un radio y un nivel. Configura Config.Signal.debug = true para ver las zonas en el juego, y Config.Signal.enabled = false para desactivar la señal.

Auriculares, compartir y almacenamiento#

Auriculares inalámbricos#

Usar wireless_earbuds muestra una tarjeta de emparejamiento y después la música, los videos y las llamadas solo se reproducen para el dueño. Los auriculares se descargan mientras se usan (unas 4.5 horas con carga completa) y se recargan en su estuche; el estuche se carga con el teléfono. Al 0% el audio vuelve al altavoz. Los ajustes están en Config.Earbuds.

Compartir con jugadores cercanos#

Un menú de compartir envía contactos, fotos (hasta 20 a la vez) y más a jugadores a menos de 10 m, que aceptan o rechazan. Cámbialo en Config.ShareSheet.

Almacenamiento#

Cada teléfono tiene 8 GB. Las apps ocupan su tamaño al instalarse, una foto unos 4 MB y un video unos 32 MB. Cuando se llena, los jugadores borran apps o archivos multimedia, o compran ampliaciones de 64 GB y 128 GB en la Peach Store. Configúralo en config/appstorage.lua; enabled = false elimina el límite.

Las apps#

Estas apps vienen instaladas en todo teléfono nuevo. Añádelas, quítalas o restríngelas a un trabajo en Config.PhoneApplications.

Estas se descargan desde la App Store y están listadas en config/store.lua. Una app con price cuesta dinero descargarla.

Cualquier app de ambas listas acepta job (un nombre o una lista), minGrade o grades para limitar quién puede usarla. Config.HomeScreenDefaults define el dock, las carpetas y la primera página de un teléfono nuevo, y Config.StoreDownload.secondsPerMb define cuánto tardan las descargas.

Ajustes de las apps#

Cada app con una regla del lado del servidor tiene su propio bloque en config/main.lua.

Config.Wallet = {
    account = 'bank',      -- account used for transfers
    minAmount = 1,
    maxAmount = 999999,
    allowSendById = false, -- true = also send money by the recipient's server ID
}

Config.Messages = {
    PaymentAccount = 'money', -- account used for money sent in a chat
    PaymentMin = 1,
    PaymentMax = 999999,
    PaymentCurrencySymbol = '$',
    AllowUnknownNumbers = true, -- true = New Message accepts any number in the city, not only contacts
}

Config.Mail = {
    emailSuffix = '@cloud.com',                   -- must start with @
    systemFromEmail = '[email protected]', -- sender of script mail
    systemFromName = 'Mail',
}

Config.BillJobs = { 'police', 'ambulance' }

Config.BillingJobs = { -- icon shown next to a bill from that job
    police = { label = 'LSPD', icon = 'f7:shield_fill' },
    ambulance = { label = 'EMS', icon = 'f7:cross_case_fill' },
}

Config.BillingFallbackAvatar = 'f7:doc_text_fill'

{
    id = 5003,
    name = 'Bennys Motorworks',
    description = 'Performance tuning, repairs, and custom work.',
    job = { 'mechanic' },
    coords = vec3(-205.7, -1310.7, 31.3),
    image = 'https://...',
},

Config.Valet = true                  -- valet in the Garages app
Config.ValetPrice = 1000
Config.IcarValetPaymentAccount = 'bank'

Config.Weazel.publishJobs = { -- who can write articles
    { name = 'police', grades = { 0, 1, 2, 3, 4 } },
}

Config.JobCenter = {
    { job = 'taxi', label = 'Taxi Driver', description = 'Pick up riders and earn fares.', Coords = vec2(909.49, -177.24) },
}

Config.OnionBrowser.Payment = {
    method = 'crypto', -- 'crypto' or 'bank'
    coin = 'qsc',
    account = 'bank',
}
Config.OnionBrowser.Market.blockedItems = { 'money', 'black_money', 'id_card' }
Config.OnionBrowser.Delivery.collectMinutes = 30

Config.Camera = {
    AllowWalking = true,                 -- walk while the camera is open
    Recording = { MaxDurationSeconds = 60 },
}

Config.ProximityCapture = { enabled = true, radius = 12.0 } -- nearby voices in videos

Config.Map.maxCustomMarkers = 200

Config.RadioPrivateChannels = { -- private channels for the Radio DLC
    { label = 'Police Channel', frequency = 113, password = '3983221' },
}

Config.DefaultOptimization = { -- set all to false for low-end PCs
    blur = true,
    filterAnimations = true,
    motionAnimations = true,
}

Config.PhoneAnimations = {
    enabled = true,         -- false = the phone plays no animation on the character
    watchdog = true,        -- restore the holding animation if another script clears it
    blockInVehicle = false, -- true = no phone animation inside vehicles
    disableInPeek = true,   -- true = no animation while the phone only peeks (calls, notifications)
    states = {},            -- per-state overrides: opening, holding, calling, speaking, peek
}

states = {
    holding = { dict = 'cellphone@', clip = 'cellphone_text_read_base', flag = 49 },
},

Reinicia qs-smartphone después de cualquier cambio en la config. Los ajustes que los jugadores eligen en su teléfono (fondo de pantalla, idioma, tema) se guardan por teléfono y no se restablecen al reiniciar.