Minecraft-plugin MarriageMaster

🔌 Om Marriage Master

Marriage Master är ett Bukkit/Spigot Minecraft-plugin som erbjuder ett konfigurerbart äktenskapssystem för servrar. Det låter spelare ingå äktenskap (enligt inställning en eller flera) och ger gifta spelare samarbetsfunktioner och kommandon. Projektet innehåller ett API för utvecklare och stöder permanent lagring.

🎯 Syfte

Pluginet är utformat för roleplay- och sociala servrar som vill ha en äktenskapsmekanik i spelet: för att ge par gemensamma verktyg, privat chatt, valfria ekonomiinteraktioner och konfigurerbara gameplay-effekter när partnerna är nära varandra.

⚙️ Funktioner

• Äktenskapsförfrågningar mellan spelare och, som tillval, ceremonier ledda av en präst.
• Teleportering till partnern (teleport to partner) och ett gemensamt hem som båda partnerna kan teleportera till.
• Privat parchatt och en toggle för att skicka all chatt till partnern istället för den offentliga chatten.
• Gåvoföremål: spelare kan ge föremålet i handen till sin partner.
• PvP-toggle mellan partner (aktivera/inaktivera PvP med din partner).
• Kosmetiska actions som kiss med partikelseffekter.
• XP- och regenerationsbonusar när partnerna är nära (integrationer nämns för Minecraft XP, mcMMO, SkillAPI).
• Valfri delad backpack / Minepacks-integration.
• Stöd för flera språk via konfigurerbara språkfiler.
• Konfigurerbara lagringsbackends: SQLite och MySQL stöds.
• API för pluginutvecklare att interagera med Marriage Master-data och events.

🧩 Vem det är för

• Roleplay- och sociala servrar som vill ha relationsmekanik i spelet.
• SMP- eller survivalservrar som vill ha valfria samarbetssförmåner för spelarpar.
• Serveradministratörer som behöver konfigurerbara behörigheter och integrationer med ekonomi eller andra plugin.

🏗️ Exempel på användning

• Två spelare skickar en äktenskapsförfrågan och får ett gemensamt hem och en privat chattkanal.
• En server aktiverar prästerliga ceremonier för events och ger specialföremål eller titlar vid äktenskap via server scripting eller API-hooks.
• Par använder kommandot gift för att byta föremål i handen som en del av roleplay.

⌨️ Kommandon

Obs: de officiella källorna listar dessa kommandon men dokumenterar inte permission nodes direkt på resursidan; behörigheter finns i pluginets dokumentation och behörighetslista.

⚙️ Installation

📥 Setup

• Ladda ner pluginets JAR från den officiella resursidan och lägg JAR-filen i serverns katalog plugins/.
• Starta om servern och kontrollera konsolutdata för att bekräfta att pluginet laddades korrekt.

📦 Beroenden

• Java 8 krävs vid körning.
• Bekräftade runtime-plattformar: Bukkit, Spigot, Paper.
• Valfria integrationer/beroenden dokumenterade av skaparen: Vault (valfritt, för ekonomifunktioner), PCGF PluginLib (valfritt), Minepacks-integration, Placeholder-stöd.
• Valfritt proxy-stöd: BungeeCord / Waterfall.

🧾 Konfiguration

• Pluginet erbjuder en omfattande, dokumenterad konfiguration och språkfiler som gör det möjligt att anpassa nästan allt beteende, alla meddelanden och funktioner.
• Lagring kan konfigureras att använda SQLite eller MySQL.

🧠 Tekniska anteckningar

• Stödd servermjukvara: Bukkit, Spigot, Paper (skaparen anger stöd för Bukkit/Spigot/Paper och valfritt BungeeCord/Waterfall proxy-stöd).
• Kräver Java 8 vid körning.
• Projektet innehåller ett API för utvecklare och tillhandahåller JavaDoc-dokumentation för integration.
• Pluginet stöder UUID-/namnändringar och har flerspråkigt stöd via resource files.

🤝 När detta plugin är användbart

Om du driver en roleplay-, social- eller SMP-server och vill ha ett äktenskapssystem i spelet med konfigurerbara perks, privata verktyg för par och hooks för utvecklare, erbjuder Marriage Master dessa funktioner med databassupport och integrationer för vanliga serverekosystem.