✨ Toutes les fonctionnalités du panneau
Référence complète de tout ce que le Panneau Web OreoStudios offre — pour les joueurs comme pour les propriétaires de serveur.
Fonctions joueur
🧍 Profil joueur
Affiche votre skin Minecraft, votre pseudo et votre serveur actuel.
🎒 Inventaire live
Vue en temps réel de votre inventaire Minecraft, mis à jour pendant que vous jouez.
💰 Solde
Votre solde en monnaie du jeu sur tous les serveurs liés.
🏠 Maisons
Voir tous vos points de téléportation enregistrés par nom.
🛒 Marché
Parcourir les annonces actives et vos propres ordres de vente.
👥 Amis
Liste d'amis avec statut en ligne, envoyer/accepter des demandes.
🔔 Notifications
Alertes en temps réel pour les ventes, demandes d'amis, livraisons.
🌐 Multi-serveur
Lier plusieurs serveurs et basculer entre eux dans le tableau de bord.
Inventaire live — Explication détaillée
L'inventaire live est la pièce maîtresse du tableau de bord joueur. Voici tout ce qu'il fait :
🟢 Badge LIVE
Un badge vert clignotant ● LIVE apparaît quand le navigateur a une connexion WebSocket active avec le serveur du panneau. Tant que ce badge est visible, votre inventaire se met à jour automatiquement — sans actualisation nécessaire.
Si le badge disparaît, la connexion a été coupée (généralement due à un problème réseau). Le panneau se reconnectera automatiquement en quelques secondes.
🎒 Qu'est-ce qui déclenche une mise à jour ?
Les synchronisations d'inventaire sont déclenchées par des événements en jeu :
- Casser un bloc et ramasser les drops
- Ramasser un objet par terre
- Lâcher un objet
- Fermer votre inventaire (après avoir fait des modifications)
- Recevoir une livraison en attente du panneau propriétaire
Les mises à jour sont regroupées — plusieurs événements dans la même seconde sont regroupés en une seule synchronisation pour ne pas surcharger le panneau.
🖱️ Infobulles des objets
Survolez n'importe quel objet dans la grille d'inventaire pour voir :
- Nom de l'objet (y compris les noms personnalisés)
- Nombre dans la pile
- Enchantements
- Lore / description
🛒 Vendre depuis l'inventaire
Cliquez sur un objet dans le panneau d'inventaire pour ouvrir une fenêtre de vente rapide. Définissez un prix par unité et la quantité. Cela crée une annonce sur le marché directement depuis le navigateur — l'objet est marqué comme « en attente de retrait » et supprimé de votre inventaire en jeu à votre prochaine connexion.
Marché
L'onglet marché affiche tous les ordres d'achat et de vente actifs sur votre serveur actuel.
| Fonctionnalité | Détails |
|---|---|
| Parcourir les annonces | Voir tous les objets actuellement en vente avec prix et quantités |
| Vos annonces | Gérer vos propres ordres de vente actifs — les annuler ou les modifier |
| Historique des prix | Voir les prix de vente récents pour chaque objet (si disponible) |
| Vente rapide | Lister un objet depuis votre inventaire en un clic (voir ci-dessus) |
| Notifications de vente | Recevoir une notification quand une de vos annonces est vendue |
Système d'amis
| Fonctionnalité | Détails |
|---|---|
| Envoyer une demande | Entrez le pseudo d'un joueur et envoyez une demande depuis le navigateur ou en jeu |
| Accepter / Refuser | Les demandes entrantes apparaissent en haut de votre liste d'amis |
| Indicateur en ligne | Point vert = connecté sur le même serveur que vous. Point gris = hors ligne. |
| Supprimer un ami | Cliquez sur le bouton ✕ — supprime l'amitié des deux côtés |
| Multi-serveur | Les amis sont partagés sur tous les serveurs liés à votre compte panneau |
Notifications
Toutes les notifications sont livrées en temps réel via WebSocket tant que votre navigateur est ouvert. Elles sont aussi stockées pour que vous les voyiez à votre prochaine connexion.
| Événement | Qui la reçoit | Déclenché par |
|---|---|---|
| 🤝 Demande d'ami reçue | Destinataire | Un autre joueur envoie une demande |
| ✅ Demande d'ami acceptée | Expéditeur | Le destinataire accepte votre demande |
| 💰 Objet vendu | Vendeur | Un acheteur achète votre annonce |
| 📦 Objet livré | Joueur | Le propriétaire vous envoie un objet via le panneau admin |
| 📣 Diffusion du serveur | Tous les joueurs du serveur | Le propriétaire envoie un message de diffusion |
| 🔨 Action admin | Joueur | Vous êtes banni, expulsé ou averti par un admin |
Fonctions du Panneau Propriétaire
Le Panneau Propriétaire n'est visible que par les comptes qui ont enregistré un serveur. Il se trouve dans Nom d'utilisateur → Panneau Propriétaire.
📋 Gestionnaire de joueurs
Lister tous les joueurs liés, voir leur profil, inventaire et stats en un coup d'œil.
🔑 Gestionnaire de clé API
Voir, copier ou régénérer votre clé API de serveur. Utilisée dans la config OreoEssentials.
🐇 Configuration RabbitMQ
Entrez votre URI RabbitMQ pour activer la synchronisation live pour tous vos joueurs.
📦 Livraisons en attente
Suivre les objets que vous avez envoyés aux joueurs — voir s'ils ont été reçus.
📊 Vue d'ensemble du marché
Voir toutes les annonces actives sur l'ensemble de votre serveur.
📣 Diffusion
Envoyer une notification à tous vos joueurs, visible dans le panneau et en jeu.
🔨 Modération
Bannir, expulser ou avertir des joueurs directement depuis le navigateur.
🖥️ Paramètres du serveur
Modifier le nom, la description de votre serveur et supprimer l'enregistrement.
Donner et retirer des objets
📦 Donner un objet à un joueur
Depuis Panneau Propriétaire → cliquez sur un joueur → Donner un objet :
- Recherchez l'ID Minecraft de l'objet (ex :
minecraft:diamond_sword) - Définissez la quantité (max 64 par action)
- Cliquez sur Envoyer
La livraison est mise en file d'attente. Si le joueur est en ligne, elle arrive dans son inventaire en quelques secondes. S'il est hors ligne, elle attend et est livrée à sa prochaine connexion.
Vous pouvez voir toutes les livraisons en attente dans la section Livraisons en attente du Panneau Propriétaire.
🗑️ Retirer un objet d'un joueur
Depuis Panneau Propriétaire → cliquez sur un joueur → Retirer un objet :
- L'inventaire live actuel du joueur est affiché
- Cliquez sur l'objet que vous souhaitez retirer
- Définissez la quantité et confirmez
L'objet est marqué pour suppression. Il est retiré de l'inventaire en jeu du joueur à la prochaine synchronisation (en quelques secondes s'il est en ligne).
Modération
| Action | Effet |
|---|---|
| 🔨 Bannir Permanent | Bannit le joueur de votre serveur. Il est expulsé immédiatement s'il est en ligne. Le ban est enregistré dans le panneau et appliqué par le plugin quand il essaie de se connecter. |
| 👢 Expulser | Expulse le joueur du serveur s'il est actuellement en ligne. Pas d'enregistrement permanent. |
| ✏️ Avertir | Envoie au joueur une notification d'avertissement visible dans son tableau de bord panneau. |
| 🔓 Débannir | Supprime un ban existant. Le joueur peut se reconnecter immédiatement. |
Comment fonctionne la synchronisation live (vue technique)
Une explication simple du pipeline — utile si vous êtes un propriétaire de serveur qui débogue des problèmes de synchronisation.
Le pipeline complet en 4 étapes
- Le joueur fait quelque chose en jeu (casse un bloc, ramasse un objet, etc.)
- Le plugin OreoEssentials détecte l'événement, sérialise l'inventaire en JSON et le publie sur RabbitMQ via l'exchange
oreo.webpanel.sync. - Le backend OreoStudios (le serveur Spring) est abonné à cet exchange. Il reçoit le message et stocke l'inventaire mis à jour dans la base de données.
- Le backend pousse la mise à jour vers la session de navigateur ouverte du joueur via WebSocket (STOMP). Le tableau de bord se re-rend instantanément.
| Composant | Rôle | Où il tourne |
|---|---|---|
| Plugin OreoEssentials | Capture les événements du jeu, publie sur RabbitMQ | Votre serveur Minecraft |
| RabbitMQ | Courtier de messages — livraison rapide et fiable | Votre serveur (ou instance hébergée) |
| Backend OreoStudios | Consomme RabbitMQ, stocke les données, diffuse via WebSocket | Serveurs OreoStudios |
| Frontend panneau | Reçoit le push WebSocket, affiche l'inventaire | Navigateur du joueur |