PlaceholderAPI — plugin til indsættelse af dynamiske data i Minecraft
PlaceholderAPI (PAPI) indsætter dynamiske data — spillernavn, rang, saldo — i chat, scoreboard og menuer på en Minecraft-server.
PlaceholderAPI (PAPI) indsætter dynamiske data — spillernavn, rang, saldo — i chat, scoreboard og menuer på en Minecraft-server.
PlaceholderAPI — plugin til indsættelse af dynamiske data i Minecraft
Minecraft-version, som artiklen er testet og skrevet på: 26.1.2
Understøttet versionsinterval: 1.8.x – 26.1.x
PlaceholderAPI (forkortet PAPI) er et serverplugin til Minecraft, der indsætter dynamiske værdier i teksten i stedet for specielle markører. I sig selv viser det ikke noget: det er en motor, der i en streng finder en markør af typen %player_name% og erstatter den med den aktuelle værdi — spillerens navn, saldo, rang, antal spillere online. Selve dataene leveres af separate moduler — udvidelser — mens PAPI kun udfører selve erstatningen. Takket være dette læser chat-, scoreboard-, tab-list- og menuplugins værdierne i ét og samme format uden egen syntaks.
Placeholder-format
En placeholder skrives mellem to procenttegn: %<розширення>_<параметр>%. Den første del før understregningen er navnet på udvidelsen, derefter kommer den konkrete parameter. For eksempel returnerer %player_name% spillerens navn, mens %server_online% returnerer antallet af spillere online.
Erstatningen virker kun der, hvor det modtagende plugin selv kalder den. Hvis et plugin ikke understøtter PAPI, forbliver markørerne i dets beskeder almindelig tekst. Du kan teste en enkelt placeholder med analysekommandoen:
/papi parse me %player_name%
Hvis svaret returnerer selve markørteksten i stedet for en værdi, mangler den nødvendige udvidelse, eller kildepluginet er deaktiveret.
Udvidelser og eCloud
PlaceholderAPI indeholder som udgangspunkt ingen placeholders — de kommer alle fra udvidelser. Nogle er indbygget i kildepluginet og registrerer sig selv, når serveren starter; andre findes som separate jar-filer i udvidelsesskyen (eCloud) og installeres i mappen /plugins/PlaceholderAPI/expansions/.
Den ønskede udvidelse kan hentes direkte fra spillet:
/papi ecloud download <розширення>
/papi reload
Via kommandoen hentes kun verificerede udvidelser — det er en beskyttelse mod skadelig kode. Ikke-verificerede installeres manuelt: jar-filen downloades fra webstedet og lægges i udvidelsesmappen.
Adgang til eCloud: hvis hosting eller firewall blokerer eksterne forbindelser, virker download via kommandoen ikke — udvidelsen skal så tilføjes manuelt.
Kommandoer
Alle kommandoer starter med /papi. Som standard er de kun tilgængelige for operatører; specifikke rettigheder tildeles via nodes placeholderapi.*.
Kommando | Formål |
| Analysér placeholders i tekst for en spiller |
| Analysér relationelle placeholders for to spillere |
| Vis aktive udvidelser |
| Information om en bestemt udvidelse |
| Hent en udvidelse fra skyen |
| Liste over udvidelsens placeholders |
| Genindlæs pluginet og konfigurationen |
| Version af det installerede plugin |
Konfiguration
I config.yml er det kun et par parametre, det er relevant at redigere:
Parameter | Hvad den gør |
| Forbindelse til eCloud. |
| Tekst for placeholders' booleske værdier; kan ændres til ja / nej |
| Dato- og klokkeslætsformat for de tilhørende placeholders |
| Tjekker for plugin-opdateringer ved opstart og giver operatører besked |
De øvrige værdier i filen er interne (beskyttelse af udvidelser, erstatningstilstand i Adventure-komponenter, debug) og ændres som standard ikke.
Konklusion
PlaceholderAPI giver ét fælles format til dataindsættelse, som hundredvis af plugins forstår: i stedet for en separat integration for hvert plugin er én enkelt linje med en placeholder nok. Det er nyttigt for administratorer af Minecraft-servere med chat, tab-list, scoreboard eller menuer baseret på dynamiske data; til singleplayer har det ingen anvendelse.
Installation
En typisk installation tager omkring 5 minutter. Forløbet er det samme; kun Loader og den matchende build er forskellige.
- 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.
