Frameworks

ESX Legacy

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

• Items : avec l'inventaire ESX par défaut, il n'y a rien à faire. Le téléphone ajoute ses items à la table items d'ESX au démarrage, et la console indique lesquels il a ajoutés. config/items/esx.sql est là si vous préférez les ajouter vous-même. Avec un autre inventaire, voir la section 4.
• Argent : la banque est le compte ESX bank, le liquide est le compte money.
• Personnage : le téléphone suit l'identifier du joueur ESX, donc esx_multicharacter fonctionne.
• Patron : le grade nommé boss gère l'entreprise, sauf si vous définissez bossGrade.
• Comptes d'entreprise : esx_addonaccount / esx_society, ou un script bancaire de la section 7.

QBCore

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

• Items : rien à coller. Le téléphone ajoute les items dont il a besoin aux items partagés de QBCore au démarrage, et la console indique lesquels il a ajoutés. Copiez les images de config/items/images/ vers qb-inventory/html/images/ ; la vérification au démarrage nomme celles qui manquent.
• Argent : bank et cash.
• Personnage : le citizenid, donc qb-multicharacter fonctionne.
• Patron : les grades avec isboss = true dans vos métiers, sauf si vous définissez bossGrade.
• Comptes d'entreprise : Renewed-Banking, qb-banking, ou l'ancien qb-management.
• Multi-métier : avec ps-multijob démarré, les autres métiers du joueur apparaissent dans Services et un seul geste rend un métier actif.

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 utilise ox_inventory, qui ne peut pas recevoir d'items d'un autre script. Démarrez le serveur une fois : la vérification au démarrage affiche les entrées manquantes, prêtes à coller dans ox_inventory/data/items.lua (section 4). Les images vont dans ox_inventory/web/images/.
• Argent : bank et cash, via qbx_core.
• Personnage : le citizenid.
• Patron : les grades avec isboss = true, sauf si vous définissez bossGrade.
• Multi-métier : intégré. Les autres métiers d'un joueur apparaissent dans Services.
• qbx_core répond aussi en tant que qb-core. C'est normal : le téléphone traite les deux comme un seul framework.

ox_core

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

• Items : démarrez le serveur une fois : la vérification au démarrage affiche les entrées manquantes, prêtes à coller dans ox_inventory/data/items.lua (section 4). Les images vont dans ox_inventory/web/images/.
• Argent : la banque est le compte ox_core du personnage. Le liquide est l'item money d'ox_inventory.
• Personnage : le charId.
• Métiers : les groupes ox_core n'ont pas d'indicateur de service, donc le téléphone gère lui-même le service. La gestion d'entreprise (personnel, recrutement, grades) et le voiturier ne sont pas disponibles sur 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

• Détecté automatiquement quand ND_Core est démarré. Pour le forcer : setr phone_framework nd.
• Items : ND utilise ox_inventory. Démarrez le serveur une fois : la vérification au démarrage affiche les entrées manquantes, prêtes à coller dans ox_inventory/data/items.lua (section 4).
• Argent : la bank ND du personnage, et le cash ND (ox_inventory garde l'item money synchronisé).
• Personnage : l'identifiant de personnage ND. Le numéro de téléphone affiché est celui de ND quand le personnage en a un.
• Métiers : le métier et le rang ND du personnage. ND n'a pas d'indicateur de service, donc tout le monde compte comme en service. La gestion d'entreprise, les comptes d'entreprise et le voiturier ne sont pas disponibles sur ND Core.
• Garage : les voitures possédées viennent de la table nd_vehicles de ND.

vRP

Seul vRP 2 est pris en charge (ni vRP 1 ni les forks de la communauté). Le téléphone charge une petite extension dans vRP depuis bridge/frameworks/vrp/. Rien à copier.

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

• Items : il n'y a pas de fichier d'items pour vRP, et vRP 2 ne peut pas rendre des items utilisables pour le téléphone. Gardez Config.Item.required = false (par défaut), et définissez Config.Store.box = false pour que la boutique remette directement les téléphones. Les joueurs utilisent les items de recharge avec /phonepack et /phonecable ; avec un inventaire vRP, le joueur doit avoir sur lui pulse_magpack et pulse_cable : ajoutez donc ces deux items à votre liste d'items vRP, ou définissez Config.Charging.enabled = false.
• Argent : la banque et le portefeuille de vRP.
• Personnage : l'identifiant de personnage vRP.
• Métiers : la gestion d'entreprise et le voiturier ne sont pas disponibles sur vRP. L'app Garage reste vide tant que vous ne connectez pas un script de garage.

TMC

TMC est intégré. Le téléphone reconnaît tout seul le core de TMC : aucune ressource supplémentaire, et aucune modification de config/config.lua (auto, tmc et custom fonctionnent tous).

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

La vérification au démarrage affiche Framework: TMC.

• Items : ajoutez les items Pulse à la liste d'items de TMC comme vous ajoutez n'importe quel item. Les noms sont phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (config/items/tmc.lua contient les entrées), et pour les boîtes de la boutique pulse_phone_box plus une par finition (pulse_phone_box_black ...). Les libellés, poids et descriptions sont dans config/items/qb-core.lua, et les images dans config/items/images/. Un item absent de la liste est refusé, et le joueur voit « inventaire plein » : la console nomme alors l'item. Un item de boîte absent de la liste n'empêche pas la vente : la boutique remet ce téléphone sans la boîte et l'indique dans la console. Si vous ne voulez pas du tout des boîtes, définissez Config.Store.box = false.
• Argent : le liquide du personnage, et sa banque : la ressource banking de TMC quand elle tourne (son propre compte personnel), sinon l'argent en banque du core. Si vos numéros de compte n'ont pas la forme BNK123456, indiquez le champ qui contient le numéro de compte dans config/config.lua : Config.Providers.tmcBankAccount = 'charinfo.account' (utilisez votre propre champ). Wallet affiche un tiret, jamais un montant inventé, quand la banque ne peut pas être lue.
• Personnage : le citizen id de TMC.
• Métiers : le métier en service (ou le premier), avec son grade et son état de service.
• Vous aviez le connecteur temporaire pulse_tmc ? Retirez ensure pulse_tmc et supprimez ce dossier. La console vous le rappelle tant qu'il tourne encore.

Standalone (sans framework)

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

• Items : aucun nécessaire. Chaque joueur a un téléphone, une Reserve et un câble.
• Argent : le téléphone gère sa propre banque. Un nouveau joueur commence avec 5000 (startingBalance dans config/apps.lua).
• Personnage : la licence Rockstar du joueur.
• Métiers, voitures et logements : le téléphone gère les siens. Remplissez-les avec les commandes de test de la section 9.

Framework personnalisé ou maison

1. Définissez Config.Framework = 'custom' dans config/config.lua.
2. Donnez au téléphone une table de bridge sur le modèle de optional-developer-kit/custom_framework_bridge.lua : soit en tant que Config.Providers.custom dans config/config.lua, soit depuis votre propre ressource avec exports.phone:RegisterFrameworkBridge(MyBridge).
3. Seule GetCharacterId est obligatoire. Si vous omettez une fonction de nom, de métier, de licence ou de liste de véhicules/logements, le téléphone se comporte comme si votre serveur n'avait pas ces données. Si vous omettez une fonction d'argent ou d'item, cette action est refusée : le téléphone ne paie jamais depuis une banque à lui. L'app Bank n'apparaît que si votre bridge a GetBankBalance.
4. Si votre core redémarre pendant que le téléphone continue de tourner, appelez exports.phone:FrameworkRestarted() une fois le core prêt.

bridge/frameworks/custom.lua montre comment le téléphone utilise votre table. Pour connecter d'autres scripts maison (un script bancaire ou de garage), voir optional-developer-kit/custom_provider_template.lua et Exports. Les deux modèles sont livrés dans le kit développeur facultatif, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, pas dans le dossier du téléphone.