Plugin Minecraft MarriageMaster

🔌 Informazioni su Marriage Master

Marriage Master è un plugin Bukkit/Spigot per Minecraft che fornisce un sistema di matrimonio configurabile per i server. Consente ai giocatori di formare matrimoni (singoli o multipli, se configurato) e offre ai giocatori sposati funzionalità e comandi cooperativi. Il progetto include un'API per gli sviluppatori e supporta l'archiviazione persistente.

🎯 Scopo

Il plugin è pensato per server roleplay e social che vogliono una meccanica di matrimonio in gioco: per offrire alle coppie utilità condivise, chat privata, interazioni economiche opzionali ed effetti di gameplay configurabili quando i partner sono vicini.

⚙️ Funzionalità

• Richieste di matrimonio da giocatore a giocatore e cerimonie guidate dal prete (opzionali).
• Teletrasporto al partner e una casa condivisa a cui entrambi i partner possono teletrasportarsi.
• Chat privata di coppia e un toggle per inviare tutte le chat al partner invece che alla chat pubblica.
• Oggetti regalo: i giocatori possono dare al partner l'oggetto che hanno in mano.
• Toggle PvP tra partner (abilita/disabilita il PvP con il tuo partner).
• Azioni cosmetiche come kiss con effetti particellari.
• Bonus XP e rigenerazione quando i partner sono vicini (integrazioni menzionate per Minecraft XP, mcMMO, SkillAPI).
• Integrazione opzionale con backpack condivisi / Minepacks.
• Supporto multilingua tramite file lingua configurabili.
• Backend di archiviazione configurabili: sono supportati SQLite e MySQL.
• API per gli sviluppatori di plugin per interagire con i dati e gli eventi di Marriage Master.

🧩 A chi è rivolto

• Server roleplay e social che vogliono meccaniche di relazione in gioco.
• Server SMP o survival che vogliono vantaggi cooperativi opzionali per coppie di giocatori.
• Amministratori di server che hanno bisogno di permessi configurabili e integrazioni con l'economia o altri plugin.

🏗️ Casi d'uso di esempio

• Due giocatori inviano una richiesta di matrimonio e ottengono una casa condivisa e un canale chat privato.
• Un server abilita cerimonie con prete per eventi e assegna oggetti o titoli speciali al matrimonio tramite script del server o hook API.
• Le coppie usano il comando regalo per scambiarsi oggetti in mano come parte del roleplay.

⌨️ Comandi

Nota: le fonti ufficiali elencano questi comandi ma non documentano i nodi di permesso direttamente nella pagina della risorsa; i permessi sono disponibili nella documentazione del plugin e nell'elenco dei permessi.

⚙️ Installazione

📥 Configurazione

• Scarica il JAR del plugin dalla pagina ufficiale della risorsa e inserisci il JAR nella directory plugins/ del tuo server.
• Riavvia il server e controlla l'output della console per confermare che il plugin sia stato caricato correttamente.

📦 Dipendenze

• Java 8 è richiesto a runtime.
• Piattaforme runtime confermate: Bukkit, Spigot, Paper.
• Integrazioni/dipendenze opzionali documentate dall'autore: Vault (opzionale, per le funzioni economiche), PCGF PluginLib (opzionale), integrazione Minepacks, supporto Placeholder.
• Supporto proxy opzionale: BungeeCord / Waterfall.

🧾 Configurazione

• Il plugin fornisce una configurazione completa e documentata e file lingua che consentono di personalizzare quasi tutti i comportamenti, i messaggi e le funzionalità.
• L'archiviazione può essere configurata per usare SQLite o MySQL.

🧠 Note tecniche

• Software server supportato: Bukkit, Spigot, Paper (l'autore indica supporto per Bukkit/Spigot/Paper e supporto proxy opzionale BungeeCord/Waterfall).
• Richiede Java 8 a runtime.
• Il progetto include un'API per gli sviluppatori e fornisce documentazione JavaDoc per l'integrazione.
• Il plugin supporta i cambi di UUID/nome e ha supporto multilingua tramite file di risorse.

🤝 Quando questo plugin è utile

Se gestisci un server roleplay, social o SMP e vuoi un sistema di matrimonio in gioco con vantaggi configurabili, utilità private per le coppie e hook per sviluppatori, Marriage Master offre queste funzionalità con supporto database e integrazioni per i comuni ecosistemi server.