Frameworks

ESX Legacy

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

• Itens: com o inventário padrão do ESX não há nada a fazer. O telemóvel adiciona os seus itens à tabela items do ESX no arranque, e a consola diz quais adicionou. O config/items/esx.sql existe se preferir adicioná-los à mão. Com outro inventário, veja a secção 4.
• Dinheiro: o banco é a conta bank do ESX, o dinheiro vivo é a conta money.
• Personagem: o telemóvel segue o identifier do jogador no ESX, por isso o esx_multicharacter funciona.
• Chefe: o posto chamado boss gere a empresa, salvo se definir bossGrade.
• Contas de empresa: esx_addonaccount / esx_society, ou um script de banca da secção 7.

QBCore

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

• Itens: nada a colar. O telemóvel adiciona os itens de que precisa aos shared items do QBCore no arranque, e a consola diz quais adicionou. Copie as imagens de config/items/images/ para qb-inventory/html/images/; a verificação de arranque indica as que faltarem.
• Dinheiro: bank e cash.
• Personagem: o citizenid, por isso o qb-multicharacter funciona.
• Chefe: os postos com isboss = true nos seus empregos, salvo se definir bossGrade.
• Contas de empresa: Renewed-Banking, qb-banking, ou o antigo qb-management.
• Multijob: com o ps-multijob a correr, os outros empregos do jogador aparecem em Services e um toque torna um emprego ativo.

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

• Itens: o Qbox usa o ox_inventory, que não aceita itens de outro script. Inicie o servidor uma vez: a verificação de arranque mostra as entradas em falta, prontas a colar em ox_inventory/data/items.lua (secção 4). As imagens vão para ox_inventory/web/images/.
• Dinheiro: bank e cash, através do qbx_core.
• Personagem: o citizenid.
• Chefe: os postos com isboss = true, salvo se definir bossGrade.
• Multijob: incluído. Os outros empregos de um jogador aparecem em Services.
• O qbx_core também responde como qb-core. É normal: o telemóvel trata os dois como um só framework.

ox_core

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

• Itens: inicie o servidor uma vez: a verificação de arranque mostra as entradas em falta, prontas a colar em ox_inventory/data/items.lua (secção 4). As imagens vão para ox_inventory/web/images/.
• Dinheiro: o banco é a conta ox_core da personagem. O dinheiro vivo é o item money no ox_inventory.
• Personagem: o charId.
• Empregos: os grupos do ox_core não têm indicador de serviço, por isso é o telemóvel que gere o serviço. A gestão de empresas (funcionários, contratações, postos) e o valet não estão disponíveis no 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

• Detetado sozinho quando o ND_Core está iniciado. Para o forçar: setr phone_framework nd.
• Itens: o ND usa o ox_inventory. Inicie o servidor uma vez: a verificação de arranque mostra as entradas em falta, prontas a colar em ox_inventory/data/items.lua (secção 4).
• Dinheiro: o bank da personagem no ND, e o cash do ND (o ox_inventory mantém o item money sincronizado).
• Personagem: o id da personagem no ND. O número de telemóvel mostrado é o do próprio ND quando a personagem tem um.
• Empregos: o emprego e a patente da personagem no ND. O ND não tem indicador de serviço, por isso todos contam como de serviço. A gestão de empresas, as contas de empresa e o valet não estão disponíveis no ND Core.
• Garagem: os carros próprios vêm da tabela nd_vehicles do ND.

vRP

Só o vRP 2 é suportado (não o vRP 1 nem forks da comunidade). O telemóvel carrega uma pequena extensão no vRP a partir de bridge/frameworks/vrp/. Nada para copiar.

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

• Itens: não há ficheiro de itens para o vRP, e o vRP 2 não consegue tornar itens utilizáveis para o telemóvel. Mantenha Config.Item.required = false (o padrão) e defina Config.Store.box = false para que a loja entregue os telemóveis diretamente. Os jogadores usam os itens de carregamento com /phonepack e /phonecable; com um inventário vRP, isso exige que o jogador tenha pulse_magpack e pulse_cable, por isso adicione os dois itens à sua lista de itens do vRP, ou defina Config.Charging.enabled = false.
• Dinheiro: o banco e a carteira do vRP.
• Personagem: o id da personagem no vRP.
• Empregos: a gestão de empresas e o valet não estão disponíveis no vRP. A app Garage fica vazia a menos que ligue um script de garagem.

TMC

O TMC vem incluído. O telemóvel reconhece sozinho o core do TMC: nenhum resource extra e nenhuma alteração a config/config.lua (auto, tmc e custom funcionam todos).

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

A verificação de arranque mostra Framework: TMC.

• Itens: adicione os itens do Pulse à lista de itens do TMC da mesma forma que adiciona qualquer item. Os nomes são phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (o config/items/tmc.lua tem as entradas) e, para as caixas da loja, pulse_phone_box mais uma por acabamento (pulse_phone_box_black ...). As etiquetas, pesos e descrições estão em config/items/qb-core.lua, e as imagens em config/items/images/. Um item que não esteja na lista é recusado, e o jogador vê "inventory full": a consola indica então o item. Uma caixa em falta na lista não impede a venda: a loja entrega esse telemóvel sem a caixa e indica-o na consola. Se não quiser caixas de todo, defina Config.Store.box = false.
• Dinheiro: o dinheiro vivo da personagem e o seu banco: o resource banking do TMC quando está a correr (a sua conta pessoal), caso contrário o dinheiro bancário do core. Se os seus números de conta não tiverem o formato BNK123456, indique o campo que guarda o número de conta em config/config.lua: Config.Providers.tmcBankAccount = 'charinfo.account' (use o seu próprio campo). A Wallet mostra um traço, nunca um valor inventado, quando o banco não pode ser lido.
• Personagem: o citizen id do TMC.
• Empregos: o emprego de serviço (ou o primeiro), com o posto e o estado de serviço.
• Tinha o conector temporário pulse_tmc? Remova ensure pulse_tmc e apague essa pasta. A consola lembra-o enquanto ainda estiver a correr.

Standalone (sem framework)

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

• Itens: não são precisos. Todos os jogadores têm um telemóvel, um Reserve e um cabo.
• Dinheiro: o telemóvel tem o seu próprio banco. Um jogador novo começa com 5000 (startingBalance em config/apps.lua).
• Personagem: a licença Rockstar do jogador.
• Empregos, carros e casas: o telemóvel gere os seus. Preencha-os com os comandos de teste da secção 9.

Framework personalizado ou feito internamente

1. Defina Config.Framework = 'custom' em config/config.lua.
2. Dê ao telemóvel uma tabela de bridge com o formato de optional-developer-kit/custom_framework_bridge.lua: seja como Config.Providers.custom em config/config.lua, seja a partir do seu próprio resource com exports.phone:RegisterFrameworkBridge(MyBridge).
3. Só o GetCharacterId é obrigatório. Se deixar de fora uma função de nome, emprego, licença ou lista de veículos/casas, o telemóvel age como se o seu servidor não tivesse esses dados. Se deixar de fora uma função de dinheiro ou de itens, essa ação é recusada: o telemóvel nunca paga a partir de um banco próprio. A app Bank só aparece quando a sua bridge tem GetBankBalance.
4. Se o seu core reiniciar enquanto o telemóvel continua a correr, chame exports.phone:FrameworkRestarted() assim que o core estiver pronto.

O bridge/frameworks/custom.lua mostra como o telemóvel usa a sua tabela. Para ligar outros scripts feitos internamente (um script de banca ou de garagem), veja optional-developer-kit/custom_provider_template.lua e Exports. Os dois modelos vêm no kit de programador opcional, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, e não na pasta do telemóvel.