PlaceholderAPI — lisäosa dynaamisten tietojen korvaamiseen Minecraftissa
PlaceholderAPI (PAPI) korvaa tekstissä paikkamerkit dynaamisilla arvoilla, kuten pelaajan nimellä tai saldolla. Opas komentoihin…
PlaceholderAPI (PAPI) korvaa tekstissä paikkamerkit dynaamisilla arvoilla, kuten pelaajan nimellä tai saldolla. Opas komentoihin, laajennuksiin ja asetuksiin.
PlaceholderAPI — lisäosa dynaamisten tietojen korvaamiseen Minecraftissa
Minecraft-versio, jolla artikkeli on testattu ja kirjoitettu: 26.1.2
Tuettujen versioiden alue: 1.8.x – 26.1.x
PlaceholderAPI (lyhennettynä PAPI) on Minecraftin palvelinlisäosa, joka korvaa tekstissä olevat paikkamerkit dynaamisilla arvoilla. Se ei itsessään tuota mitään: kyseessä on moottori, joka etsii rivistä merkinnän muotoa %player_name% ja korvaa sen ajantasaisella arvolla — pelaajan nimellä, saldolla, arvoasteella tai palvelimen pelaajamäärällä. Itse tiedot toimittavat erilliset moduulit eli laajennukset, ja PAPI vain suorittaa korvauksen. Tämän ansiosta chatin, scoreboardin, tab-listan ja valikoiden lisäosat lukevat arvot samassa muodossa, ilman omaa syntaksia.
Paikkamerkkien muoto
Paikkamerkki kirjoitetaan kahden prosenttimerkin väliin: %<розширення>_<параметр>%. Ensimmäinen osa ennen alaviivaa on laajennuksen nimi, seuraava osa on itse parametri. Esimerkiksi %player_name% palauttaa pelaajan nimen, ja %server_online% palvelimella olevien pelaajien määrän.
Korvaus toimii vain siellä, missä vastaanottava lisäosa itse sen kutsuu. Jos lisäosa ei tue PAPI:a, sen viesteissä olevat paikkamerkit jäävät tavalliseksi tekstiksi. Yksittäisen paikkamerkin voi tarkistaa jäsennyskomennolla:
/papi parse me %player_name%
Jos vastauksena tulee itse merkinnän teksti eikä arvo, tarvittavaa laajennusta ei ole asennettu tai lähdeplugin on pois päältä.
Laajennukset ja eCloud
PlaceholderAPI ei sisällä valmiiksi yhtäkään paikkamerkkiä — ne kaikki tulevat laajennuksista. Osa on sisäänrakennettu lähdeplugineihin ja rekisteröityy itse palvelimen käynnistyessä; toiset ovat erillisiä jar-tiedostoja laajennuspilvessä (eCloud), ja ne asennetaan hakemistoon /plugins/PlaceholderAPI/expansions/.
Tarvittavan laajennuksen voi ladata suoraan pelistä:
/papi ecloud download <розширення>
/papi reload
Komennolla ladataan vain tarkastettuja laajennuksia — tämä suojaa haitalliselta koodilta. Tarkastamattomat laajennukset asennetaan käsin: jar-tiedosto ladataan sivustolta ja siirretään laajennuskansioon.
Pääsy eCloudiin: jos hosting tai palomuuri estää ulkoisen yhteyden, lataus komennolla ei toimi — laajennus on tällöin lisättävä käsin.
Komennot
Kaikki komennot alkavat merkinnällä /papi. Oletuksena ne ovat käytettävissä vain operaattoreille; yksittäisiä oikeuksia jaetaan solmujen placeholderapi.* kautta.
Komento | Käyttötarkoitus |
| Jäsentää paikkamerkit tekstissä pelaajalle |
| Jäsentää relaatiopaikkamerkit kahdelle pelaajalle |
| Näyttää aktiiviset laajennukset |
| Tiedot tietystä laajennuksesta |
| Lataa laajennuksen pilvestä |
| Luettelo laajennuksen paikkamerkeistä |
| Lataa lisäosan ja konfiguraation uudelleen |
| Asennetun lisäosan versio |
Asetukset
Tiedostossa config.yml vain muutama parametri on hyödyllinen muokattavaksi:
Parametri | Mitä se tekee |
| Yhteys eCloudiin. |
| Paikkamerkkien totuusarvojen teksti; voidaan vaihtaa esimerkiksi muotoon kyllä / ei |
| Päivämäärän ja kellonajan muoto vastaaville paikkamerkeille |
| Tarkistaa lisäosan päivitykset käynnistyksessä ja ilmoittaa operaattoreille |
Muut tiedoston arvot ovat sisäisiä (laajennusten suojaus, korvaustila Adventure-komponenteissa, virheenjäljitys), eikä niihin oletuksena kosketa.
Yhteenveto
PlaceholderAPI tarjoaa yhtenäisen tavan korvata tietoja, jonka sadat lisäosat ymmärtävät: sen sijaan, että jokaiseen lisäosaan tehtäisiin oma integraatio, riittää yksi paikkamerkkirivi. Sitä tarvitsevat Minecraft-palvelimien ylläpitäjät, joilla on chat, tab-lista, scoreboard tai valikko dynaamisen datan varassa; yksinpelissä sillä ei ole käyttöä.
Asennus
Tyypillinen asennus vie noin 5 minuuttia. Kulku on sama; vain Loader ja sopiva build vaihtuvat.
- 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.
