Minecraft-plugin PlaceholderAPI

🔌 Om PlaceholderAPI

PlaceholderAPI er et Minecraft-plugin, der tilbyder et centraliseret placeholder-system og et økosystem af udvidelser (eCloud). Det gør det muligt for andre plugins at læse og erstatte tusindvis af dynamiske placeholders (spillerdata, økonomiværdier, plugin-specifikke værdier osv.) uden direkte integration eller tunge afhængigheder.

🎯 Formål

Pluginet løser integrationsfriktion mellem plugins ved at tilbyde ét udvidbart placeholder-API. Pluginudviklere udgiver "expansions", som leverer navngivne placeholders; serveradministratorer installerer disse expansioner, så servervendte plugins (scoreboards, chat, holograms, GUI'er) kan vise live-data med en konsistent syntaks.

⚙️ Funktioner

• Kerne-API til parsing af placeholders, som andre plugins kan hooke ind i.
• Expansions-system: separat pakkede expansioner eller expansioner bundtet inde i plugins.
• eCloud (expansion cloud) til at finde og downloade verificerede expansioner i spillet.
• Administrationskommandoer under kørsel til at liste, registrere, afregistrere og genindlæse expansioner.
• Debug-/parse-kommandoer til at evaluere placeholders for en spiller eller udsende resultater, nyttigt til fejlfinding.
• Hjælpefunktioner som dump-kommandoen til at dele installerede expansioner og pluginstatus, når du søger support.

🧩 Hvem er det til

• Serveradministratorer, der har brug for ensartet dynamisk tekst på tværs af flere plugins (scoreboards, tablister, holograms, GUI'er).
• Pluginudviklere, der vil eksponere eller bruge placeholders uden at tvinge tunge afhængigheder.
• Survival-, minigame- og network-servere, der kombinerer mange plugins og har brug for ensartet placeholder-syntaks.

🏗️ Eksempler på brug

• En server installerer en Vault-expansion, så økonomi-placeholders som spillerbalance kan bruges i scoreboard- og chatplugins.
• En administrator downloader en plugin-specifik expansion fra eCloud, så et hologram-plugin kan vise live mål-data.
• En udvikler eksponerer plugin-data via en PlaceholderExpansion, så andre servere kan vise dataene uden at være direkte afhængige af pluginet.

⌨️ Kommandoer

(Bemærk: kommandoerne ovenfor er dokumenteret i den officielle PlaceholderAPI-kommandooversigt. Tilladelsesnoder for individuelle kommandoer er ikke angivet i den henviste dokumentation.)

⚙️ Installation

📥 Opsætning

• Download den officielle PlaceholderAPI-jar og placer den i serverens plugins/-mappe.
• Start eller genstart serveren, og bekræft at PlaceholderAPI indlæses i konsollen.
• Installer expansioner enten ved at lægge expansion-jars i plugins/PlaceholderAPI/expansions/ eller ved at bruge eCloud-kommandoerne i spillet (for verificerede expansioner).

📦 Afhængigheder

• PlaceholderAPI kræver ikke i sig selv en generel plugin-afhængighed for at fungere. Nogle placeholders, der leveres af expansioner, afhænger af andre plugins (for eksempel kræver en expansion, der viser økonomiværdier, det tilsvarende økonomiplugin). Disse krav afhænger af den specifikke expansion.

🧠 Tekniske noter

• PlaceholderAPI leveres til Spigot-baserede servere og bruges også ofte på Paper. Det eksponerer et API, så pluginudviklere kan registrere PlaceholderExpansions.
• Expansioner kan distribueres som selvstændige jar-filer eller være bundtet i andre plugins; selvstændige expansioner installeres normalt i plugins/PlaceholderAPI/expansions/.
• eCloud-funktionen gør det muligt at opdage og downloade verificerede expansioner i spillet; servere skal tillade udgående HTTPS for at eCloud-downloads kan fungere.
• Pluginet indeholder debug- og parse-kommandoer, som hjælper administratorer med at verificere, at placeholders bliver løst korrekt.

🤝 Hvornår er dette plugin nyttigt

Hvis din server bruger flere plugins, der skal vise dynamiske data på tværs af plugins (chat, tab, holograms, scoreboards eller GUI'er), er PlaceholderAPI nyttigt, fordi det centraliserer placeholder-håndteringen og lader dig tilføje understøttelse af flere plugins via modulære expansioner uden at ændre hvert enkelt forbruger-plugin.