Aller au contenu principal

Guide

Connecter votre serveur de jeu

PanelRP connaît vos joueurs et vos métiers grâce à votre serveur de jeu. Vous pouvez le connecter de trois façons : une petite ressource ou un plugin installé sur le serveur (recommandé), un accès direct à la base de données du jeu, ou la lecture du fichier server.cfg en FTP ou SFTP. Les options affichées dépendent de votre module jeu et de votre installation. Ce guide suit la voie recommandée, puis décrit les deux autres.

Retour à tous les guides

Étapes

  1. Ouvrir l’étape « Base de données du jeu »

    Dans la configuration initiale, allez à l’étape « Base de données du jeu ». Vous pouvez répondre à « Où est hébergé ton serveur ? » : PanelRP vous indique alors où trouver vos identifiants et vos fichiers chez votre hébergeur, par exemple ZAP-Hosting, Nitrado ou Pterodactyl.

  2. Choisir la ressource ou le plugin

    Sous « Comment veux-tu connecter ton serveur ? », choisissez « Installer la ressource PanelRP » pour FiveM, ou « Installer le plugin PanelRP » pour Minecraft. Cette option est marquée « Recommandé » et fonctionne chez tous les hébergeurs, sans accès MySQL.

  3. Générer votre clé API

    Cliquez sur « Générer une clé ». Copiez la clé tout de suite : elle n’est affichée qu’une seule fois. Si une clé existe déjà, en générer une nouvelle révoque l’ancienne : pensez à mettre à jour la configuration de votre serveur.

  4. Si vous utilisez FiveM, installer la ressource

    Cliquez sur « Télécharger panelrp-bridge.zip » et décompressez l’archive dans le dossier resources de votre serveur. Ouvrez config.lua et collez votre clé. L’URL de l’API est déjà renseignée.

    Config.ApiKey = 'prp_…'

  5. Si vous utilisez Minecraft, installer le plugin

    Cliquez sur « Télécharger panelrp-bridge.jar » et déposez le fichier dans le dossier plugins de votre serveur. Démarrez le serveur une fois, puis ouvrez plugins/PanelRPBridge/config.yml et collez votre clé. L’URL de l’API est déjà renseignée.

    api-key: "prp_…"

  6. Le démarrer

    Sur FiveM, ajoutez la ligne ci-dessous dans server.cfg et redémarrez le serveur : le premier heartbeat arrive sous deux minutes. Sur Minecraft, redémarrez le serveur (ou utilisez /reload confirm) : le premier heartbeat arrive en quelques secondes.

    ensure panelrp-bridge

  7. Confirmer le serveur

    L’assistant affiche « En attente du premier heartbeat de ton serveur… ». Dès qu’il arrive, « Serveur détecté » indique le nom du serveur, le framework, les joueurs en ligne et le dernier heartbeat. Cliquez sur « Utiliser ce serveur » pour le lier à votre panel.

  8. Vérifier la connexion plus tard

    Ouvrez « Connexions » dans le menu latéral de l’admin. Le bloc « Bridge du serveur de jeu » indique si le serveur est « En ligne » ou « Hors ligne », ainsi que l’heure du « Dernier signal ».

Autres façons de se connecter

  • Connecter la base du jeu : choisissez « MySQL direct » ou « Tunnel SSH », renseignez les paramètres de connexion et cliquez sur « Tester la connexion ». En MySQL direct, PanelRP se connecte depuis le cloud : l’hôte ne peut donc pas être localhost ni 127.0.0.1. Utilisez l’IP publique de votre serveur de jeu et autorisez la connexion dans votre pare-feu. Avec un tunnel SSH, MySQL est adressé tel que le voit le serveur distant : 127.0.0.1 est alors accepté.
  • Lire server.cfg (FTP/SFTP) : saisissez les accès FTP ou SFTP fournis par votre hébergeur, éventuellement le chemin de server.cfg, et cliquez sur « Lire server.cfg ». PanelRP lit le fichier, remplit le formulaire de base de données et détecte le framework ; vous cliquez ensuite sur « Tester la connexion ». Les identifiants FTP ne servent que pour cette lecture, puis sont oubliés.
  • Pas encore de serveur de jeu ? Laissez l’étape vide. Vous pourrez le connecter plus tard depuis les Réglages, rubrique Base de données.

Pages liées