Minecraft plugin MarriageMaster

🔌 Over Marriage Master

Marriage Master is een Bukkit/Spigot Minecraft-plugin die een configureerbaar huwelijksysteem voor servers biedt. Hiermee kunnen spelers huwelijken aangaan (één of meerdere, als dat is ingesteld) en krijgen getrouwde spelers samenwerkingsfuncties en commando's. Het project bevat een API voor ontwikkelaars en ondersteunt persistente opslag.

🎯 Doel

De plugin is ontworpen voor roleplay- en sociale servers die een in-game huwelijksmechaniek willen: om koppels gedeelde hulpmiddelen, privéchat, optionele economie-interacties en configureerbare gameplay-effecten te geven wanneer partners dicht bij elkaar zijn.

⚙️ Functies

• Huwelijksaanvragen tussen spelers en, optioneel, ceremonies geleid door een priester.
• Teleporteren naar je partner (teleport to partner) en een gedeeld huis waar beide partners naartoe kunnen teleporteren.
• Privéchat voor koppels en een toggle om alle chat naar je partner te sturen in plaats van naar de openbare chat.
• Cadeau-items: spelers kunnen het item in hun hand aan hun partner geven.
• PvP-toggle tussen partners (PvP met je partner in-/uitschakelen).
• Cosmetische acties zoals kiss met deeltjes-effecten.
• XP- en regeneratiebonussen wanneer partners dicht bij elkaar zijn (integraties genoemd voor Minecraft XP, mcMMO, SkillAPI).
• Optionele gedeelde backpacks / Minepacks-integratie.
• Ondersteuning voor meerdere talen via configureerbare taalbestanden.
• Configureerbare opslagback-ends: SQLite en MySQL worden ondersteund.
• API voor plugin-ontwikkelaars om met Marriage Master-data en events te werken.

🧩 Voor wie het is

• Roleplay- en sociale servers die in-game relatie-mechanieken willen.
• SMP- of survivalservers die optionele coöperatieve voordelen voor spelerskoppels willen.
• Serverbeheerders die configureerbare permissies en integraties met economie of andere plugins nodig hebben.

🏗️ Voorbeeldgebruik

• Twee spelers sturen een huwelijksverzoek en krijgen een gedeeld huis en een privéchatkanaal.
• Een server schakelt priesterceremonies in voor events en geeft speciale items of titels bij een huwelijk via server scripting of API-hooks.
• Koppels gebruiken het gift-commando om items uit hun hand uit te wisselen als onderdeel van roleplay.

⌨️ Commando's

Opmerking: de officiële bronnen vermelden deze commando's, maar documenteren geen permission nodes direct op de resourcepagina; permissies zijn beschikbaar in de documentatie van de plugin en de permissielijst.

⚙️ Installatie

📥 Setup

• Download de plugin JAR van de officiële resourcepagina en plaats de JAR in de plugins/-map van je server.
• Herstart de server en controleer de console-uitvoer om te bevestigen dat de plugin succesvol is geladen.

📦 Afhankelijkheden

• Java 8 is vereist tijdens runtime.
• Bevestigde runtimeplatforms: Bukkit, Spigot, Paper.
• Optionele integraties/afhankelijkheden zoals door de auteur gedocumenteerd: Vault (optioneel, voor economie-functies), PCGF PluginLib (optioneel), Minepacks-integratie, Placeholder-ondersteuning.
• Optionele proxy-ondersteuning: BungeeCord / Waterfall.

🧾 Configuratie

• De plugin biedt een uitgebreide, gedocumenteerde configuratie en taalbestanden waarmee bijna al het gedrag, de berichten en de functies kunnen worden aangepast.
• Opslag kan worden ingesteld op SQLite of MySQL.

🧠 Technische notities

• Ondersteunde serversoftware: Bukkit, Spigot, Paper (de auteur geeft ondersteuning aan voor Bukkit/Spigot/Paper en optionele BungeeCord/Waterfall proxy-ondersteuning).
• Vereist Java 8 tijdens runtime.
• Het project bevat een API voor ontwikkelaars en biedt JavaDoc-documentatie voor integratie.
• De plugin ondersteunt UUID/naam-wijzigingen en heeft meertalige ondersteuning via resourcebestanden.

🤝 Wanneer deze plugin nuttig is

Als je een roleplay-, sociale- of SMP-server runt en een in-game huwelijksysteem wilt met configureerbare voordelen, privéhulpmiddelen voor koppels en developer-hooks, biedt Marriage Master die functies met databaseondersteuning en integraties voor veelgebruikte server-ecosystemen.