PlaceholderAPI — de plugin voor het invoegen van dynamische gegevens in Minecraft
PlaceholderAPI (PAPI) voegt dynamische gegevens — spelernaam, rang, saldo — toe aan chat, scoreboard en menu's van een Minecraft-server.
PlaceholderAPI (PAPI) voegt dynamische gegevens — spelernaam, rang, saldo — toe aan chat, scoreboard en menu's van een Minecraft-server.
PlaceholderAPI — de plugin voor het invoegen van dynamische gegevens in Minecraft
Minecraft-versie waarop het artikel is getest en geschreven: 26.1.2
Bereik van ondersteunde versies: 1.8.x – 26.1.x
PlaceholderAPI (afgekort PAPI) is een serverplugin voor Minecraft die dynamische waarden in de tekst invoegt in plaats van speciale markeringen. Op zichzelf toont het niets: het is een engine die in een tekstregel een markering van het type %player_name% opzoekt en deze vervangt door de actuele waarde — de naam van de speler, het saldo, de rang, het aantal spelers online. De gegevens zelf worden geleverd door aparte modules — de expansions — terwijl PAPI alleen de vervanging uitvoert. Hierdoor lezen chat-, scoreboard-, tab-list- en menuplugins de waarden in één en hetzelfde formaat, zonder eigen syntaxis.
Placeholderformaat
Een placeholder wordt geschreven tussen twee procenttekens: %<розширення>_<параметр>%. Het eerste deel, vóór het liggende streepje, is de naam van de expansion; daarna volgt de specifieke parameter. Zo geeft %player_name% de naam van de speler terug, en %server_online% het aantal spelers online.
De vervanging werkt alleen daar waar de ontvangende plugin zelf de aanroep doet. Als een plugin PAPI niet ondersteunt, blijven de markeringen in de berichten ervan gewone tekst. Je kunt een afzonderlijke placeholder testen met het analysecommando:
/papi parse me %player_name%
Als het antwoord de tekst van de markering zelf teruggeeft in plaats van een waarde, ontbreekt de benodigde expansion of is de bronplugin uitgeschakeld.
Expansions en eCloud
PlaceholderAPI bevat standaard geen enkele placeholder — die komen allemaal uit expansions. Sommige zijn ingebouwd in de bronplugin en registreren zichzelf automatisch bij het opstarten van de server; andere bestaan als afzonderlijke jar-bestanden in de expansion-cloud (eCloud) en worden geïnstalleerd in de map /plugins/PlaceholderAPI/expansions/.
De gewenste expansion kan rechtstreeks vanuit het spel worden gedownload:
/papi ecloud download <розширення>
/papi reload
Via het commando worden alleen geverifieerde expansions gedownload — dit is een bescherming tegen schadelijke code. Niet-geverifieerde expansions worden handmatig geïnstalleerd: de jar wordt van de website gedownload en in de expansion-map geplaatst.
Toegang tot eCloud: als de hosting of firewall externe verbindingen blokkeert, werkt het downloaden via het commando niet — de expansion moet dan handmatig worden toegevoegd.
Commando's
Alle commando's beginnen met /papi. Standaard zijn ze alleen beschikbaar voor operators; afzonderlijke rechten worden toegekend via de nodes placeholderapi.*.
Commando | Doel |
| Placeholders in tekst voor een speler analyseren |
| Relationele placeholders voor twee spelers analyseren |
| Actieve expansions weergeven |
| Informatie over een specifieke expansion |
| Een expansion uit de cloud downloaden |
| Lijst van placeholders van de expansion |
| Plugin en configuratie herladen |
| Versie van de geïnstalleerde plugin |
Configuratie
In config.yml zijn slechts enkele parameters nuttig om te bewerken:
Parameter | Wat het doet |
| Verbinding met eCloud. |
| Tekst van de booleaanse placeholderwaarden; kan worden vervangen door ja / nee |
| Datum- en tijdformaat voor de bijbehorende placeholders |
| Controleert bij het opstarten op plugin-updates en waarschuwt operators |
De overige waarden in het bestand zijn interne instellingen (bescherming van expansions, vervangingsmodus in Adventure-componenten, debug) en worden standaard niet aangepast.
Conclusie
PlaceholderAPI biedt één enkel formaat voor het invoegen van gegevens dat door honderden plugins wordt begrepen: in plaats van een aparte integratie per plugin volstaat één regel met een placeholder. Het is nuttig voor beheerders van Minecraft-servers met chat, tab-list, scoreboard of menu's op basis van dynamische gegevens; voor singleplayer heeft het geen toepassing.
Installatie
Een typische installatie duurt ongeveer 5 minuten. De stappen zijn gelijk; alleen de loader en de bijbehorende build verschillen.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
