🖥️ Guide propriétaire de serveur
Ce guide vous accompagne pas à pas pour enregistrer votre serveur Minecraft sur le panneau OreoStudios, installer le plugin et activer toutes les fonctionnalités live. Suivez chaque étape dans l'ordre.
Prérequis
| Prérequis | Notes |
|---|---|
| Serveur Minecraft | Paper / Purpur 1.20+ |
| Plugin OreoEssentials | Le plugin qui connecte votre serveur au panneau |
| Serveur RabbitMQ Optionnel | Nécessaire uniquement pour la synchronisation live de l'inventaire. Sans cela, le panneau se met à jour avec un délai. |
| Compte panneau | Inscrivez-vous sur oreostudios.fr/panel-login.html |
Étape 1 — Enregistrer votre serveur
1 Créer un compte panneau
Rendez-vous sur oreostudios.fr/panel-login.html et créez un compte si vous n'en avez pas encore. Utilisez un e-mail administrateur que vous contrôlez.
2 Ouvrir le Panneau Propriétaire
Après connexion, cliquez sur votre nom d'utilisateur en haut à droite et sélectionnez Panneau Propriétaire. C'est la zone admin visible uniquement par les propriétaires de serveur.
3 Enregistrer un nouveau serveur
Cliquez sur Ajouter un serveur (ou le bouton +). Remplissez :
- Nom du serveur — le nom que verront vos joueurs (ex :
Mon Survival SMP) - IP du serveur — l'IP publique ou le nom d'hôte de votre serveur Minecraft
- Description — courte description optionnelle
Cliquez sur Enregistrer. Votre serveur apparaîtra dans la liste du panneau propriétaire.
4 Copier votre clé API
Une fois enregistré, le panneau vous affiche une clé API. Elle ressemble à :
sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
Copiez cette clé — vous en aurez besoin à l'étape suivante. Gardez-la secrète. Toute personne qui possède cette clé peut envoyer des données à l'entrée de votre serveur sur le panneau.
Étape 2 — Installer OreoEssentials
1 Télécharger le plugin
Obtenez OreoEssentials.jar depuis votre achat ou la page de téléchargement du panneau OreoStudios.
2 Le déposer dans le dossier plugins
Placez OreoEssentials.jar dans le répertoire /plugins/ de votre serveur.
3 Démarrer (ou redémarrer) le serveur
Le plugin va générer ses fichiers de configuration dans plugins/OreoEssentials/. Vous le verrez se charger dans la console.
Étape 3 — Configurer la clé API
Ouvrez plugins/OreoEssentials/config.yml dans un éditeur de texte. Trouvez la section web-panel :
# ── Panneau Web ───────────────────────────────────── web-panel: enabled: true url: "https://oreostudios.fr" # Laissez tel quel sauf si vous hébergez vous-même api-key: "sk_live_xxxxxxxxxxxxxxxxxxxxxxxx" # ← Collez votre clé API ici
À quoi sert chaque paramètre
| Paramètre | Rôle |
|---|---|
enabled: true | Active la synchronisation avec le panneau. Mettez false pour désactiver complètement. |
url | L'URL du panneau web. Laissez https://oreostudios.fr sauf si vous hébergez vous-même. |
api-key | Votre clé API secrète du panneau propriétaire. Obligatoire. |
Après avoir enregistré le fichier, tapez /oe reload dans la console de votre serveur ou redémarrez-le.
[OreoEssentials] Synchronisation panneau activée. Serveur enregistré avec succès.Étape 4 — Configurer RabbitMQ (Sync Live)
RabbitMQ rend les mises à jour d'inventaire instantanées. Sans lui, les données se synchronisent toutes les quelques secondes au lieu d'être en temps réel. Cette étape est optionnelle mais fortement recommandée.
1 Installer RabbitMQ
Si vous utilisez Pterodactyl, installez un egg RabbitMQ. Sinon, installez-le sur votre VPS :
apt install rabbitmq-server -y rabbitmq-server start
Le port par défaut est 5672. Le login par défaut est guest / guest en localhost uniquement.
2 Créer un utilisateur dédié
Pour la sécurité, créez un nouvel utilisateur RabbitMQ plutôt que d'utiliser celui par défaut :
rabbitmqctl add_user monutilisateur monsecretpassword rabbitmqctl set_permissions -p / monutilisateur ".*" ".*" ".*"
3 Ajouter votre URI RabbitMQ dans le Panneau Propriétaire
Dans le panneau propriétaire, ouvrez les paramètres de votre serveur et trouvez le champ URI RabbitMQ. Entrez votre chaîne de connexion :
amqp://monutilisateur:monsecretpassword@ip-de-votre-serveur:5672/
Enregistrez. Le panneau va tester la connexion et afficher un ✓ vert si ça fonctionne.
4 Ajouter le même URI dans la config OreoEssentials
Dans plugins/OreoEssentials/config.yml, trouvez la section rabbitmq :
rabbitmq: enabled: true uri: "amqp://monutilisateur:monsecretpassword@ip-de-votre-serveur:5672/"
Tapez /oe reload ou redémarrez. La console de votre serveur devrait afficher :
[OreoEssentials] RabbitMQ connecté. Synchronisation live active.
● LIVE dans la section inventaire.Étape 5 — Utiliser le Panneau Propriétaire
Le Panneau Propriétaire est votre tableau de bord admin. Accédez-y via votre nom d'utilisateur → Panneau Propriétaire.
| Fonctionnalité | Ce qu'elle fait |
|---|---|
| 📋 Liste des joueurs | Voir tous les joueurs liés à votre serveur avec leur statut |
| 🔑 Clé API | Afficher ou régénérer votre clé API de serveur |
| 🐇 URI RabbitMQ | Définir votre chaîne de connexion RabbitMQ pour la sync live |
| 📦 Donner un objet | Envoyer n'importe quel objet directement dans l'inventaire d'un joueur |
| 🗑️ Retirer un objet | Supprimer un objet spécifique de l'inventaire d'un joueur |
| 🔨 Bannir un joueur | Bannir un joueur de votre serveur depuis le panneau |
| 👢 Expulser un joueur | Expulser un joueur actuellement connecté |
| 📣 Diffusion | Envoyer une notification à tous vos joueurs sur le serveur |
| 📊 Ordres du marché | Voir toutes les annonces actives sur votre serveur |
Étape 6 — Fonctions admin en détail
📦 Donner un objet à un joueur
Depuis Panneau Propriétaire → cliquez sur un joueur → Donner un objet :
- Entrez l'ID Minecraft de l'objet (ex :
minecraft:diamond) - Définissez la quantité
- Cliquez sur Envoyer
L'objet est mis en file d'attente comme une livraison en attente. Si le joueur est connecté, il arrive dans son inventaire en quelques secondes. S'il est hors ligne, il attend et est livré à sa prochaine connexion.
🗑️ Retirer un objet d'un joueur
Cliquez sur Retirer un objet sur la page de détail d'un joueur. Sélectionnez l'objet depuis son inventaire live et confirmez. L'objet est retiré à la prochaine synchronisation de l'inventaire.
🔨 Bannir / Expulser
Sur la page de détail du joueur, utilisez le bouton Bannir ou Expulser. Bannir enregistre le ban dans le panneau et envoie une commande au serveur Minecraft via le plugin. Le joueur est expulsé immédiatement s'il est connecté.
📣 Envoyer une diffusion
Depuis la vue d'ensemble du serveur dans le Panneau Propriétaire, cliquez sur Diffusion. Tapez votre message et cliquez sur Envoyer. Tous les joueurs actuellement connectés reçoivent une notification dans le panneau et un message en jeu.
FAQ
Ai-je besoin de RabbitMQ ?
Non — mais sans lui, les mises à jour d'inventaire ont un délai (le plugin envoie des mises à jour périodiquement plutôt qu'instantanément). Pour la meilleure expérience, configurez RabbitMQ.
Un joueur a lié son compte mais je ne le vois pas dans mon panneau propriétaire
Le joueur doit avoir effectué la liaison sur votre serveur. S'il a utilisé le code /weblink d'un autre serveur, il est lié à ce serveur. Demandez-lui de taper /weblink sur votre serveur.
Ma clé API ne fonctionne plus après l'avoir régénérée
Mettez à jour la clé dans plugins/OreoEssentials/config.yml sur votre serveur Minecraft et rechargez avec /oe reload.
La connexion RabbitMQ échoue sans arrêt
Vérifiez : (1) le format de l'URI est correct amqp://user:pass@host:port/, (2) le port 5672 est ouvert dans votre pare-feu, (3) l'utilisateur a les permissions définies avec rabbitmqctl set_permissions.
Comment supprimer un serveur du panneau ?
Dans le Panneau Propriétaire, ouvrez les paramètres du serveur et cliquez sur Supprimer le serveur. Cela supprime tous les joueurs liés et les données de ce serveur. Cette action est irréversible.