Frameworks

ESX Legacy

ensure oxmysql
ensure es_extended
# ... your ESX scripts, inventory, banking ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• Items: con el inventario por defecto de ESX no hay nada que hacer. El teléfono añade sus items a la tabla items de ESX al iniciar, y la consola indica cuáles añadió. Tienes config/items/esx.sql por si prefieres añadirlos tú. Con otro inventario, consulta la sección 4.
• Dinero: el banco es la cuenta bank de ESX, el efectivo es la cuenta money.
• Personaje: el teléfono sigue el identifier del jugador de ESX, así que esx_multicharacter funciona.
• Jefe: el rango llamado boss gestiona la empresa, salvo que configures bossGrade.
• Cuentas de empresa: esx_addonaccount / esx_society, o un script de banca de la sección 7.

QBCore

ensure oxmysql
ensure qb-core
# ... qb-inventory and your other qb scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• Items: nada que pegar. El teléfono añade los items que necesita a los shared items de QBCore al iniciar, y la consola indica cuáles añadió. Copia las imágenes de config/items/images/ a qb-inventory/html/images/; la comprobación de inicio nombra las que falten.
• Dinero: bank y cash.
• Personaje: el citizenid, así que qb-multicharacter funciona.
• Jefe: los rangos con isboss = true en tus trabajos, salvo que configures bossGrade.
• Cuentas de empresa: Renewed-Banking, qb-banking o el antiguo qb-management.
• Multitrabajo: con ps-multijob en marcha, los demás trabajos del jugador aparecen en Services y con un toque se activa un trabajo.

Qbox

ensure oxmysql
ensure qbx_core
ensure ox_inventory
# ... your other Qbox scripts, in Qbox's own order ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• Items: Qbox usa ox_inventory, que no acepta items de otro script. Inicia el servidor una vez: la comprobación de inicio muestra las entradas que faltan, listas para pegar en ox_inventory/data/items.lua (sección 4). Las imágenes van en ox_inventory/web/images/.
• Dinero: bank y cash, a través de qbx_core.
• Personaje: el citizenid.
• Jefe: los rangos con isboss = true, salvo que configures bossGrade.
• Multitrabajo: integrado. Los demás trabajos de un jugador aparecen en Services.
• qbx_core también responde como qb-core. Es normal: el teléfono trata los dos como un solo framework.

ox_core

ensure oxmysql
ensure ox_core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• Items: inicia el servidor una vez: la comprobación de inicio muestra las entradas que faltan, listas para pegar en ox_inventory/data/items.lua (sección 4). Las imágenes van en ox_inventory/web/images/.
• Dinero: el banco es la cuenta de ox_core del personaje. El efectivo es el item money de ox_inventory.
• Personaje: el charId.
• Trabajos: los grupos de ox_core no tienen indicador de servicio, así que el teléfono lleva el servicio por sí mismo. La gestión de empresas (personal, contratación, rangos) y el valet no están disponibles en ox_core.

ND Core

ensure oxmysql
ensure ox_lib
ensure ND_Core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• Se detecta solo cuando ND_Core está iniciado. Para forzarlo: setr phone_framework nd.
• Items: ND usa ox_inventory. Inicia el servidor una vez: la comprobación de inicio muestra las entradas que faltan, listas para pegar en ox_inventory/data/items.lua (sección 4).
• Dinero: el bank de ND del personaje y el cash de ND (ox_inventory mantiene el item money sincronizado).
• Personaje: el id de personaje de ND. El número de teléfono que se muestra es el propio de ND cuando el personaje tiene uno.
• Trabajos: el trabajo y el rango de ND del personaje. ND no tiene indicador de servicio, así que todos cuentan como de servicio. La gestión de empresas, las cuentas de empresa y el valet no están disponibles en ND Core.
• Garaje: los coches en propiedad salen de la tabla nd_vehicles de ND.

vRP

Solo es compatible vRP 2 (no vRP 1 ni los forks de la comunidad). El teléfono carga una pequeña extensión en vRP desde bridge/frameworks/vrp/. Nada que copiar.

ensure oxmysql
ensure vrp
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• Items: no hay archivo de items para vRP, y vRP 2 no puede hacer que los items sean usables para el teléfono. Deja Config.Item.required = false (el valor por defecto) y pon Config.Store.box = false para que la tienda entregue los teléfonos directamente. Los jugadores usan los items de carga con /phonepack y /phonecable; con un inventario de vRP, eso requiere que el jugador lleve pulse_magpack y pulse_cable, así que añade los dos items a tu lista de items de vRP, o pon Config.Charging.enabled = false.
• Dinero: el banco y la cartera de vRP.
• Personaje: el id de personaje de vRP.
• Trabajos: la gestión de empresas y el valet no están disponibles en vRP. La app Garage se queda vacía salvo que conectes un script de garajes.

TMC

TMC viene integrado. El teléfono reconoce el core de TMC por sí solo: sin resource extra y sin cambios en config/config.lua (auto, tmc y custom funcionan todos).

ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

La comprobación de inicio muestra Framework: TMC.

• Items: añade los items de Pulse a la lista de items de TMC igual que añades cualquier item. Los nombres son phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (config/items/tmc.lua tiene las entradas), y para las cajas de la tienda pulse_phone_box más una por acabado (pulse_phone_box_black ...). Las etiquetas, pesos y descripciones están en config/items/qb-core.lua, y las imágenes en config/items/images/. Un item que no está en la lista se rechaza, y el jugador ve "inventory full": entonces la consola nombra el item. Si falta un item de caja en la lista, la venta no se detiene: la tienda entrega ese teléfono sin la caja y lo indica en la consola. Si no quieres cajas en absoluto, pon Config.Store.box = false.
• Dinero: el efectivo del personaje y su banco: el resource banking de TMC cuando está en marcha (su propia cuenta personal), o si no, el dinero del banco del core. Si tus números de cuenta no tienen la forma BNK123456, indica el campo que contiene el número de cuenta en config/config.lua: Config.Providers.tmcBankAccount = 'charinfo.account' (usa tu propio campo). Wallet muestra un guion, nunca una cifra inventada, cuando no se puede leer el banco.
• Personaje: el citizen id de TMC.
• Trabajos: el trabajo de servicio (o el primero), con su rango y su estado de servicio.
• ¿Tenías el conector temporal pulse_tmc? Quita ensure pulse_tmc y borra esa carpeta. La consola te lo recuerda mientras siga en marcha.

Standalone (sin framework)

ensure oxmysql
ensure pma-voice
ensure screenshot-basic
ensure phone

• Items: no hace falta ninguno. Cada jugador tiene un teléfono, un Reserve y un cable.
• Dinero: el teléfono tiene su propio banco. Un jugador nuevo empieza con 5000 (startingBalance en config/apps.lua).
• Personaje: la licencia de Rockstar del jugador.
• Trabajos, coches y viviendas: el teléfono los gestiona por sí mismo. Rellénalos con los comandos de prueba de la sección 9.

Framework personalizado o propio

1. Pon Config.Framework = 'custom' en config/config.lua.
2. Dale al teléfono una tabla de bridge con la forma de optional-developer-kit/custom_framework_bridge.lua: como Config.Providers.custom en config/config.lua, o desde tu propio resource con exports.phone:RegisterFrameworkBridge(MyBridge).
3. Solo GetCharacterId es obligatoria. Si omites una función de nombre, trabajo, licencia o lista de vehículos/viviendas, el teléfono actúa como si tu servidor no tuviera esos datos. Si omites una función de dinero o de items, esa acción se rechaza: el teléfono nunca paga desde un banco propio. La app Bank solo aparece cuando tu bridge tiene GetBankBalance.
4. Si tu core se reinicia mientras el teléfono sigue en marcha, llama a exports.phone:FrameworkRestarted() en cuanto el core esté listo.

bridge/frameworks/custom.lua muestra cómo usa el teléfono tu tabla. Para conectar otros scripts propios (un script de banca o de garajes), consulta optional-developer-kit/custom_provider_template.lua y Exports. Las dos plantillas vienen en el kit para desarrolladores opcional, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, no en la carpeta del teléfono.