Minecraft-plugin CommandButtons

🔌 Om CommandButtons

CommandButtons er en Minecraft-plugin til at knytte kommandoer til blokinteraktioner. Den giver serveradministratorer mulighed for at knytte sæt af kommandoer til blokke (knapper, skilte, trykplader eller klikbare blokke), så kommandoerne kører, når en spiller interagerer med den konfigurerede blok. Pluginet understøtter at køre kommandoer som konsollen og/eller som den spiller, der udløste blokken, og det indeholder også en GUI-editor i spillet til at administrere knapper og deres egenskaber.

🎯 Formål

Pluginet løser problemet med at skabe interaktive verdens-elementer, der udfører administrative eller gameplay-relaterede handlinger uden at kræve, at spillerne skriver kommandoer. Typiske anvendelser omfatter teleporttavler, kit-vælgere, købbare handlinger og tilpassede mekanikker, der udløses af blokinteraktioner.

⚙️ Funktioner

• Knyt et ubegrænset antal kommandoer til én command button (konsol- og spillerkommandoer).
• GUI-editor i spillet til at oprette og redigere command buttons og deres placeringer.
• Cooldowns pr. spiller og globale; cooldowns bevares efter servergenstarter.
• Valgfri økonomiintegration via Vault for at opkræve spillere for brug af knapper.
• Brugerdefinerede permission nodes til at begrænse brugen af bestemte knapper.
• Tilpasselige beskeder via en messages-fil.
• Flere placeringer pr. command button, så én konfiguration kan gælde for mange blokke.
• Grundlæggende kommandoer til at oprette, redigere og genindlæse plugin-data.

🧩 Hvem er det til

• Serveradministratorer og byggere, der ønsker klikbare verdens-elementer, som kører kommandoer.
• Minigame- og lobbyservere, der har brug for interaktive menuer eller teleport-/kitvalgstavler.
• Servere, der bruger økonomiplugins og ønsker en betaling-per-brug-mekanisme.

🏗️ Eksempler på brug

• En spawn-teleporttavle, hvor hver knap teleporterer den spillende til en anden arena.
• En væg til kitvalg: at trykke på en knap kører et sæt kommandoer, der giver kits og beskeder.
• En købbar handling: en knap opkræver in-game valuta og udfører en belønningskommando.

⌨️ Kommandoer

🔐 Tilladelser

⚙️ Installation

📥 Opsætning

• Download den officielle plugin-jar og læg den i serverens plugins/-mappe.
• Genstart serveren og tjek konsolloggene for at bekræfte, at pluginet blev indlæst korrekt.
• Brug de medfølgende /commandbuttons-kommandoer til at oprette og redigere knapkonfigurationer i spillet.

📦 Afhængigheder

• Valgfrit: Vault for at aktivere økonomiopkrævning. En økonomiplugin, der integrerer med Vault (for eksempel EssentialsX economy), er påkrævet for at bruge funktionen betaling pr. brug.

🧠 Tekniske noter

• Pluginet leverer en GUI-editor og opretter konfigurations-/beskedsfiler til tilpasning.
• Cooldowns bevares efter servergenstarter.
• Både konsol- og spillerudførelsesmodi understøttes; kommandoer, der køres som spilleren, bruger spillerens tilladelser (kommandoer, der kræver højere tilladelser end spillerens, vil ikke køre, når de udføres som spilleren).
• Økonomifunktioner kræver Vault og et understøttet økonomiplugin.

🤝 Hvornår dette plugin er nyttigt

Brug CommandButtons, når du har brug for konfigurerbare, lokationsbundne handlinger, der udløses af spillerinteraktioner (knapper, skilte, plader) med indbyggede cooldowns, permission-tjek og valgfrie økonomiske omkostninger, styret via en in-game editor.