Minecraft-plugin MarriageMaster

🔌 Om Marriage Master

Marriage Master er et Bukkit/Spigot Minecraft-plugin, der tilbyder et konfigurerbart ægteskabssystem til servere. Det lader spillere indgå ægteskaber (enkelt eller flere, hvis det er konfigureret) og giver gifte spillere samarbejdsfunktioner og kommandoer. Projektet indeholder en API til udviklere og understøtter vedvarende lagring.

🎯 Formål

Pluginet er designet til roleplay- og sociale servere, der ønsker en ægteskabsmekanisme i spillet: for at give par delte værktøjer, privat chat, valgfrie økonomiinteraktioner og konfigurerbare gameplay-effekter, når partnerne er tæt på hinanden.

⚙️ Funktioner

• Ægteskabsanmodninger mellem spillere og ceremonier ledet af en præst (valgfrit).
• Teleport til partner (teleport to partner) og et delt hjem, som begge partnere kan teleportere til.
• Privat parchat og en toggle til at sende al chat til partneren i stedet for offentlig chat.
• Gavegenstande: spillere kan give den genstand, de holder i hånden, til deres partner.
• PvP-toggle mellem partnere (slå PvP med din partner til/fra).
• Kosmetiske handlinger som kiss med partikeleffekter.
• XP- og regenereringsbonusser, når partnere er i nærheden (integrationer nævnes for Minecraft XP, mcMMO, SkillAPI).
• Valgfri delt backpack / Minepacks-integration.
• Understøttelse af flere sprog via konfigurerbare sprogfiles.
• Konfigurerbare lagringsbackends: SQLite og MySQL understøttes.
• API til pluginudviklere, så de kan interagere med Marriage Master-data og events.

🧩 Hvem det er til

• Roleplay- og sociale servere, der ønsker relationmekanik i spillet.
• SMP- eller survival-servere, der ønsker valgfrie samarbejdsfordele for spillerpar.
• Serveradministratorer, der har brug for konfigurerbare tilladelser og integrationer med økonomi eller andre plugins.

🏗️ Eksempler på brug

• To spillere sender en ægteskabsanmodning og får et delt hjem og en privat chatkanal.
• En server aktiverer præsteceremonier til events og giver særlige genstande eller titler ved ægteskab via server scripting eller API hooks.
• Par bruger gift-kommandoen til at bytte genstande i hånden som en del af roleplay.

⌨️ Kommandoer

Bemærk: de officielle kilder lister disse kommandoer, men dokumenterer ikke permission nodes direkte på ressource-siden; tilladelser findes i pluginets dokumentation og tilladelsesliste.

⚙️ Installation

📥 Opsætning

• Download pluginets JAR fra den officielle ressource-side, og læg JAR-filen i serverens plugins/-mappe.
• Genstart serveren, og kontroller konsoloutput for at bekræfte, at pluginet blev indlæst korrekt.

📦 Afhængigheder

• Java 8 kræves under runtime.
• Bekræftede runtime-platforme: Bukkit, Spigot, Paper.
• Valgfrie integrationer/afhængigheder dokumenteret af forfatteren: Vault (valgfrit, til økonomifunktioner), PCGF PluginLib (valgfrit), Minepacks-integration, Placeholder-support.
• Valgfri proxy-understøttelse: BungeeCord / Waterfall.

🧾 Konfiguration

• Pluginet leverer en omfattende, dokumenteret konfiguration og sprogfiles, som gør det muligt at tilpasse næsten al adfærd, alle beskeder og funktioner.
• Lagring kan konfigureres til at bruge SQLite eller MySQL.

🧠 Tekniske noter

• Understøttet serversoftware: Bukkit, Spigot, Paper (forfatteren angiver support til Bukkit/Spigot/Paper og valgfri BungeeCord/Waterfall proxy-understøttelse).
• Kræver Java 8 under runtime.
• Projektet indeholder en API til udviklere og leverer JavaDoc-dokumentation til integration.
• Pluginet understøtter UUID-/navneændringer og har flersproget support via resource files.

🤝 Hvornår dette plugin er nyttigt

Hvis du driver en roleplay-, social- eller SMP-server og ønsker et ægteskabssystem i spillet med konfigurerbare perks, private værktøjer til par og hooks til udviklere, leverer Marriage Master disse funktioner med databassupport og integrationer til almindelige server-økosystemer.