Utiliser Azuriom à la place d’un site Tebex pour FiveM

Vous pouvez utiliser Azuriom pour construire le site web de votre communauté FiveM et en faire la destination que les joueurs visitent à la place d’une boutique Tebex autonome. Servez-vous-en pour votre page d’accueil, vos règles et les informations de la communauté ; connectez votre serveur de jeu via AzLink. Pour les packs payants du serveur, gardez Tebex dans le circuit de paiement : la documentation actuelle de Cfx.re désigne Tebex comme fournisseur de monétisation exclusif et interdit les autres plateformes de paiement à cet usage. Lisez les exigences de monétisation de Cfx.re avant de configurer des ventes.

Ce tutoriel couvre l’installation du site, la ressource officielle AzLink-FiveM et une checklist de lancement pratique. Il s’appuie sur la documentation et sur une revue du code source réalisées le 9 novembre 2026 ; il ne prétend pas reposer sur un test complet de bout en bout avec FXServer et les paiements. Azuriom indique FiveM comme jeu pris en charge dans sa documentation. Le code du bridge examiné ici correspond au commit d2c76cbdf4f7561bf7943aed8524bbce67a9ebc2 du dépôt officiel ; sa dernière version publiée au moment de la revue est v0.1.1.

Choisissez ce que vous voulez qu’Azuriom remplace

Un site de communauté et un service de paiement résolvent des problèmes différents. Un bon point de départ est un site Azuriom auto-hébergé avec un lien de navigation « Boutique » bien visible vers votre boutique Tebex existante. Cela sépare l’édition du site du paiement et de la livraison des packs. Vous pouvez lancer le site avant de tenter une intégration commerciale plus poussée.

AzLink est une connexion distincte entre Azuriom et FXServer. Il échange des informations sur le serveur et peut exécuter les commandes renvoyées par le site. Son installation ne relie pas automatiquement vos achats Tebex, n’importe pas les abonnements et ne transfère pas les fiches clients. Le dépôt officiel AzLink-FiveM documente la ressource ; notre comparatif Azuriom et Tebex couvre les différences plus larges entre les logiciels et le commerce.

Gardez le paiement direct par Stripe ou PayPal en dehors de cette configuration de monétisation d’un serveur FiveM. Un plugin de paiement disponible ne prouve pas que vous avez le droit d’utiliser ce moyen de paiement pour votre serveur.

1. Préparez l’hébergement et conservez la configuration qui fonctionne

Il vous faut un compte d’hébergement web ou un VPS pour Azuriom, un domaine en HTTPS, un accès à la base de données, ainsi que le droit de gérer les ressources de votre FXServer et sa console serveur. Azuriom est une application PHP ; placer ses fichiers dans un dossier de ressources FiveM ne créera pas de site web.

À la date de la revue, les prérequis d’installation officiels exigent PHP 8.2 ou plus récent, les extensions PHP listées et la prise en charge des liens symboliques. MySQL/MariaDB ou PostgreSQL est recommandé. Demandez à l’hébergeur de vérifier l’ensemble des prérequis plutôt que de vous fier à une offre décrite seulement comme « hébergement PHP ».

Avant de rien modifier, enregistrez une copie de server.cfg, de tout dossier AzLink existant et de la configuration actuelle du site. Si vous remplacez un CMS existant, sauvegardez à la fois ses fichiers et sa base de données. Commencez sur un nom d’hôte distinct afin que le site et la boutique existants restent disponibles pendant la recette. Notez comment rétablir le DNS et l’ancienne configuration du serveur web.

Point de contrôle : le nom d’hôte prévu se charge en HTTPS et vous avez accès au panneau d’hébergement, à la base de données et à la console FXServer. Gardez les mots de passe de base de données et les clés du bridge hors des captures d’écran et des messages de support publics.

2. Installez le site Azuriom

Téléchargez le paquet d’installation depuis le site officiel d’Azuriom. Envoyez-le et extrayez-le à l’emplacement du site configuré par votre hébergeur, fichiers cachés compris. Suivez les instructions du serveur web fournies en amont ; pour Nginx, la racine documentée de l’application se termine par /public.

Ouvrez le site dans un navigateur, terminez l’installateur, indiquez la connexion à la base de données et créez le premier administrateur. Sélectionnez l’option d’identité FiveM adaptée à votre communauté. Le bridge distingue les identités basées sur Steam de celles basées sur Cfx : gardez donc le choix du site cohérent avec les comptes de vos joueurs. Ne partez pas du principe qu’un pseudo Discord est l’identifiant de jeu.

Consultez le guide d’installation pour les tâches planifiées lorsque des fonctions activées en ont besoin. Gardez la sortie de débogage désactivée en production, restreignez l’accès aux fichiers selon le modèle de déploiement de votre hébergeur et vérifiez que les fichiers de configuration privés ne peuvent pas être téléchargés.

Point de contrôle : connectez-vous en administrateur, enregistrez une petite modification de contenu, puis consultez-la déconnecté. Vérifiez qu’un compte ordinaire ne peut pas ouvrir les pages d’administration. Une page d’accueil qui se charge correctement n’est que la première de ces vérifications.

3. Rendez le site utile avant de connecter la partie commerce

Créez les pages dont les joueurs ont besoin : présentation du serveur, instructions pour rejoindre, règles et un contact de support clair. Placez la boutique dans la navigation principale et utilisez l’URL de votre boutique Tebex existante comme destination. Testez ce lien depuis un navigateur déconnecté et sur un téléphone.

Utilisez un thème qui rend ces éléments faciles à trouver. N’installez des extensions que pour les fonctions que vous comptez exploiter, et notez leurs versions afin de pouvoir tester les futures mises à jour sur la même configuration. Pour une checklist de planification plus large, consultez notre guide pour créer un site web pour un serveur FiveM.

Point de contrôle : un nouveau visiteur trouve les instructions pour rejoindre le serveur, les règles, le support et la boutique sans session d’administrateur.

4. Installez la ressource officielle AzLink-FiveM

Téléchargez la ressource depuis la page Releases du dépôt. Extrayez-la de façon que la racine de la ressource s’appelle azlink et contienne directement fxmanifest.lua et son répertoire server. Évitez un dossier d’archive imbriqué supplémentaire.

resources/
└── azlink/
    ├── fxmanifest.lua
    └── server/

Pour le premier démarrage, le README d’origine utilise ces instructions pour la console serveur. Lancez d’abord refresh si vous avez ajouté le dossier alors que FXServer tournait déjà :

refresh
start azlink

Pour le démarrage après un redémarrage du serveur, ajoutez la ressource à server.cfg :

ensure azlink

Le manifeste du bridge déclare une ressource uniquement côté serveur ; ces instructions n’installent aucune intégration de gameplay pour ESX, QBCore ou Qbox. Les commandes qui touchent aux personnages ou aux inventaires nécessitent leur propre implémentation et leurs propres tests, propres au framework. Cette revue des sources n’établit pas de validation distincte à l’exécution sur GTAV Legacy et Enhanced.

Point de contrôle : FXServer indique que la ressource a démarré sans manifeste manquant ni erreur de script. Cela établit le démarrage, pas une connexion fonctionnelle avec le site.

5. Reliez FXServer au site

Dans la zone d’administration d’Azuriom, ajoutez votre serveur de jeu dans Servers. Utilisez les valeurs de configuration affichées pour ce serveur. L’implémentation des commandes examinée accepte l’URL de base du site suivie de la clé du site :

azlink setup https://community.example.com YOUR_SERVER_SITE_KEY
azlink status
azlink fetch

https://community.example.com et YOUR_SERVER_SITE_KEY sont des valeurs fictives. Exécutez la vraie configuration dans la console serveur, avec les valeurs de votre propre tableau de bord. La ressource ajoute elle-même /api/azlink à l’URL de base ; ne l’ajoutez pas une seconde fois. Gardez la clé privée.

Une fois la configuration réussie, la ressource enregistre ses paramètres de connexion dans config.json à l’intérieur du répertoire de la ressource. Conservez ce fichier lors de la mise à jour de la ressource. Traitez sa sauvegarde comme sensible, car elle contient l’identifiant du bridge. Vérifiez à nouveau le résultat après un redémarrage de la ressource, afin qu’une connexion temporaire en mémoire ne masque pas un échec d’enregistrement de la configuration.

Point de contrôle : le statut confirme la connectivité, le fetch se termine et le site reflète le serveur connecté. Connectez-vous avec un compte de test et comparez les informations du joueur avec FXServer. Vérifiez le mode d’identité sélectionné avant de tenter des actions propres à un joueur.

6. Gardez les packs payants sur le circuit Tebex

Pour un lancement le plus simple possible, conservez le lien de navigation vers votre boutique Tebex. Configurez la livraison des packs payants via la connexion Tebex existante, et ne dupliquez pas ces actions dans AzLink. Si vous avez encore besoin de cette connexion, notre tutoriel de configuration d’une boutique Tebex pour FiveM explique le côté boutique.

Si vous voulez plus tard parcourir les packs depuis Azuriom, la marketplace propose une extension Tebex Integration par Bricec6, développée par un tiers. Sa fiche décrit une intégration de l’API Tebex Headless. Examinez sa compatibilité actuelle, ses dépendances et sa maintenance avant de l’adopter. Cet article n’a pas testé cette extension : la configuration de base ci-dessus n’en dépend donc pas.

Avant de mettre en ligne un nouveau parcours d’achat, vérifiez l’identification du compte, la destination réelle du paiement, la livraison des packs et le circuit de support. Gardez l’historique des achats et les abonnements actifs dans le système qui fonctionne tant qu’une migration testée à part n’existe pas. Une refonte du site n’est pas la preuve que ces enregistrements ou ces accords de renouvellement ont été transférés.

Dépannage d’AzLink

La ressource est introuvable

Vérifiez le nom du dossier et son imbrication. Le manifeste doit se trouver à l’emplacement resources/azlink/fxmanifest.lua. Actualisez la liste des ressources après avoir ajouté les fichiers, puis examinez la première erreur de la console serveur.

La ressource démarre, mais le site est déconnecté

Vérifiez l’URL de base HTTPS configurée et la clé de serveur correspondante. Le client HTTP appelle le point d’accès /api/azlink du site. Examinez les journaux d’accès et d’erreurs du site pour ce chemin. Des échecs DNS, des problèmes TLS, des redirections vers un autre nom d’hôte, des barrières d’authentification ou des défis du navigateur peuvent empêcher FXServer de recevoir la réponse d’API attendue.

Corrigez l’accès à la route d’API visée sans désactiver la protection sur l’ensemble du site. Lorsque vous demandez de l’aide, indiquez le statut HTTP, l’horodatage et la version de la ressource ; masquez les identifiants de connexion et ceux des joueurs.

Le statut est correct, mais le joueur ou l’action est erroné

Vérifiez la correspondance des identités Steam ou Cfx, la connexion actuelle du joueur et les exigences de la commande ciblée. Le bridge insère les informations du joueur dans les commandes et les exécute via la console serveur. Une requête HTTP réussie ne prouve pas que la commande a produit le changement de gameplay voulu.

Utilisez d’abord une action sans danger avec un compte de test. Testez séparément le comportement avec un joueur déconnecté avant de vous appuyer sur une action qui attend un ID serveur en ligne. L’administration du site et les identifiants du bridge méritent donc le même soin que les autres chemins capables de déclencher des commandes sur le serveur.

Contrôles de lancement et de retour arrière

Lancez une fois que le site consulté sans être connecté, les permissions des utilisateurs ordinaires, la navigation mobile, la connexion persistante du bridge et le parcours d’achat Tebex prévu ont été vérifiés. Gardez une trace des versions du CMS, des extensions et de la ressource, de la date et de ce que vous avez réellement testé.

Si la connexion au site pose problème, redirigez les visiteurs vers l’ancien site, restaurez sa configuration et sa base de données si nécessaire, et arrêtez AzLink le temps de l’enquête. Ne restaurez la configuration enregistrée de la ressource que si elle correspond toujours au site et au serveur visés. Gardez le système commercial existant disponible pendant toute la modification.

Azuriom vous donne la maîtrise du site que vos joueurs utilisent. Pour un serveur FiveM, ce guide laisse à Tebex la responsabilité du circuit de monétisation, tandis qu’AzLink gère la connexion entre le site et le serveur.