PlaceholderAPI — plugin för att infoga dynamisk data i Minecraft

PlaceholderAPI — plugin för att infoga dynamisk data i Minecraft

• Minecraft-version som artikeln är testad och skriven med: 26.1.2

• Intervall av versioner som stöds: 1.8.x – 26.1.x

PlaceholderAPI (förkortat PAPI) är en serverplugin för Minecraft som ersätter speciella markörer i text med dynamiska värden. Den genererar inget i sig själv: det är en motor som letar efter en markör av typen %player_name% i en textrad och byter ut den mot ett aktuellt värde — spelarens namn, saldo, rang eller antal spelare online. Själva datan levereras av separata moduler, så kallade tillägg, medan PAPI bara utför själva ersättningen. Tack vare detta läser chatt-, scoreboard-, tab-lista- och menyplugins värdena i samma format, utan egen syntax.

Platshållarnas format

En platshållare skrivs mellan två procenttecken: %<розширення>_<параметр>%. Den första delen fram till understrecket är tilläggets namn, därefter kommer själva parametern. Till exempel returnerar %player_name% spelarens namn, medan %server_online% ger antalet spelare online.

Ersättningen fungerar bara där den mottagande pluginen själv anropar den. Om en plugin inte stöder PAPI förblir markörerna i dess meddelanden som vanlig text. En enskild platshållare kan testas med analyskommandot:

/papi parse me %player_name%

Om svaret är själva markörtexten och inte ett värde saknas det nödvändiga tillägget, eller så är källpluginen avstängd.

Tillägg och eCloud

PlaceholderAPI innehåller inga platshållare från början — alla kommer från tillägg. Vissa är inbyggda i källpluginen och registrerar sig själva när servern startar; andra ligger som separata jar-filer i tilläggsmolnet (eCloud) och installeras i katalogen /plugins/PlaceholderAPI/expansions/.

Det önskade tillägget kan laddas ner direkt från spelet:

/papi ecloud download <розширення>

/papi reload

Via kommandot laddas endast verifierade tillägg ner — det skyddar mot skadlig kod. Overifierade tillägg installeras manuellt: jar-filen laddas ner från webbplatsen och läggs i tilläggsmappen.

Kommandon

Alla kommandon börjar med /papi. Som standard är de bara tillgängliga för operatörer; enskilda rättigheter delas ut via noderna placeholderapi.*.

Konfiguration

I config.yml är det bara några få parametrar som är värda att redigera:

Övriga värden i filen är interna (skydd av tillägg, ersättningsläge i Adventure-komponenter, felsökning) och rörs normalt inte.

Slutsats

PlaceholderAPI ger ett enhetligt format för datasubstitution som hundratals plugins förstår: istället för en separat integration för varje plugin räcker det med en rad med en platshållare. Det behövs av administratörer för Minecraft-servrar med chatt, tab-lista, scoreboard eller meny baserad på dynamisk data; i enspelarläge har det ingen användning.