Installation

Cette page décrit l'installation de Vcord, l'application de messagerie style Discord pour lb-phone.

Prérequis

Avant de commencer, assurez-vous que les ressources suivantes sont déjà installées et fonctionnelles sur votre serveur :

Ressource	Rôle
lb-phone	Téléphone hôte de l'application
ox_lib	Librairie partagée
oxmysql	Persistance des données

Un système vocal (PMA-Voice, Mumble, SaltyChat ou TokoVOIP) est optionnel : il n'est nécessaire que pour les canaux vocaux et est détecté automatiquement.

1. Ajouter la ressource

Placez le dossier lo_vcord dans le répertoire [phone] de vos ressources, aux côtés de lb-phone :

resources/
└── [phone]/
    ├── lb-phone/
    └── lo_vcord/

TIP

Placer l'application dans le même dossier [phone] que lb-phone garantit qu'elle est démarrée après le téléphone et détectée automatiquement par l'App Store.

2. Ordre de démarrage

Dans votre server.cfg, démarrez les ressources dans cet ordre. Les dépendances doivent toujours être lancées avant Vcord :

ensure oxmysql
ensure ox_lib
ensure lb-phone
ensure lo_vcord

WARNING

Si lo_vcord démarre avant ses dépendances, l'application ne s'enregistrera pas correctement auprès de lb-phone. Respectez impérativement cet ordre.

3. Base de données

Aucune importation SQL manuelle n'est requise : Vcord crée automatiquement ses tables au premier démarrage de la ressource, via oxmysql.

NOTE

Vérifiez simplement que oxmysql est correctement configuré (chaîne de connexion mysql_connection_string dans votre server.cfg) et démarré avant Vcord.

4. Interface (UI)

L'interface est déjà compilée et fournie avec la ressource dans ui/dist/. Aucun build n'est nécessaire : le fxmanifest.lua référence directement les fichiers de ui/dist/.

files {
    'ui/dist/index.html',
    'ui/dist/**/*',
    'locales/*.json'
}

L'application s'enregistre auprès de lb-phone comme application personnalisée (AddCustomApp) au démarrage ; elle apparaît ensuite dans l'App Store du téléphone.

TIP

Vous n'avez aucun outil de développement (Node, npm…) à installer. Téléchargez la ressource, démarrez-la, c'est prêt.

5. Webhooks Discord (optionnel)

Vcord peut envoyer des logs vers Discord via deux webhooks distincts, configurés dans config.lua :

Config.Webhooks = {
    -- Webhook pour les logs des SERVEURS (messages, channels, rôles, catégories)
    Server = "",
    -- Webhook pour les logs des MESSAGES PRIVÉS (DMs)
    DM = "",
}

1. Dans Discord, ouvrez Paramètres du salon → Intégrations → Webhooks → Nouveau webhook.
2. Copiez l'URL du webhook.
3. Collez-la entre les guillemets de Config.Webhooks.Server (logs serveur) et/ou Config.Webhooks.DM (logs des messages privés).

NOTE

Laissez une valeur vide ("") pour désactiver le webhook correspondant. Le détail des événements journalisés se règle dans Config.Logs (voir Configuration).

Vérification

1. Démarrez (ou redémarrez) votre serveur.
2. Vérifiez la console : aucune erreur liée à lo_vcord, oxmysql ou lb-phone.
3. Sur un joueur connecté, ouvrez le téléphone puis l'App Store : l'application Vcord doit apparaître.
4. Installez et ouvrez l'application : la page d'accueil doit se charger.
5. Confirmez la création des tables en base (au premier lancement) du côté de votre serveur MySQL.
6. Si vous avez configuré un webhook, envoyez un message de test et vérifiez qu'il apparaît bien dans Discord.

Si l'application n'apparaît pas, revérifiez l'ordre de démarrage et que la ressource se trouve bien dans [phone].

Étapes suivantes

• Configuration — adapter config.lua à votre serveur.