Miten tehdä Minecraft-GUI-valikkoplugin

Vaihe vaiheelta

1. 1.Luonnostele valikko

   Arkkuvalikossa on 1-6 riviä, joissa kussakin 9 paikkaa (9-54). Kirjoita, mikä esine menee mihinkin paikkaan, mitä kukin klikkaus tekee ja mitkä paikat ovat pelkkää koristetta, kuten lasilevyjä.

2. 2.Luo inventaario holderilla

   Avaa se kutsulla Bukkit.createInventory(holder, size, title) käyttäen omaa InventoryHolder-luokkaasi. Holderin avulla plugin tietää, että klikkaus tapahtui sen valikossa eikä tavallisessa arkussa.

3. 3.Käsittele klikkaukset

   Tarkista InventoryClickEvent-tapahtumassa holder, peruuta tapahtuma ja suorita sitten kyseisen paikan toiminto. Sulje tai päivitä valikko toiminnon jälkeen.

4. 4.Estä kaikki muut tavat siirtää esineitä

   Peruuta myös InventoryDragEvent ja käsittele shift-klikkaukset, numeronäppäimet ja klikkaukset pelaajan omassa inventaariossa valikon ollessa auki.

5. 5.Lisää sivuja, jos lista on pitkä

   Jos warpit tai kaupan esineet eivät mahdu, varaa alin rivi edellinen-, seuraava- ja sulje-painikkeille.

6. 6.Avaa se komennolla

   Esimerkiksi /warps, tai esineestä tai NPC:stä. Anna komennolle oikeus, jos valikko ei ole kaikille.

7. 7.Kokoa ja klikkaa se läpi

   Anna Codexen kääntää plugin, liity testipalvelimelle ja klikkaa jokaista painiketta. Myös testipelaajat voivat avata valikon ja klikata paikkoja puolestasi.

Säännöt, jotka pitävät valikon turvallisena

• Tunnista valikko sen holderista, älä koskaan otsikosta: kuka tahansa voi kopioida otsikon uudelleennimetyllä arkulla.
• Peruuta klikkaus ennen kuin teet mitään muuta, jotta toiminnon virhe ei koskaan jätä esinettä pelaajan kursoriin.
• Peruuta raahaukset ja shift-klikkaukset pelaajan inventaariosta, tai esineitä voidaan työntää valikkoon.
• Älä luota paikassa olevaan esineeseen: hae toiminto paikan numeron tai esineen tunnisteen perusteella.
• Suorita hidas työ (tietokantalukut, verkkopyynnöt) pääsäikeen ulkopuolella ja päivitä valikko, kun se on valmis.

Valikot asetustiedostosta

Palvelinten omistajat haluavat muuttaa valikoita ilman uutta koontia. Pyydä, että jokainen valikko määritellään asetustiedostossa koon ja otsikon kanssa sekä painikekohtaisesti paikka, materiaali, nimi, kuvaus ja toiminto:

Esimerkkikuvaus

"Paper 1.21.4 -plugin nimeltä WarpMenu. /warps avaa 6-rivisen valikon, jossa on yksi painike warppia kohti, 45 sivulla, ja alimmalla rivillä edellinen-, seuraava- ja sulje-painikkeet. Ylläpitäjät lisäävät warppeja komennolla /setwarp <name> <material> ja poistavat niitä komennolla /delwarp. Warpin klikkaus teleporttaa 3 sekunnin valmistelun jälkeen, joka peruuntuu liikkuessa. Pelaajat eivät voi ottaa tai siirtää yhtään esinettä valikossa. Warpit tallennetaan warps.yml-tiedostoon, valikon otsikko, painikkeiden nimet ja viestit config.yml-tiedostoon."

Valikoiden testaus testipelaajilla

Codexen testipelaajat voivat avata valikon ja klikata paikkaa ja tarkistaa sitten, että valikko aukesi, viesti ilmestyi tai esine annettiin. Lisää testi omin sanoin, esimerkiksi "tavallinen pelaaja ajaa /warps, klikkaa paikkaa 0 ja näkee teleporttiviestin", niin se ajetaan uudelleen aina, kun Codexe toimittaa muutoksen.

Kysymykset