Príručka

Ako vytvoriť plugin s minihrou pre Minecraft

Aktualizované 18. októbra 2026

Plugin s minihrou riadi kolá: hráči čakajú v lobby, spustí sa odpočítavanie, hra beží podľa svojich pravidiel, niekto vyhrá a aréna sa obnoví na ďalšie kolo. Každá minihra, od spleefu po bed wars, má rovnakú kostru. Keď ju spravíš dobre, pravidlá hry sú tá jednoduchšia časť.

Začni od tohto príkladu a uprav pravidlá.

Vygeneruj to v Codexe

Krok za krokom

  1. 1.Napíš pravidlá jedného kola

    Koľko hráčov, ako sa kolo začína a končí, ako sa vyhráva, čo sa stane pri smrti (vypadnutie, respawn, divák) a čo hráči dostanú na začiatku.

  2. 2.Naplánuj nastavenie arény

    Príkazy pre adminov na vytvorenie arény a nastavenie jej lobby, spawnov a hraníc, napríklad /mg create <name> a /mg setspawn <name>. Arény sa ukladajú do súboru, aby prežili reštarty.

  3. 3.Definuj stavy hry

    Čakanie, štart (odpočítavanie), hra a koniec. Každý stav dovoľuje niečo iné: v lobby nikto neničí bloky, do rozbehnutej hry sa nikto nepripojí.

  4. 4.Rozhodni, ako sa aréna obnoví

    Sleduj a vráť bloky zmenené počas kola alebo znovu načítaj kópiu šablónového sveta. Bez obnovy začne druhé kolo na rozbitej mape.

  5. 5.Pridaj to, čo hráči vidia

    Bočný scoreboard so zostávajúcimi hráčmi a časom, boss bar alebo titulky na odpočítavanie a správy v chate pre zabitia a víťaza.

  6. 6.Vygeneruj, zostav a zahraj si kolo

    Opíš ju Codexe, nechaj ju skompilovať a potom sa cez Vyskúšaj teraz pripoj na testovací server. Počas testovania nastav nízky minimálny počet hráčov, aby sa kolo mohlo začať.

Stavy hry

Väčšina chýb v minihrách vzniká tak, že hráči robia niečo v nesprávnom stave. Keď stavy napíšeš do zadania, AI postaví plugin okolo nich.

StavČo sa dejeTypické pravidlá
ČakanieHráči sa pripájajú do lobbyŽiadne poškodenie, žiadne ničenie blokov, odchod predmetom alebo príkazom
Spúšťa saOdpočítavanie po dosiahnutí minimaOdpočítavanie sa zastaví, ak počet hráčov klesne pod minimum
HraPlatia pravidlá hryŽiadne pripájanie, smrť vyraďuje alebo respawnuje, odchod sa počíta ako prehra
KoniecVyhlásenie víťaza, rozdanie odmienHráči sa po pár sekundách vrátia späť, aréna sa obnoví

Obnova arény

  • Zaznamenať a vrátiť zmeny: ulož každý blok skôr, než sa počas kola zmení, a na konci ho vráť späť. Rýchle pre malé arény, kde hráči rozbijú alebo položia iba pár blokov.
  • Šablónový svet: drž čistú kópiu mapy, po kole odpoj odohraný svet a prepíš ho šablónou. Jednoduché a spoľahlivé pre mapy, ktoré sa zničia.
  • Žiadne zmeny: pri hrách ako parkour alebo PvP duely úplne zruš zmeny blokov a nič netreba obnovovať.

Príklad popisu

„Plugin s minihrou spleef pre Paper 1.21.4. Admini vytvárajú arény cez /spleef create <name>, /spleef setlobby a /spleef setfloor (dva rohy snehovej podlahy). Hráči sa pripájajú cez /spleef join <arena>. Kolo sa začne 15 sekúnd po tom, čo sú dnu 2 hráči, najviac 8. Hráči dostanú diamantovú lopatu, sneh ničia okamžite a vypadnú, keď spadnú pod podlahu. Posledný hráč, ktorý zostane, vyhrá 50 mincí cez Vault. Vyradení hráči sa stanú divákmi. Snehová podlaha sa po každom kole obnoví. Bočný panel so zostávajúcimi hráčmi a časom. Arény uložené v arenas.yml, minimálny počet hráčov a odmeny v config.yml.“

Testovanie minihry

Minihru je ťažké posúdiť z kódu: musíš si zahrať kolo. Vyskúšaj teraz spustí súkromný server Paper tvojej verzie s nainštalovaným pluginom, zvyčajne v plochom svete, a kamaráti sa môžu pripojiť, ak ich pridáš do Prístupu na server. Plán Free dovoľuje 2 ľudí na testovacom serveri, Pro 5, Business 10 a Enterprise 20.

Požiadaj o minimálny počet hráčov v config.yml, aby si ho počas testovania mohol nastaviť na 1 alebo 2. Pripojiť sa môžu aj testovací hráči, spustiť príkazy na pripojenie a príkazy pre adminov a skontrolovať správy, takže nefunkčné príkazy odhalíš ešte predtým, než začneš hrať.

Otázky

Jedna aréna, alebo viac?

Požiadaj o viac arén hneď od začiatku. Prerobiť plugin s jednou arénou na plugin s viacerými arénami neskôr znamená prepísať, ako sa ukladajú hráči a stav hry.

Môžem vytvoriť PvP minihru pre 1.8?

Áno. Napíš do zadania Spigot alebo Paper 1.8.8: Codexe napíše kód pre toto staršie API a testovacie servery bežia na verziách od 1.8 po 26.3.

Ako fungujú siete s minihrami?

Veľké siete spúšťajú každú hru na vlastnom serveri za proxy BungeeCord alebo Velocity, s lobby serverom, ktorý posiela hráčov do voľnej hry. To je proxy plugin plus herný plugin, teda dva projekty.

Vytvor svoju minihru

Toto zadanie sa otvorí pripravené na odoslanie:

“Plugin s minihrou spleef pre Paper 1.21.4: arény vytvorené cez /spleef create, setlobby a setfloor, hráči sa pripájajú cez /spleef join, kolo sa začne 15 sekúnd po 2 hráčoch (max. 8), diamantové lopaty, vypadnutie po páde pod podlahu, posledný hráč vyhrá 50 mincí cez Vault, vyradení hráči ako diváci, snehová podlaha obnovená po každom kole, bočný panel so zostávajúcimi hráčmi a časom, arény uložené v arenas.yml.”

Vygeneruj to v Codexe
Ako vytvoriť plugin s minihrou pre Minecraft | Codexe