Przejdź do treści
Pierwsze kroki

Twój pierwszy projekt

Omówienie prawdziwego pierwszego projektu, pluginu Paper z domami, od prośby do przetestowanego JAR-a.

Zaktualizowano

Na tej stronie
  1. Prośba
  2. Co dzieje się dalej
  3. Obejrzyj wynik
  4. Zmień coś
  5. Zbuduj i przetestuj
  6. Dalej

W tym omówieniu budujemy mały, ale prawdziwy plugin, żeby każdy etap pokazać choć raz. Ten sam proces dotyczy każdego typu projektu.

#Prośba

W sekcji Utwórz wybierz Plugin Bukkit/Spigot/Paper (Java) i napisz:

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.

Zwróć uwagę, co zawiera: platformę i wersję, każdą komendę i to, co robi, zasady czasowe, zapis danych, uprawnienia oraz to, co ma być konfigurowalne. Właśnie dzięki temu pierwszy wynik nadaje się do użytku.

#Co dzieje się dalej

  1. Codexe na bieżąco wypisuje pliki: pom.xml dla Mavena, klasę główną, klasy komend i listenerów, plugin.yml oraz config.yml.
  2. Baner zmienia się na Sprawdzam projekt…, a potem na Budowanie…. Codexe kompiluje plugin.
  3. Jeśli kompilator zgłosi błąd (na przykład zły import), zobaczysz Naprawiam problem…. Codexe naprawia kod i buduje ponownie. Nie zużywa to twoich tokenów.
  4. Projekt otrzymuje status Gotowe.

#Obejrzyj wynik

  • Otwórz plugin.yml i sprawdź, czy komendy i uprawnienia zgadzają się z tym, o co prosisz.
  • Otwórz config.yml: powinny tam być cooldown i wiadomości.
  • Przejrzyj klasę główną. Nie musisz rozumieć każdej linijki, ale możesz wychwycić oczywiste braki.

#Zmień coś

Na czacie projektu wpisz:

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

Codexe edytuje istniejące pliki, zamiast zaczynać od nowa. Kolejne zmiany kosztują dużo mniej niż nowy projekt, bo przepisywane są tylko pliki, których zmiana dotyczy. Gdy zmiana dotyczy projektu, który da się zbudować, Codexe weryfikuje go ponownie.

#Zbuduj i przetestuj

Naciśnij Skompiluj, żeby wykonać świeży build, a potem Pobierz JAR. Wrzuć JAR do folderu plugins/ swojego serwera i uruchom go ponownie. Przetestuj każdą komendę, łącznie z przypadkami brzegowymi (ruch w trakcie odliczania, cooldown, restart).

#Dalej

Twój pierwszy projekt | Codexe Docs