Utilisez le mode Histoire de GTA V pour le jeu hors ligne ordinaire et un FXServer privé lorsque vous avez besoin de tester seul les ressources FiveM. Ce sont des environnements d'exécution différents. Un mod en mode Histoire ne fonctionne pas automatiquement comme une ressource FiveM, et un script de serveur nécessite normalement FXServer même lorsqu'une seule personne se connecte.
Les exemples de configuration et de code ici ciblent FiveM pour GTA V Legacy. Enhanced a des règles d'exécution et de compatibilité différentes ; vérifiez les changements Legacy-to-Enhanced de Cfx.re avant de les appliquer à un serveur Enhanced.
Choisissez le bon mode
| But | Solution la plus adaptée | Limite importante |
|---|---|---|
| Jouer à la campagne de GTA V hors ligne | Mode Histoire de GTA V | Il n'exécute pas les ressources du serveur FiveM. |
| Explorez un environnement FiveM seul | Un serveur qui permet de jouer en solo | Le propriétaire du serveur contrôle ses ressources et ses règles. |
| Développer ou tester une ressource en privé | FXServer local/privé | Vous avez toujours besoin des dépendances et de la configuration de la ressource. |
Installer le client depuis la source officielle
Conservez une installation légitime et à jour de GTA V et installez FiveM via le chemin client officiel. Ne mélangez pas d'injecteurs inconnus, d'outils de triche GTA Online ou de repacks aléatoires dans la configuration de test. Si le client échoue avant de se connecter, reproduisez d'abord avec une configuration GTA V/FiveM propre.
Créer un serveur de test privé en solo
- Suivez les instructions actuelles de configuration du serveur Cfx.re pour le système d'exploitation.
- Démarrez txAdmin et créez un profil de test distinct plutôt que de modifier les données de production.
- Limitez les interfaces réseau d’écoute du serveur aux besoins du test. Ajoutez une authentification ou des règles de pare-feu avant de le rendre accessible depuis une autre machine.
- Installez une ressource avec ses dépendances documentées et sa migration de base de données.
- Ajoutez la ressource à la configuration du serveur, redémarrez et rejoignez via le point de terminaison local/privé.
Une recette txAdmin est un point de départ de déploiement, pas une preuve que chaque dépendance groupée ou ressource communautaire est à jour. Enregistrez la recette et les versions des artefacts afin que le test puisse être répété.
Comprendre la compatibilité des ressources
Les ressources FiveM peuvent dépendre d'un framework, d'une base de données, d'un inventaire, d'un système de ciblage, d'une version de jeu ou d'autres ressources. Lisez fxmanifest.lua et la documentation du créateur avant de commencer. Les fichiers créés uniquement pour le mode Histoire, OpenIV ou ScriptHook ne peuvent pas être traités comme des ressources de serveur sans une implémentation FiveM autorisée.
Effectuez un test solo utile
- Utilisez un nouveau personnage et un état de base de données connu.
- Testez le démarrage, l'arrêt et le redémarrage des ressources, ainsi qu'un redémarrage complet du serveur.
- Reconnectez-vous et répétez l'action principale après avoir effacé uniquement l'état de test spécifique à la ressource.
- Ouvrez la console F8 et examinez la console du serveur pour les avertissements et les erreurs.
- Testez les chemins d'échec tels que les autorisations manquantes, les éléments manquants et les entrées non valides.
Les tests en solo détectent les erreurs d'empaquetage et de logique de base. Ils ne peuvent pas prouver les performances, la synchronisation, les conditions de concurrence ou les limites d'autorisation sous plusieurs joueurs. Déplacez les modifications réussies vers un serveur de staging séparé avant la production.
Gardez le test réversible
Gérez les versions de la ressource et de la configuration, sauvegardez la base de test avant les migrations et ne changez qu’une variable à la fois. Si une ressource empêche le démarrage, supprimez sa ligne ensure, restaurez les fichiers et l’état de la base précédents, puis reproduisez le problème à partir de la dernière version fonctionnelle connue.