Comment installer qb-phone sur FiveM : tutoriel complet 2026

qb-phone est le téléphone officiel du framework QBCore. Gratuit, open-source et bien intégré à l’écosystème QBCore, il propose messages, contacts, appels, banque, Twitter, jobs et bien plus. Dans ce guide complet, nous installons qb-phone étape par étape sur un serveur hébergé chez HebergTonServ, hébergeur FiveM spécialisé.

🎯 Ce que vous allez obtenir

Une fois installé, vos joueurs auront accès à :

• ✅ Messages entre joueurs
• ✅ Appels téléphoniques (avec pma-voice)
• ✅ Contacts (carnet d’adresses)
• ✅ Twitter intégré (tweets serveur)
• ✅ Banque (consultation/virement)
• ✅ Mail (job, factures)
• ✅ Jobs (gestion société)
• ✅ Garage (gestion véhicules)
• ✅ Houses (gestion logement)
• ✅ Crypto (système économique)
• ✅ Settings (sonneries, fond d’écran)

📋 Prérequis

Avant de commencer, vérifiez que vous avez :

• ✅ Serveur FiveM avec QBCore installé et fonctionnel
• ✅ qb-core à jour (dernière version)
• ✅ oxmysql installé (recommandé) ou mysql-async
• ✅ qb-apartments ou système de logement QBCore
• ✅ pma-voice (pour les appels, optionnel mais recommandé)
• ✅ Accès SFTP à votre serveur (HebergTonServ → panel → SFTP)
• ✅ Accès base de données (phpMyAdmin via panel)

🚀 Étape 1 — Télécharger qb-phone

Le repo officiel est sur GitHub :

• 🔗 github.com/qbcore-framework/qb-phone

Méthode 1 : ZIP direct

1. Allez sur le repo GitHub
2. Cliquez sur Code > Download ZIP
3. Extrayez localement

Méthode 2 : git clone (avancé)

git clone https://github.com/qbcore-framework/qb-phone.git

📤 Étape 2 — Upload sur votre serveur

1. Ouvrez FileZilla
2. Connectez-vous en SFTP (infos dans le panel HebergTonServ)
3. Naviguez vers resources/[qb]/
4. Glissez-déposez le dossier qb-phone extrait
5. Vérifiez la structure :

resources/
└── [qb]/
    ├── qb-core/
    ├── qb-phone/
    │   ├── client/
    │   ├── server/
    │   ├── html/
    │   ├── config.lua
    │   ├── fxmanifest.lua
    │   └── ...
    └── ...

🗃️ Étape 3 — Importer le SQL

qb-phone nécessite plusieurs tables MySQL.

1. Connectez-vous à phpMyAdmin depuis le panel HebergTonServ
2. Sélectionnez votre base de données
3. Onglet Importer
4. Importez le fichier qb-phone.sql (présent à la racine du dossier qb-phone, ou dans installation/)
5. Cliquez sur Exécuter

Tables créées :

• phone_messages
• phone_tweets
• phone_invoices
• phone_mails
• phone_app_chats
• playerappointments
• phone_gallery
• Etc.

💡 Astuce : si vous utilisez ox_inventory, ajoutez l’item phone dans qb-core/shared/items.lua (voir migration mysql-async vers oxmysql).

⚙️ Étape 4 — Ajouter l’ensure dans server.cfg

Ouvrez votre fichier server.cfg (via panel HebergTonServ ou SFTP) et ajoutez :

ensure qb-core
ensure oxmysql
ensure pma-voice
ensure qb-phone

⚠️ Important : qb-phone doit être chargé APRÈS qb-core et oxmysql.

🔧 Étape 5 — Configuration de base

Ouvrez qb-phone/config.lua et ajustez :

Langue

Config.Language = "fr"  -- "en" par défaut, créez locales/fr.lua

Sociétés disponibles

Config.Society = {
    ['police'] = true,
    ['ambulance'] = true,
    ['mechanic'] = true,
    -- ajoutez vos jobs custom
}

Apps actives

Config.Apps = {
    ['messages'] = true,
    ['phone'] = true,
    ['contacts'] = true,
    ['twitter'] = true,
    ['mail'] = true,
    ['settings'] = true,
    ['bank'] = true,
    ['camera'] = true,
    -- désactivez ce que vous ne voulez pas
}

Apparence

Config.PhoneColor = '#000000'
Config.LockScreenWallpaper = 'img/wallpapers/default.png'

🎨 Étape 6 — Personnaliser le téléphone (optionnel)

Changer le fond d’écran par défaut

1. Placez votre image dans qb-phone/html/img/wallpapers/
2. Modifiez Config.LockScreenWallpaper en conséquence

Ajouter des sonneries custom

1. Ajoutez fichiers .ogg dans qb-phone/html/sounds/
2. Référencez-les dans la config

Modifier le CSS

• Le HTML/CSS est dans qb-phone/html/
• Modifiez nui/style.css pour personnaliser

▶️ Étape 7 — Démarrer et tester

1. Dans le panel HebergTonServ, redémarrez votre serveur
2. Connectez-vous en jeu
3. Tapez la commande :

/phone

4. Ou utilisez la touche binding par défaut : F1

Le téléphone doit s’ouvrir.

🐛 Résolution des erreurs courantes

❌ “qb-phone could not start: missing dependency”

Cause : qb-core, oxmysql ou autre dépendance non démarrée avant. Fix : revoyez l’ordre des ensure dans server.cfg.

❌ “ERROR: phone_messages table not found”

Cause : SQL non importé. Fix : importez qb-phone.sql via phpMyAdmin.

❌ Téléphone s’ouvre mais écran noir

Cause : cache navigateur FiveM corrompu. Fix : tapez F8 > nui_devtools ou supprimez le cache FiveM (Settings > Clear Cache).

❌ Appels sans son

Cause : pma-voice non installé ou mal configuré. Fix : installez pma-voice et vérifiez son config.lua.

❌ “attempt to index a nil value (PlayerData)”

Cause : qb-core pas chargé ou joueur pas connecté correctement. Fix : redémarrez qb-core puis qb-phone.

🔒 Bonnes pratiques sécurité

• ✅ Activez les vérifications côté serveur pour les events sensibles (transferts bancaires)
• ✅ Limitez Config.MaxMessages pour éviter le spam DB
• ✅ Sauvegardez régulièrement (auto chez HebergTonServ)
• ✅ Surveillez les logs Discord webhook (voir webhook discord logs fivem)

🚀 Performance et optimisation

qb-phone est relativement léger mais peut générer beaucoup de requêtes MySQL si beaucoup de joueurs. Pour optimiser :

• Utilisez oxmysql (5x plus rapide que mysql-async)
• Activez le cache joueur dans qb-core
• Surveillez avec le profiler FiveM
• Sur un serveur 64+ slots, prévoyez minimum 8 Go de RAM — voir combien de RAM pour serveur FiveM

Un hébergement FiveM correctement dimensionné est crucial pour que qb-phone tourne sans latence.

📱 Alternatives à qb-phone

Si qb-phone ne vous convient pas :

• 🆓 gks-phone : alternative gratuite ESX/QBCore
• 💰 lb-phone : version premium polyvalente (voir installer lb-phone)
• 💰 roadphone : moderne et UX soignée
• 💰 yseries : tendance design Apple

🎓 Conclusion

Installer qb-phone sur FiveM prend environ 20-30 minutes : upload SFTP, import SQL, ajout dans server.cfg, configuration minimale. Le résultat est un téléphone fonctionnel et personnalisable pour vos joueurs RP.

Tester qb-phone sur notre hébergement FiveM dès 3,90 €/mois

Pour aller plus loin :

• 👉 Installer lb-phone (alternative premium)
• 👉 Configuration txAdmin FiveM ESX
• 👉 ESX ou QBCore : quel choisir
• 👉 Migrer mysql-async vers oxmysql