Skip to content

Repository files navigation

🤝 CordFriends v1.1.9 — Système d'Amis pour BungeeCord & Velocity

Transformez votre réseau Minecraft avec un système d'amis complet, des messages privés inter-serveurs, un courrier hors-ligne et une interface graphique intuitive — le tout synchronisé sur l'ensemble de votre réseau ! 🚀

CordFriends s'installe sur votre proxy (BungeeCord ou Velocity) et s'accompagne d'un petit module Spigot/Paper à placer sur chaque serveur backend pour afficher le menu d'amis en jeu. Une seule configuration centralisée suffit pour profiter de toutes les fonctionnalités entre tous vos serveurs.

🔎 Ce plugin fait quoi ? Il ajoute un vrai système social à votre réseau : liste d'amis persistante, demandes/blocages, messagerie privée instantanée entre serveurs, courrier hors-ligne, et un menu graphique en jeu (têtes de joueurs, skins, rejoindre un ami en un clic). Tout est piloté depuis le proxy, donc unifié sur l'ensemble du réseau.


✨ Nouveautés de la version 1.1.9 — Skins v6 : SkinsRestorer côté Proxy

Cette version déplace la recherche des skins SkinsRestorer directement sur le proxy (Velocity), là où vit réellement la base de données des skins en mode multi-serveurs. Résultat : des skins plus fiables, plus à jour, et récupérables même pour des amis hors-ligne.

🖥️ SkinsRestorer interrogé depuis le proxy

  • Nouveau pont proxy (SkinsRestorerBridge côté Velocity) : le proxy interroge lui-même PlayerStorage de SkinsRestorer. En mode proxy (server.proxyMode.api côté backend), la base de skins est sur le proxy — c'est donc ici qu'il faut la lire, pas depuis les serveurs Paper.
  • Skins pour les amis hors-ligne : jusqu'ici, le cache interne du proxy ne se remplissait qu'à la connexion d'un joueur. Désormais, FriendGuiOpener demande aussi le skin à SkinsRestorer pour les amis déconnectés, qui répond instantanément sans attendre une reconnexion.
  • Priorité à la fraîcheur : pour un ami en ligne, la texture « live » reste privilégiée (un /skin en cours de session est reflété immédiatement) ; pour un ami hors-ligne, SkinsRestorer prend le relais.

🔗 Dépendance déclarée et optionnelle

  • SkinsRestorer est maintenant déclaré comme dépendance optionnelle dans le descripteur Velocity (@Dependency(id = "skinsrestorer", optional = true)), pour un chargement propre et un message explicite si le plugin est absent.

🔧 Corrections techniques & robustesse

  • Moins de fausses alertes côté Spigot : quand SkinsRestorer tourne en mode proxy, la recherche locale sur le backend lève une IllegalStateException attendue — elle est désormais silencieuse (logger.fine) au lieu de polluer les logs, puisque le proxy fait déjà le travail.
  • Correction de l'API de profil Paper (com.destroystokyo.paper.profile) pour Minecraft 1.21+.
  • Correction du logger Velocity (SLF4J : warn au lieu de warning) lors de la capture des skins.
  • Protocole de plugin-messaging inchangé et rétro-compatible : le proxy calcule le skin et l'envoie au menu Spigot via le canal crossfriends:main.

📦 Mis à jour également

  • Numéro de version unifié à 1.1.9 (parent, modules Bungee/Velocity/Spigot, plugin.yml, descripteur @Plugin).

📦 Contenu de la release

Fichier Rôle
CordFriends-Velocity-1.1.9.jar Plugin proxy pour Velocity
CordFriends-Bungee-1.1.9.jar Plugin proxy pour BungeeCord
CordFriends-Spigot-1.1.9.jar Module interface graphique pour Spigot/Paper (à installer sur chaque serveur backend)
CordFriends-v1.1.9-src.tar.gz Code source complet de la v1.1.9

⚠️ Les deux parties (Proxy + Spigot/Paper) sont obligatoires pour un fonctionnement complet.


📥 Installation

🔄 Pour Velocity

1️⃣ Placez CordFriends-Velocity-1.1.9.jar dans le dossier /plugins de Velocity. 2️⃣ Installez CordFriends-Spigot-1.1.9.jar sur chaque serveur backend. 3️⃣ (Optionnel) Ajoutez SkinsRestorer sur votre proxy (et activez server.proxyMode.api côté backend) pour activer l'affichage des skins personnalisés. 4️⃣ Redémarrez Velocity et tous vos serveurs.

🟢 Pour BungeeCord

1️⃣ Placez CordFriends-Bungee-1.1.9.jar dans le dossier /plugins de BungeeCord. 2️⃣ Installez CordFriends-Spigot-1.1.9.jar sur chaque serveur backend. 3️⃣ (Optionnel) Ajoutez SkinsRestorer sur vos serveurs backend. 4️⃣ Redémarrez le proxy et tous vos serveurs.


👥 Système d'Amis

/friend add <joueur>
/friend accept <joueur>
/friend deny <joueur>
/friend remove <joueur>
/friend list
/friend requests

✨ Lors d'une demande d'ami, des boutons cliquables permettent d'accepter ou de refuser instantanément.

🚫 Système de Blocage

/friend block <joueur>
/friend unblock <joueur>
/friend blocked

Un joueur bloqué ne peut plus : vous envoyer une demande d'ami, vous envoyer un message privé, ni vous envoyer du courrier.

💬 Messages Privés Inter-Serveurs

/msg <joueur> <message>
/r <message>

⚡ Les messages sont envoyés instantanément, même si le joueur se trouve sur un autre serveur. Si le destinataire est hors-ligne, le message est automatiquement enregistré en courrier.

✉️ Courrier Hors-Ligne

/mail send <joueur> <message>
/mail read
/mail clear

⚙️ Par défaut, tous les joueurs peuvent envoyer du courrier (amis ou non). Ce comportement est configurable.

🖥️ Interface Graphique

/friend gui

Depuis le menu, vous pouvez : voir votre liste d'amis (avec leurs skins), rejoindre un ami en un clic (clic gauche) et préparer un message privé (clic droit).

🎯 Auto-Complétion Intelligente

Toutes les commandes supportent la touche TAB : sous-commandes et noms des joueurs concernés.


⚙️ Configuration

Le fichier config.yml (généré sur le proxy) permet de régler :

Option Description Défaut
require-friendship Exiger d'être amis pour /msg et /r true
mail-require-friendship Exiger d'être amis pour /mail send false
notify-on-join Récapitulatif (demandes + courrier) à la connexion true

La permission crossfriends.bypass contourne la restriction d'amitié pour les messages privés.


✅ Compatibilité

🖥️ Compatible avec ChestCommands — pour ouvrir l'interface depuis un menu tiers :

op: execute as @s run friend gui
Composant BungeeCord Velocity
Plugin proxy
Module Spigot/Paper
Messages privés
Système d'amis
Courrier hors-ligne
Interface graphique
Cache des skins ✅ (via Spigot) ✅ (proxy)
Intégration SkinsRestorer ✅ (proxy, v6)

🌐 Fonctionnement sur Tout le Réseau

Toute la logique (amis, blocages, courrier, messages) est gérée par le proxy, qui centralise les informations de l'ensemble du réseau. Une seule installation suffit pour synchroniser les amis, les messages privés et le courrier sur tous vos serveurs, de manière totalement transparente.


🛠️ Compilation

# Compiler tous les modules
mvn clean package

# Compiler un module spécifique
cd crossfriends-velocity && mvn clean package

Les jars produits se trouvent dans */target/ :

  • crossfriends-bungee/target/CordFriends-Bungee-1.1.9.jar
  • crossfriends-velocity/target/CordFriends-Velocity-1.1.9.jar
  • crossfriends-spigot/target/CordFriends-Spigot-1.1.9.jar

Pré-requis : JDK 21 et Maven 3.9+.


📥 Téléchargement

Téléchargez les fichiers JAR depuis la page des releases.


📜 Licence

Ce plugin est fourni tel quel pour la communauté Minecraft. Consultez le dépôt pour les conditions d'utilisation.

About

CordFriends v1.1.9 — Système d'amis complet pour BungeeCord & Velocity. Amis, messages privés inter-serveurs, courrier hors-ligne, interface graphique et skins v6 avec intégration SkinsRestorer (côté proxy) pour vos réseaux Minecraft.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages