Sådan laver du et GUI-menuplugin til Minecraft

Trin for trin

1. 1.Skitsér menuen

   En kistemenu har 1 til 6 rækker med 9 slots (9 til 54). Skriv, hvilken genstand der skal i hvilken slot, hvad hvert klik gør, og hvilke slots der bare er pynt, f.eks. glasruder.

2. 2.Opret inventoryet med en holder

   Åbn det med Bukkit.createInventory(holder, size, title) og din egen InventoryHolder-klasse. Det er holderen, der fortæller pluginet, at et klik skete i dets menu og ikke i en almindelig kiste.

3. 3.Håndtér klik

   Tjek holderen i InventoryClickEvent, annullér eventet, og kør så handlingen for den slot. Luk menuen, eller opdatér den efter handlingen.

4. 4.Bloker alle andre måder at flytte genstande på

   Annullér også InventoryDragEvent, og håndtér shift-klik, taltaster og klik i spillerens eget inventory, mens menuen er åben.

5. 5.Tilføj sider, hvis listen er lang

   Til warps eller butiksvarer, der ikke kan være der, reserverer du den nederste række til knapperne forrige, næste og luk.

6. 6.Åbn den fra en kommando

   For eksempel /warps, eller fra en genstand eller en NPC. Giv kommandoen en permission, hvis menuen ikke er for alle.

7. 7.Byg den, og klik dig igennem

   Lad Codexe kompilere pluginet, join testserveren, og klik på hver knap. Testspillere kan også åbne menuen og klikke på slots for dig.

Reglerne, der holder en menu sikker

• Genkend menuen på dens holder, aldrig på titlen: enhver omdøbt kiste kan kopiere en titel.
• Annullér klikket, før du gør noget andet, så en fejl i handlingen aldrig efterlader genstanden i spillerens markør.
• Annullér træk og shift-klik fra spillerens inventory, ellers kan genstande skubbes ind i menuen.
• Stol ikke på genstanden i sloten: slå handlingen op ud fra slotnummeret eller et tag på genstanden.
• Kør langsomt arbejde (databaselæsninger, webforespørgsler) uden for hovedtråden, og opdatér menuen, når det er færdigt.

Menuer fra konfigurationen

Serverejere kan lide at ændre menuer uden et nyt build. Bed om, at hver menu defineres i en konfigurationsfil med størrelse, titel og, pr. knap, slot, materiale, navn, lore og handling:

Eksempel på beskrivelse

"Et Paper 1.21.4-plugin kaldet WarpMenu. /warps åbner en menu med 6 rækker og én knap pr. warp, 45 pr. side, med knapperne forrige, næste og luk i den nederste række. Admins tilføjer warps med /setwarp <name> <material> og fjerner dem med /delwarp. Et klik på et warp teleporterer efter 3 sekunders opvarmning, der annulleres ved bevægelse. Spillerne kan ikke tage eller flytte nogen genstand i menuen. Warps gemmes i warps.yml, menutitel, knapnavne og beskeder i config.yml."

Test af menuer med testspillere

Codexes testspillere kan åbne en menu og klikke på en slot og derefter tjekke, at en menu åbnede, en besked dukkede op, eller en genstand blev givet. Tilføj en test med dine egne ord, f.eks. "en normal spiller kører /warps, klikker på slot 0 og ser teleportbeskeden", så kører den igen, hver gang Codexe leverer en ændring.

Spørgsmål