PlaceholderAPI — plugin for innsetting av dynamiske data i Minecraft
PlaceholderAPI (PAPI) bytter ut plassholdere i tekst med dynamiske verdier som spillernavn eller saldo. Guide til kommandoer, utvidelser og…
PlaceholderAPI (PAPI) bytter ut plassholdere i tekst med dynamiske verdier som spillernavn eller saldo. Guide til kommandoer, utvidelser og innstillinger.
PlaceholderAPI — plugin for innsetting av dynamiske data i Minecraft
Minecraft-versjonen artikkelen er testet og skrevet med: 26.1.2
Støttet versjonsspenn: 1.8.x – 26.1.x
PlaceholderAPI (forkortet PAPI) er en server-plugin til Minecraft som setter dynamiske verdier inn i tekst i stedet for spesielle markører. Selv genererer den ingenting: det er en motor som finner en markør av typen %player_name% i en tekststreng og bytter den ut med en aktuell verdi — spillernavn, saldo, rang, antall spillere på serveren. Selve dataene leveres av egne moduler, kalt utvidelser, mens PAPI bare utfører selve byttet. Takket være dette leser chat-, scoreboard-, tab-liste- og menyplugins verdiene i samme format, uten egen syntaks.
Format på plassholdere
En plassholder skrives mellom to prosenttegn: %<розширення>_<параметр>%. Den første delen før understreken er navnet på utvidelsen, deretter kommer selve parameteren. For eksempel returnerer %player_name% spillerens navn, mens %server_online% gir antall spillere som er pålogget.
Byttet skjer bare der den mottakende pluginen selv kaller det opp. Hvis en plugin ikke støtter PAPI, blir markørene i meldingene stående som vanlig tekst. Du kan teste en enkelt plassholder med analysekommandoen:
/papi parse me %player_name%
Hvis svaret er selve markørteksten og ikke en verdi, mangler den nødvendige utvidelsen, eller kilde-pluginen er slått av.
Utvidelser og eCloud
PlaceholderAPI inneholder ingen plassholdere i utgangspunktet — alle kommer fra utvidelser. Noen er innebygd i kilde-pluginen og registrerer seg selv når serveren starter; andre finnes som egne jar-filer i utvidelsesskyen (eCloud) og installeres i mappen /plugins/PlaceholderAPI/expansions/.
Du kan laste ned ønsket utvidelse direkte fra spillet:
/papi ecloud download <розширення>
/papi reload
Via kommandoen lastes det bare ned verifiserte utvidelser — dette beskytter mot skadelig kode. Ikke-verifiserte utvidelser installeres manuelt: jar-filen lastes ned fra nettsiden og legges i utvidelsesmappen.
Tilgang til eCloud: hvis hostingen eller brannmuren blokkerer ekstern tilkobling, vil nedlasting via kommandoen ikke fungere — utvidelsen må da legges til manuelt.
Kommandoer
Alle kommandoer starter med /papi. Som standard er de kun tilgjengelige for operatører; enkelte rettigheter deles ut via nodene placeholderapi.*.
Kommando | Funksjon |
| Tolk plassholdere i tekst for en spiller |
| Tolk relasjonelle plassholdere for to spillere |
| Vis aktive utvidelser |
| Informasjon om en bestemt utvidelse |
| Last ned en utvidelse fra skyen |
| Liste over utvidelsens plassholdere |
| Last inn pluginen og konfigurasjonen på nytt |
| Versjonen av den installerte pluginen |
Konfigurasjon
I config.yml er det bare noen få parametre som er nyttige å redigere:
Parameter | Hva den gjør |
| Tilkobling til eCloud. |
| Teksten for boolske verdier i plassholdere; kan endres til for eksempel ja / nei |
| Dato- og klokkeslettformat for de tilhørende plassholderne |
| Sjekker for oppdateringer av pluginen ved oppstart og varsler operatørene |
De øvrige verdiene i filen er interne (beskyttelse av utvidelser, erstatningsmodus i Adventure-komponenter, feilsøking), og de røres ikke som standard.
Konklusjon
PlaceholderAPI gir ett felles format for datainnsetting som hundrevis av plugins forstår: i stedet for en egen integrasjon for hver enkelt plugin holder det med én linje med en plassholder. Det trengs av administratorer av Minecraft-servere med chat, tab-liste, scoreboard eller meny basert på dynamiske data; i enspiller har det ingen bruksverdi.
Installasjon
En typisk installasjon tar omtrent 5 minutter. Flyten er den samme; bare Loader og den matchende builden er forskjellige.
- 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.
