Minecraft plugin PlaceholderAPI

🔌 Over PlaceholderAPI

PlaceholderAPI is een Minecraft-plugin die een gecentraliseerd placeholdersysteem en een ecosysteem van uitbreidingen (de eCloud) biedt. Hiermee kunnen andere plugins duizenden dynamische placeholders lezen en vervangen (spelersdata, economiegegevens, plugin-specifieke waarden, enz.) zonder directe integratie of zware afhankelijkheden.

🎯 Doel

De plugin lost integratieproblemen tussen plugins op door één uitbreidbare placeholder-API te bieden. Pluginmakers publiceren "expansions" die benoemde placeholders leveren; serverbeheerders installeren die expansions zodat servergerichte plugins (scoreboards, chat, holograms, GUI's) live gegevens kunnen tonen met een consistente syntax.

⚙️ Functies

• Kern-API voor het parsen van placeholders, waar andere plugins op kunnen aansluiten.
• Systeem voor expansions: afzonderlijk verpakte expansions of expansions die in plugins zijn meegebundeld.
• eCloud (expansion cloud) om geverifieerde expansions in-game te vinden en te downloaden.
• Beheercommando's tijdens runtime voor het tonen van lijsten, registreren, deregistreren en herladen van expansions.
• Debug-/parse-commando's om placeholders voor een speler te evalueren of resultaten te broadcasten, handig bij troubleshooting.
• Hulpmiddelen zoals een dump-commando om geïnstalleerde expansions en de pluginstatus te delen wanneer je ondersteuning zoekt.

🧩 Voor wie is het

• Serverbeheerders die uniforme dynamische tekst nodig hebben over meerdere plugins heen (scoreboards, tablijsten, holograms, GUI's).
• Pluginontwikkelaars die placeholders willen aanbieden of gebruiken zonder zware afhankelijkheden op te leggen.
• Survival-, minigame- en netwerkservers die veel plugins combineren en een consistente placeholder-syntax nodig hebben.

🏗️ Voorbeeldtoepassingen

• Een server installeert een Vault-expansion zodat economische placeholders zoals het saldo van een speler kunnen worden gebruikt in scoreboard- en chatplugins.
• Een beheerder downloadt een plugin-specifieke expansion uit de eCloud zodat een hologramplugin live doelgegevens kan tonen.
• Een ontwikkelaar stelt plugingegevens beschikbaar via een PlaceholderExpansion, zodat andere servers die gegevens kunnen tonen zonder direct van de plugin afhankelijk te zijn.

⌨️ Commando's

(Opmerking: de bovenstaande commando's zijn gedocumenteerd in de officiële PlaceholderAPI-commandoverwijzing. Permission-nodes voor afzonderlijke commando's worden niet vermeld in de geraadpleegde documentatie.)

⚙️ Installatie

📥 Instellen

• Download de officiële PlaceholderAPI-jar en plaats die in de map plugins/ van je server.
• Start of herstart de server en controleer in de console of PlaceholderAPI wordt geladen.
• Installeer expansions door jar-bestanden in plugins/PlaceholderAPI/expansions/ te plaatsen, of via de in-game eCloud-commando's (voor geverifieerde expansions).

📦 Afhankelijkheden

• PlaceholderAPI zelf heeft geen algemene plugin-afhankelijkheid nodig om te werken. Sommige placeholders van expansions zijn afhankelijk van andere plugins (bijvoorbeeld een expansion die economiegegevens toont, vereist de bijbehorende economieplugin). Die vereisten hangen af van de specifieke expansion.

🧠 Technische notities

• PlaceholderAPI is beschikbaar voor op Spigot gebaseerde servers en wordt ook veel gebruikt op Paper. Het biedt een API waarmee pluginontwikkelaars PlaceholderExpansions kunnen registreren.
• Expansions kunnen worden verspreid als zelfstandige jar-bestanden of worden meegebundeld in andere plugins; zelfstandige expansions worden meestal geïnstalleerd in plugins/PlaceholderAPI/expansions/.
• Met de eCloud-functie kun je geverifieerde expansions in-game ontdekken en downloaden; servers moeten uitgaande HTTPS toestaan om eCloud-downloads te laten werken.
• De plugin bevat debug- en parse-commando's om beheerders te helpen controleren of placeholders correct worden opgelost.

🤝 Wanneer deze plugin nuttig is

Als je server meerdere plugins gebruikt die dynamische, cross-plugin gegevens moeten tonen (chat, tab, holograms, scoreboards of GUI's), is PlaceholderAPI nuttig omdat het de afhandeling van placeholders centraliseert en je ondersteuning voor extra plugins kunt toevoegen via modulaire expansions zonder elke consumer-plugin aan te passen.