Přeskočit na obsah
Začínáme

Tvůj první projekt

Krok za krokem skutečným prvním projektem, pluginem pro domovy na Paperu, od zadání až po otestovaný JAR.

Aktualizováno

Na této stránce
  1. Zadání
  2. Co se stane potom
  3. Prohlédni si výsledek
  4. Něco změň
  5. Sestav a otestuj ho
  6. Co dál

V tomto průvodci vytvoříme malý, ale skutečný plugin, takže každou fázi uvidíš jednou na vlastní oči. Stejný postup platí pro všechny typy projektů.

#Zadání

Na stránce Vytvořit vyber Plugin pro Bukkit/Spigot/Paper (Java) a napiš:

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

Všimni si, co v něm je: platforma a verze, každý příkaz a co dělá, časová pravidla, ukládání dat, oprávnění a co má být nastavitelné. Právě díky tomu je první výsledek použitelný.

#Co se stane potom

  1. Codexe postupně vypisuje soubory: Maven pom.xml, hlavní třídu, třídy příkazů a listenerů, plugin.yml a config.yml.
  2. Banner se přepne na Kontroluji projekt… a potom na Sestavuji…. Codexe plugin zkompiluje.
  3. Pokud kompilátor nahlásí chybu (například špatný import), uvidíš Opravuji problém…. Codexe kód opraví a sestaví ho znovu. Tohle nespotřebuje tvoje tokeny.
  4. Projekt přejde do stavu Hotovo.

#Prohlédni si výsledek

  • Otevři plugin.yml a zkontroluj, že příkazy a oprávnění odpovídají tomu, o co jsi žádal/a.
  • Otevři config.yml: měl by tam být cooldown i zprávy.
  • Projdi hlavní třídu. Nemusíš rozumět každému řádku, ale zjevné mezery si všimneš.

#Něco změň

Do chatu projektu napiš:

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe upraví existující soubory, místo aby začínal od nuly. Navazující zprávy stojí mnohem méně než nový projekt, protože se přepisují jen dotčené soubory. Když se změna týká projektu, který se dá sestavit, Codexe ho znovu ověří.

#Sestav a otestuj ho

Stiskni Zkompilovat, aby proběhlo nové sestavení, a potom Stáhnout JAR. Vlož JAR do složky plugins/ na svém serveru a restartuj ho. Otestuj každý příkaz včetně okrajových případů (pohyb během odpočtu, cooldown, restart).

#Co dál

Tvůj první projekt | Codexe Docs