ZNPCs: lisäosa NPC-hahmojen luomiseen Minecraftissa
Riippuvuudet: Palvelintyyppi: Paper tai Spigot 1.8.8–1.21.4 Minecraft-versio: 1.8.8–1.21.4 Riippuvat lisäosat: PlaceholderAPI (valinnainen…
Riippuvuudet: Palvelintyyppi: Paper tai Spigot 1.8.8–1.21.4 Minecraft-versio: 1.8.8–1.21.4 Riippuvat lisäosat: PlaceholderAPI (valinnainen, hologrammien muuttujia varten) Lataa: SpigotMC / GitHub Jos tarvitset yksinkert
Riippuvuudet:
Palvelintyyppi: Paper tai Spigot 1.8.8–1.21.4
Minecraft-versio: 1.8.8–1.21.4
Riippuvat lisäosat: PlaceholderAPI (valinnainen, hologrammien muuttujia varten)
Lataa: SpigotMC / GitHub
Jos tarvitset yksinkertaisia NPC-hahmoja aulaan tai koristeeksi, Citizens voi osoittautua liian raskaaksi. ZNPCs ratkaisee saman tehtävän yksinkertaisemmin: se on yksi .jar-tiedosto ilman kasaa riippuvuuksia, jonka avulla voit asettaa hahmoja omalla skinillä, tekstillä ja klikkausreaktiolla.
Tärkeimmät ominaisuudet
Kaikilla NPC-hahmoilla on yksilöllinen numeerinen ID. Voit luoda tavallisen pelaajan, jolla on skin nimimerkin tai URL-osoitteen perusteella, tai asettaa mobin, kuten ZOMBIEN tai LUURANGON.
Kun pelaaja klikkaa NPC:tä, lisäosa suorittaa määritetyt toiminnot. Se voi olla viesti, komento pelaajan tai konsolin nimissä, tai jopa pelaajan lähettäminen toiselle palvelimelle BungeeCordin kautta. Jos toimintoja on useita, ne suoritetaan vuorotellen. Voit myös määrittää jokaiselle toiminnolle cooldownin (viiveen).
Teksti pään yläpuolella (Lines)
NPC:n yläpuolelle voi lisätä tekstiä komennolla lines. Lisäosa tukee värikoodeja, ja jos PlaceholderAPI on asennettuna, myös muuttujia kuten %player_name% tai %server_online%. Voit myös muuttaa tekstin korkeutta komennolla height.
Reitit (Paths)
NPC:n ei ole pakko seistä paikallaan. Opettaaksesi sen kävelemään sinun on kytkettävä päälle tallennustila (/znpcs path create <nimi>) ja kuljettava haluttu reitti itse. Lopuksi sinun on kirjoitettava /znpcs path exit. Tämän jälkeen reitti määritetään tietylle NPC:lle (/znpcs path set <id> <nimi>), ja se alkaa kulkea sitä loputtomasti.
Tärkeä huomio: liike on hyvin yksinkertainen. ZNPCs ei käytä vanilla-reitinhakua (Pathfinder), joten hahmot eivät kierrä esteitä eivätkä reagoi muihin pelaajiin.
Varusteet ja ulkonäkö
Hahmot voi pukea haarniskaan ja antaa niille esineitä käsiin. Riittää, että otat halutun esineen ja kirjoitat /znpcs equip <id> <paikka> (käytettävissä olevat paikat: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
NPC:n käyttäytymistä voi myös säätää komennolla toggle: saada se katsomaan lähimpiä pelaajia (look), peilaamaan sitä katsovan pelaajan skiniä (mirror) tai lisäämään hehkun (glow) valitulla värillä.
Komennot
Nämä komennot edellyttävät ylläpitäjän oikeuksia (znpcs.admin).
Komento | Kuvaus | Oikeus |
| Luo NPC:n koordinaatteihisi | znpcs.admin |
| Poistaa NPC:n | znpcs.admin |
| Näyttää luettelon NPC:istä ja niiden ID:istä | znpcs.admin |
| Teleporttaa NPC:n luoksesi | znpcs.admin |
| Teleporttaa sinut NPC:n luo | znpcs.admin |
| Vaihtaa olemassa olevan NPC:n tyypin | znpcs.admin |
| Vaihtaa hahmon skinin | znpcs.admin |
| Antaa NPC:lle kädessäsi olevan esineen | znpcs.admin |
| Muuttaa NPC:n yläpuolella olevaa tekstiä | znpcs.admin |
| Muuttaa tekstin korkeutta (oletus 1) | znpcs.admin |
| Lisää toiminnon klikkaukseen | znpcs.admin |
| Näyttää NPC:n toimintojen luettelon (niiden ID:ineen) | znpcs.admin |
| Poistaa toiminnon sen ID:n perusteella | znpcs.admin |
| Asettaa viiveen toiminnon suorittamiselle | znpcs.admin |
| Tallentaa uuden reitin | znpcs.admin |
| Poistuu reitin tallennustilasta | znpcs.admin |
| Määrittää reitin NPC:lle | znpcs.admin |
| Kytkee asetuksia päälle/pois (look, holo, mirror) | znpcs.admin |
| Lisää valitun värisen hehkuefektin | znpcs.admin |
Toimintotyypit komennolle action add:
CMD (suorittaa komennon pelaajan nimissä)
CONSOLE (suorittaa komennon konsolista)
CHAT (pelaaja kirjoittaa viestin chattiin)
MESSAGE (lähettää viestin pelaajalle)
SERVER (siirtää toiselle palvelimelle BungeeCordin kautta)
Käyttöoikeudet
Tässä kaikki on mahdollisimman yksinkertaista. Lähes kaikkeen tarvitaan vain yksi node:
Node | Mitä antaa |
znpcs.admin | Täysi käyttöoikeus kaikkiin komentoihin |
Asetukset
config.json
Parametri | Arvo | Kuvaus |
| 500 | Suurin määrä pisteitä (askelia), jotka voidaan tallentaa yhdelle NPC-reitille. Jos reitti on liian pitkä, tallennus pysähtyy automaattisesti, kun tämä raja saavutetaan. |
| "DEFAULT" | NPC:iden sisäisten nimien generointialgoritmi. Oletusarvo varmistaa ID:n oikean sidonnan. |
| TRUE | Kohdistaa NPC:n automaattisesti tarkalleen lohkon keskelle sitä luotaessa. Estää mallin siirtymisen lohkon reunalle. |
| "-" | Merkki, jota lisäosa käyttää korvaamaan välilyönnit komentojen tekstissä tai tunnisteita generoitaessa. |
| 600 | Luotujen hahmojen automaattisen tallennuksen aikaväli tiedostoon npcs.json (600 sekuntia = 10 minuuttia). Suojaa tietojen menetykseltä palvelimen äkillisen kaatumisen yhteydessä. |
| TRUE | Vianetsintätilan aktivointi. Lisäosa alkaa tulostaa yksityiskohtaista teknistä tietoa ja virhelokeja palvelimen konsoliin. Vakaalla palvelimella on suositeltavaa kytkeä se pois (false) konsolin selkeyden vuoksi. |
| 0.3 | Etäisyys NPC:n pään yläpuolella olevan hologrammin (tekstin) rivien välillä. Pienempi arvo tekee tekstistä tiiviimmän. |
| 32 | Säde (lohkoina), jonka sisällä palvelin alkaa lähettää pelaajalle paketteja NPC:n mallin renderöimiseksi. Arvon pienentäminen säästää palvelimen ja asiakkaan resursseja. |
| FALSE | Tuki hologrammitekstin dynaamiselle värinvaihdolle (RGB-liukuvärille). Käyttöönotto voi aiheuttaa lisäkuormaa asiakkaalle. |
npcs.json
Kaikki luodut NPC:t kirjataan tiedostoon npcs.json. Lisäosa generoi sen automaattisesti, joten sitä on parempi olla muokkaamatta käsin. Ainoa peruste mennä tähän tiedostoon on, kun sinun täytyy siirtää määritetyt NPC:t toiselle palvelimelle.
conversations.json
Kaikki dialogit tallennetaan tänne.
paths
Kansio, johon kaikki tallennetut reitit tallennetaan.
data.json
Tänne tallennetaan kaikki yksityiskohtaiset tiedot luoduista NPC:istä.
Integraatiot
Jos palvelimelle on asennettu PlaceholderAPI, ZNPCs tunnistaa sen automaattisesti ilman erityisiä laajennuksia. Tämä on hyödyllistä esimerkiksi silloin, kun haluat näyttää NPC:n yläpuolella dynaamisen online-laskurin.
Yhteensopivuus
Alkuperäinen ZNPCs toimii kunnolla vain versioon 1.21.1 asti. Uudemmille palvelimille (1.21.1 ja uudemmat) on asennettava forkki ZNPC Plus.
Lisäosa ei myöskään käynnisty Folialla sen entiteettien käsittelyn erityispiirteiden vuoksi.
Milloin ZNPCs kannattaa ottaa käyttöön
Jos sinun täytyy asettaa spawniin NPC, joka vain avaa valikon, jakaa aloituspaketin tai ohjaa pelaajat muille minipelipalvelimille, ZNPCs on erinomainen valinta. Se tekee juuri sen, mitä lupaa, eikä kuormita palvelinta tarpeettomalla toiminnallisuudella.
Mutta jos aiot tehdä haarautuvia dialogeja tai monimutkaisia tehtäviä, tarvitset Citizens + Denizen -ekosysteemin. ZNPCs ei ole tarkoitettu siihen.
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.








