Pour créer un serveur FivePD, commencez par un FXServer fonctionnel, téléchargez le package FivePD depuis une source fiable, lisez les notes d'installation du package, installez ses dépendances déclarées, ajoutez les ressources à server.cfg, et testez la ressource de base avant d'ajouter des interventions. Ne copiez pas aveuglément une ancienne base de données ou un exemple de configuration : les distributions et les modules complémentaires FivePD n'utilisent pas tous les mêmes fichiers, couche de stockage ou versions de dépendances.
Ce dont vous avez besoin avant de télécharger FivePD
- Une instance FXServer propre qui démarre avec succès sans FivePD.
- Une clé de serveur Cfx.re valide et un accès à la console du serveur.
- Un serveur de staging ou de test séparé. N'expérimentez pas sur la seule copie en production.
- L'archive FivePD, son README ou sa documentation, et toutes les dépendances qui y sont nommées.
- Une sauvegarde de
server.cfg, la configuration des ressources et toute base de données utilisée par le package.
Si le serveur FiveM sous-jacent n'est pas encore prêt, suivez le guide de configuration du serveur txAdmin d'abord. Vérifiez les fichiers et les exigences de la distribution FivePD réelle avant de l'installer.
Étape 1 : prouver que le FXServer de base fonctionne
Démarrez FXServer avec une configuration minimale et connectez-vous une fois avant d'installer FivePD. Confirmez que le serveur apparaît, que la console est exempte d'échecs de démarrage et qu'un client peut se connecter. Cela sépare un problème FXServer, de pare-feu ou de clé de serveur d'un problème FivePD.
Enregistrez les versions actuelles des artefacts et des ressources. Cfx.re recommande les artefacts de serveur actuels, mais changer l'artefact, la version du jeu, le framework et le package FivePD en une seule tentative rend les échecs difficiles à isoler. Changez une couche à la fois.
Étape 2 : inspectez le téléchargement FivePD
Extrayez d’abord l’archive hors du répertoire resources en production. Repérez son fichier fxmanifest.lua ou son ancien manifeste, son README, ses fichiers de configuration et ses déclarations de dépendances. Le dossier de ressource placé dans resources doit contenir le manifeste ; un dossier d’archive supplémentaire au-dessus de lui est une cause fréquente de l’erreur « resource not found ».
Consultez les archives pour obtenir des instructions sur les importations de bases de données, les chaînes de connexion, les autorisations et l'ordre de chargement. Certains paquets ou extensions peuvent nécessiter un stockage de base de données ; d'autres non. Ne créez des schémas ou ne collez SQL que lorsque le paquet installé l'exige explicitement. Ne publiez jamais les mots de passe de base de données dans un script client, une configuration partagée ou un dépôt public.
Étape 3 : installer les dépendances avant la ressource principale
Placez chaque dépendance nécessaire dans son propre répertoire de ressource. Vérifiez que son nom correspond au manifeste et à la ligne ensure que vous comptez utiliser. Si la documentation impose un ordre, démarrez les bibliothèques partagées et les passerelles de base de données avant FivePD, puis démarrez les interventions après la ressource de base.
Une forme de configuration simple est :
# Start required libraries first
ensure required_dependency
# Start the FivePD resource after its dependencies
ensure fivepd
# Add one compatible callout only after the base test passes
ensure example_calloutCes noms sont des exemples. Utilisez les vrais noms de répertoires et de ressources de votre téléchargement. La commande ensure de Cfx.re démarre une ressource arrêtée ou redémarre une ressource déjà en cours d’exécution.
Étape 4 : configurer les valeurs côté serveur en toute sécurité
Effectuez la configuration minimale nécessaire pour un premier démarrage. Conservez les identifiants et les paramètres privilégiés côté serveur. Lorsque le paquet fournit des valeurs par défaut, copiez l'exemple distribué et ne modifiez que les clés documentées. N'inventez pas de champs de configuration à partir d'un tutoriel sans rapport : une clé mal orthographiée peut être ignorée silencieusement, et une ancienne option peut ne plus exister.
Si une base de données est requise, utilisez un utilisateur de base de données dédié avec uniquement les permissions nécessaires. Importez le schéma correspondant du paquet une fois, puis confirmez que les tables existent. Un import SQL réussi ne prouve pas que la ressource peut se connecter, alors vérifiez la console du serveur pendant le démarrage.
Étape 5 : tester la ressource de base avant les interventions
- Démarrez le serveur avec les dépendances et FivePD, mais sans interventions optionnelles.
- Surveillez le journal complet du serveur, de la découverte des ressources au démarrage.
- Connectez-vous avec un client propre et inspectez la console F8 pour détecter les erreurs client.
- Confirmez uniquement les commandes et interfaces de base documentées.
- Redémarrez la ressource et reconnectez-vous pour exposer les problèmes d'ordre de chargement ou de persistance.
Ajoutez ensuite une intervention, redémarrez et testez-la. Procédez ainsi une par une. Une intervention conçue pour une autre version de FivePD peut échouer même si la ressource de base fonctionne correctement ; conservez la dernière version fonctionnelle pour pouvoir revenir en arrière.
Échecs d'installation courants de FivePD
| Symptôme | Première vérification | Action suivante sûre |
|---|---|---|
| Ressource introuvable | Le dossier contenant fxmanifest.lua et le nom exact utilisé avec ensure |
Corrigez le niveau du répertoire ou le nom de la ressource, puis relancez l'analyse/redémarrez |
| Dépendance ou export manquant | La dépendance est installée, compatible et démarrée en premier | Utilisez la version déclarée du paquet et l'ordre de chargement |
| Erreur de connexion à la base de données | Valeur de connexion uniquement côté serveur, utilisateur de la base de données et schéma requis | Testez l'accès depuis le serveur et comparez avec la documentation du paquet |
| La base fonctionne, mais une intervention échoue | Compatibilité de l’intervention et de ses dépendances | Désactivez cette intervention et revenez à la base dont le fonctionnement est confirmé |
| Le client se connecte mais l'interface utilisateur ou les commandes échouent | Erreurs F8 et fichiers clients manquants dans le manifeste | Vérifiez le manifeste de la ressource et les fichiers du navigateur/NUI |
Ordre de mise à jour sécurisé
Sauvegardez la ressource fonctionnelle et ses données, lisez les notes de version, mettez à jour sur l'environnement de test et retestez la base avant les interventions optionnelles. N’écrasez pas une configuration personnalisée sans la comparer. Si une mise à jour modifie la base de données, conservez à la fois le dump avant la mise à jour et la version exacte du paquet nécessaire pour la restaurer.
Cette séquence est délibérément prudente : d'abord FXServer, puis les dépendances, puis FivePD, puis une intervention. Elle donne à chaque échec une petite zone de recherche et rend la restauration possible sans reconstruire tout le serveur.