Plugin Minecraft MarriageMaster

🔌 À propos de Marriage Master

Marriage Master est un plugin Bukkit/Spigot pour Minecraft qui fournit un système de mariage configurable pour les serveurs. Il permet aux joueurs de former des mariages (un ou plusieurs, si configuré) et offre aux joueurs mariés des fonctionnalités et commandes coopératives. Le projet inclut une API pour les développeurs et prend en charge le stockage persistant.

🎯 Objectif

Le plugin est conçu pour les serveurs roleplay et sociaux qui veulent une mécanique de mariage en jeu : offrir aux couples des utilitaires partagés, un chat privé, des interactions avec l'économie en option et des effets de gameplay configurables lorsque les partenaires sont proches.

⚙️ Fonctionnalités

• Demandes de mariage entre joueurs et cérémonies dirigées par un prêtre (optionnel).
• Téléportation au partenaire et maison partagée vers laquelle les deux partenaires peuvent se téléporter.
• Chat privé de couple et option permettant d'envoyer tous les messages au partenaire au lieu du chat public.
• Objets cadeaux : les joueurs peuvent donner à leur partenaire l'objet qu'ils ont en main.
• Activation/désactivation du PvP entre partenaires (activer/désactiver le PvP avec votre partenaire).
• Actions cosmétiques comme kiss avec effets de particules.
• Bonus d'XP et de régénération lorsque les partenaires sont proches (intégrations mentionnées pour Minecraft XP, mcMMO, SkillAPI).
• Intégration optionnelle de sacs partagés / Minepacks.
• Prise en charge du multilingue via des fichiers de langue configurables.
• Backends de stockage configurables : SQLite et MySQL sont pris en charge.
• API pour permettre aux développeurs de plugins d'interagir avec les données et événements de Marriage Master.

🧩 Pour qui

• Serveurs roleplay et sociaux qui veulent des mécaniques de relation en jeu.
• Serveurs SMP ou survival qui veulent des avantages coopératifs optionnels pour des duos de joueurs.
• Administrateurs de serveur qui ont besoin de permissions configurables et d'intégrations avec l'économie ou d'autres plugins.

🏗️ Exemples d'utilisation

• Deux joueurs envoient une demande de mariage et obtiennent une maison partagée et un canal de chat privé.
• Un serveur active des cérémonies de prêtre pour des événements et accorde des objets spéciaux ou des titres lors du mariage via des scripts serveur ou des hooks d'API.
• Les couples utilisent la commande de cadeau pour échanger les objets tenus en main dans le cadre du roleplay.

⌨️ Commandes

Remarque : les sources officielles listent ces commandes mais ne documentent pas les nœuds de permission directement sur la page de la ressource ; les permissions sont disponibles dans la documentation du plugin et dans la liste des permissions.

⚙️ Installation

📥 Configuration

• Téléchargez le fichier JAR du plugin depuis la page de ressource officielle et placez le JAR dans le répertoire plugins/ de votre serveur.
• Redémarrez le serveur et vérifiez la sortie de la console pour confirmer que le plugin s'est chargé correctement.

📦 Dépendances

• Java 8 est requis à l'exécution.
• Plates-formes d'exécution confirmées : Bukkit, Spigot, Paper.
• Intégrations/dépendances optionnelles documentées par l'auteur : Vault (optionnel, pour les fonctions d'économie), PCGF PluginLib (optionnel), intégration Minepacks, prise en charge des Placeholder.
• Prise en charge optionnelle du proxy : BungeeCord / Waterfall.

🧾 Configuration

• Le plugin fournit une configuration complète et documentée ainsi que des fichiers de langue permettant de personnaliser presque tous les comportements, messages et fonctionnalités.
• Le stockage peut être configuré pour utiliser SQLite ou MySQL.

🧠 Notes techniques

• Logiciels serveur pris en charge : Bukkit, Spigot, Paper (l'auteur indique la prise en charge de Bukkit/Spigot/Paper et un support proxy BungeeCord/Waterfall optionnel).
• Nécessite Java 8 à l'exécution.
• Le projet inclut une API pour les développeurs et fournit une documentation JavaDoc pour l'intégration.
• Le plugin prend en charge les changements d'UUID/de nom et dispose d'une prise en charge multilingue via des fichiers de ressources.

🤝 Quand ce plugin est utile

Si vous gérez un serveur roleplay, social ou SMP et que vous voulez un système de mariage en jeu avec des avantages configurables, des utilitaires privés pour les couples et des hooks pour développeurs, Marriage Master fournit ces fonctionnalités avec une prise en charge de base de données et des intégrations pour les écosystèmes de serveur courants.