Hvordan til at opbygge brugerdefinerede mininavne i Hytal: Server Developer 's Guide

< p > Hytales serverside arkitektur gør den enestående velegnet til brugerdefinerede minigames. I modsætning til Minecraft hvor game mode plugins kæmpe mod vanilla sandkassen, Hytales plugin API og ECS giver dig direkte kontrol over enhedens adfærd, verdensstaten, og spilstrømmen. Hvis du har bygget Bukkit minigames, de begreber oversætte - men gennemførelsen er renere. < / p > < p > Denne vejledning dækker de centrale systemer hver minigame behov: spil state management, arena tilfælde, spiller tracking, scoring, matchmaking, og implementering. < / p > < h2 > Arkitektur: Hvordan Minigame Plugins virker i Hytale < / h2 > < p > Før dykning til kode, forstå den høje niveau arkitektur af en Hytale minigame: < / p > < tabel > < tead > < st > < th > Layer < / th > < th > Formål < / th > < th > Gennemførelse < / th > < / st > < / thead > < tbody > < tr > < td > < stærk > Spilhåndtering < / stærk > < / td > < td > Orkestrater alt - skaber arenaer, administrerer lobbyer, rutespillere < / td > < td > Singleton service i dit plugin < / td > < / tr > < tr > < td > < stærk > Arena instance < / stærk > < / td > < td > Et kørende spil session med sin egen stat, spillere, og verden region < / td > < td > Klasse styre en verden eller region < / td > < / tr > < tr > < td > < stærk > Game State Machine < / strong > < / td > Styrer fasestrømmen - venter, nedtælling, spiller, slutter < / td > < td > Enum + timer logik per arena < / td > < / tr > < tr > < td > < stærk > Player Data < / stærk > < / td > < td > Spor per-player tilstand - score, team, levende / død, statistik < / td > < td > ECS Komponenter knyttet til spillerenheder < / td > < / tr > < tr > < td > < stærk > Event Handlere < / stærk > < / td > < td > Reagerer på spillerhandlinger - dræber, blokerer pauser, zoneindgang < / td > < td > EventBus + ECS event systemer < / td > < / tr > < / tbody > < / tabel > < h2 > Trin 1: Spil State Machine < / h2 > < p > Alle minigamer har brug for en statsmaskine. Dette er rygraden, der styrer, hvad der sker, og hvornår. < / p > < pre > < kode > offentlig enum GameState [ Waiging, / / Lobby, venter på spillere STARTING, / / Nedtælling før spillet begynder Afspilning, / / Aktivt spil DEATHMATCH, / / Valgfrit: sidste showdown fase ENDING / / Spil slut, viser resultater } < / kode > < / pre > < p > Hver arena instans har sin egen < kode > GameState < / kode >. Overgange sker på grundlag af betingelser: < / p > < ul > < li > < stærk > Waiting → STARTING: < / stærk > Mindste antal spillere nået < / li > < li > < stærk > STARTING → Spil: < / stærk > Nedtællingsuret udløber < / li > < li > < stærk > Playing → DEATHMATCH: < / stærk > Tidsgrænse eller spillertærskel < / li > < li > < stærk > Playing / DEATHMATCH → ENDING: < / stærk > Vind tilstand opfyldt (sidste spiller i live, score nået, osv.) < / li > < li > < stærk > ENDING → Waiting: < / stærk > Resultater vises, arena reset < / li > < / ul > < pre > < kode > public class Arena [ Private GameState State = GameState. WAITING; private endelige liste & lt; PlayerRef & gt; afspillere = nye ArrayList & lt; & gt; (); private int nedtælling = 10; offentlig tomrum tick () [ switch (state) { case waiting - > { hvis (players.size () > = MIN _ PLAYERS) { state = GameState. STARTING nedtælling = 10 } } case STARTING - > { countdown --; countdown (countdown); hvis (nedtælling < = 0) { state = GameState. Afspilning startGame (); } } case playing - > { checkWincondition () } tilfælde ENDING - > { displayResults () genbosætning Arena () state = GameState. WAITING; } } } } < / kode > < / pre > < h2 > Trin 2: Spillerdata med ECS-komponenter < / h2 > < p > Brug Hytales enhedskomponentsystem til at vedhæfte spilspecifikke data til spillerenheder. Dette er renere end at vedligeholde ekstern < kode > HashMap & lt; UUID, PlayerData & gt; < / code > kort - dataene lever på enheden selv. < / p > < pre > < kode > public class Minigame Spiller implementerer Komponent & lt; EntityStore & gt; { offentlig streng arena Id = ""; public String team = ""; offentlig int kill = 0 offentlige dødsfald = 0 public int score = 0 offentlig boolesk levende = true; public long last Død = 0; @ Override public MinigamePlayer clon () { Minigam Spillerkopi = ny MinigamePlayer (); copy.arena Id = denne.arenaId; Modtaget. hold = denne .team; copy.kills = this.kills; antallet af dødsfald = dette. copy.score = this.score; copy.live = denne. live; copy.lastDeath = this. last Død Retureksemplar } } < / kode > < / pre > < p > Vedhæft denne komponent, når en spiller slutter sig til en arena, læse det under gameplay for scoring og team logik, og fjerne det, når de forlader. < / p > < h2 > Trin 3: Begivenhedshåndtering for spil Logic < / h2 > < p > Minigames skal reagere på spillerhandlinger. Brug det relevante begivenhedssystem for hver type: < / p > < h3 > Begivenhed Busbegivenheder (Global) < / h3 > < pre > < kode > / / Spilleren slutter sig til serveren - vis dem lobbyen getEventRegistry () .registerGlobal ( PlayerReadyEvent.class event - > teleportToLobby (event.getPlayer ()) ); / / Spilleren afbryder - fjern fra arena getEventRegistry () .registerGlobal ( PlayerDisconnectEvent.class event - > handlePlayerLeave (event.getPlayer ()) ); / / Chat- kommandoer - / join, / leave, / tilskuer getEventRegistry () .registerAsyncGlobal ( PlayerChatEvent.class future - > future.thenAccept (event - > { String msg = event.getMessage (); hvis (msg.startsWith ("/ join") [ event.setCancelled (true) styringJoinCommand (event.getSender ()) } }) ); < / kode > < / pre > < h3 > ECS Hændelser (hele - Specifik) < / h3 > < p > For blokbrud, skader og andre entity- niveau handlinger, oprette < kode > EntityEventSystem < / kode > underklasser: < / p > < pre > < kode > / / Spordrab for scoring public class KillTracker er RefChangeSystem & lt; EntityStore, DeathComponent & gt; { @ Override public void onComponent Tilføjet (EntityButik, Ref entity DeathComponent death) ( / / Enheden døde - find morderen, opdater resultater Ref killer = death.getKiller (); hvis (dræber! = null) { Minigam SpillerkillerData = getComponent ( dræber, MinigamePlayer.class); if (killerData! = null) { morder Data.kills + + morder Data.score + = KILL _ POINTS; } } } } < / kode > < / pre > < p > < stærk > Husk: < / stærk > ECS-hændelser skal annulleres i < stærk > filter < / stærk > fase, ikke inspicerings fase. Hvis du ønsker at forhindre blokbrud i lobby-fasen, skal filteret kontrollere spiltilstanden og annullere før handlingen udføres. < / p > < h2 > Trin 4: Arena Management < / h2 > < p > For spil, der har brug for isolerede legepladser (Hunger Games, Bed Wars), du har brug for arena tilfælde: < / p > < h3 > Multi- Arena Mønster < / h3 > < pre > < kode > public class ArenaManager [ private finale map & lt; String, Arena & gt; arenas = new HashMap & lt; & gt; (); public Arena createArena (String id, Beliggenhed) [ Arena arena = ny Arena (id, center); Arenas.put (id, arena) returarena } public Arena findAvailableArena () [ returarenas.values () .stream () .filter (a - > a.getState () = = GameState. WAITING) .filter (a - > a.getPlayerCount () < a.getMaxPlayers ()) .findFirst () .orElse (null) } public void tickAll () { arenas.values () .forEach (Arena:: tick); } } < / kode > < / pre > < h3 > Arena Nulstil < / h3 > < p > Efter hvert spil, arenaen skal vende tilbage til sin oprindelige tilstand. To tilgange: < / p > < ul > < li > < stærk > Snapshot gendannelse: < / stærk > Gem arenaen regionens blok data, før spillet starter, gendanne det efter. Bruger mere hukommelse, men er pålidelig. < / li > < li > < stærk > Prefab genbelastning: < / stærk > Brug Hytales bygning i Prefab System til at gemme arenaen som en prefab struktur og genplacere den efter hvert spil. Renere og integrere med Hytales indfødte værktøjer. < / li > < / ul > < h2 > Trin 5: Team og Scoring < / h2 > < h3 > Holdets fordeling < / h3 > < pre > < kode > tildeling af offentligt tomrum Team (Arena arena) [ Liste & lt; PlayerRef & gt; afspillere = arena.getPlayers (); Collections.shuffle (spillere); String [] teams = {"Rød", "Blå", "Grøn", "Gul"}; for (int i = 0; i < players.size (); i + +) { Minigam Spillerdata = getComponent ( players.get (i), MinigamePlayer.class) data.team = teams [i% teams.long] } } < / kode > < / pre > < h3 > resultattavle display < / h3 > < p > Brug Hytales < kode > Besked < / Code > klasse for formateret score viser. Beskedsystemet understøtter farve formatering, fed / kursiv stilarter, og parameter substitution: < / p > < pre > < kode > public void broadcast Scorer (Arena arena) { StringBuilder sb = ny StringBuilder ("§ 6 = = = = Resultattavle = = =\ n"); arena.getPlayers () .stream () .sorteret ((a, b) - > getScore (b) - getScore (a)) . for Each (p - > { Minigam Spillerdata = getComponent ( p, MinigamePlayer.class) sb.append (String.format ("§ f% s: § e% d kills § 7 · 124; § a% d pts\ n", p.getUsername (), data.kills, data.score)) }); Arena.broadcast (sb.toString ()); } < / kode > < / pre > < h2 > Trin 6: Win Betingelser < / h2 > < p > Almindelige minigame vinderbetingelser og hvordan du gennemfører dem: < / p > < tabel > < tead > < st > < th > Spiltype < / th > < th > Vind tilstand < / th > < th > Check In < / th > < / st > < / thead > < tbody > < tr > < td > Last Man Standing < / td > < td > 1 spiller / hold i live < / td > < td > Døds håndterende - tæller levende spillere < / td > < / tr > < tr > < td > Score Target < / td > < td > Første til X point < / td > < td > Score opdatering - kontroltærskel < / td > < / tr > < st > < td > Tidsgrænse < / td > < td > Højeste score når tiden udløber < / td > < td > Spil kryds - tjek timer < / td > < / tr > < tr > < td > Mål < / td > < td > Komplet specifik opgave (optag flag, ødelægge seng) < / td > < td > Brugerdefineret ECS begivenhed for objektiv interaktion < / td > < / tr > < st > < td > Round < / td > < td > Bedste af N runder < / td > < td > Rund end handler - tjek serie score < / td > < / st > < / tbody > < / tabel > < h2 > Trin 7: Matchmaking og køer < / h2 > < p > For servere, der kører flere samtidige spil, skal du implementere et køsystem: < / p > < pre > < kode > offentlig klasse Matchmaking Kø { private finale kø & lt; PlayerRef & gt; kø = ny LinkedList & lt; & gt; (); kræves privat final int spillere public void addPlayer (PlayerRef-afspiller) { queue.add (spiller); checkkø () } private void checkQueue () { hvis (queue.size () > = kravsspillere) [ Arena arena = arenaManager.findAalisableArena () hvis (arena! = null) { for (int i = 0; i < påkrævet Spillere; i +) { PlayerRef player = queue.poll (); Arena.addPlayer (spiller) } } } } } < / kode > < / pre > < p > Hytales build- in < strong > Party System < / strong > lader spillerne gruppere og holde sammen på tværs af serveroverførsler. Din matchmaking bør respektere partigrupper - kø partimedlemmer sammen og placere dem på samme hold, når det er muligt. < / p > < h2 > Eksisterende Minigame Mods to Study < / h2 > < p > Byg ikke fra bunden - læs hvad der allerede er på CurseForge: < / p > < tabel > < tead > < st > < th > Mod < / th > < th > Type < / th > < th > Nøglefunktioner at studere < / th > < / tr > < / thead > < tbody > < tr > < td > < stærk > Hunger Games < / stærk > < / td > < td > Last Man Standing < / td > < td > Multiarena management, lobby system, nedtælling, PvP faser, automatisk reset < / td > < / tr > < st > < td > < stærk > BossArena < / stærk > < / td > < td > PvE Arena < / td > < td > NPC kontraktbutikker, per- player løsne kister, konfigurerbare chefer < / td > < / tr > < st > < td > < stærk > Wave Combat Arenas < / strong > < / td > < td > Horde Mode < / td > < td > Wave gydning, besvær med skalering, belønningssystemer < / td > < / tr > < tr > < td > < stærk > Skyblock < / stærk > < / td > < td > Island Survival < / td > < td > Per- player verden tilfælde, progression tracking, boss møder < / td > < / tr > < / tbody > < / tabel > < p > The Hunger Games mod er særligt værd at studere - det viser fuld livscyklus af en konkurrencedygtig minigame: lobby → nedtælling → PvP → deathmatch → resultater → reset. < / p > < h2 > Bygge- i Platform Funktioner for Minigame servere < / h2 > < p > Hytale giver flere funktioner ud af boksen, som Minecraft servere har brug for plugins til: < / p > < ul > < li > < stærk > Discovery Katalog: < / stærk > Bygget i hovedmenuen - spillerne kan finde din minigame server uden ekstern liste sites < / li > < li > < stærk > Party System: < / stærk > Native ven gruppering, der fortsætter på tværs af server overførsler < / li > < li > < stærk > Betalingsgateway: < / stærk > Bygget ind i klienten for servere, der ønsker at monetize kosmetik eller frynsegoder < / li > < li > < stærk > Ramme for tilladelser: < / stærk > Bruger- niveau, gruppebaseret, og wildcard tilladelse matchende < / li > < / ul > < h2 > Implementeringscheckliste < / h2 > < ol > < li > < stærk > Byg din JAR: < / stærk > < kode >. / gradelew build < / kode > < / li > < li > < stærk > Test lokalt: < / stærk > Drop ind < kode >% AppData% / Roaming / Hytale / BrugerData / Mods / < / code > < / li > < li > < stærk > Test med flere klienter: < / stærk > Opdatering 4 tillader flere Hytale tilfælde på en PC - test multiplayer scenarier lokalt < / li > < li > < stærk > Imploy til server: < / stærk > Upload JAR til < kode > / opt / hytale / Server / mods / < / code > < / li > < li > < stærk > Udgiv på CurseForge: < / stærk > Pakke som en Plugin med korrekt < kode > manifest.json < / kode > < / li > < li > < stærk > List din server: < / stærk > Tilføj det til < en HREF = "/" > HytaleCharts < / a > med "Minigames" tag, så spillerne kan finde dig < / li > < / ol > < p > For de grundlæggende plugin API begreber denne guide bygger på, læse vores < a Horif = "/ news / hytale- moding- api- server- plugin- udvikling- guide" > Modding API Guide < / a >. Og for no- kode indhold skabelse, der supplerer dine plugins, tjek vores < a HREF = "/ news / hytale- visual- scripting- guide- no- code - modding" > Visuel skriftvejledning < / a >. < / p > < p > < em > Opbygning af en minigam- server? Del det på vores Discord - vi har community kreations regelmæssigt. < / em > < / p >