Перейти до вмісту
Початок роботи

Ваш перший проєкт

Покроковий розбір справжнього першого проєкту, плагіна домівок для Paper, від запиту до протестованого JAR.

Оновлено

На цій сторінці
  1. Запит
  2. Що відбувається далі
  3. Перегляньте результат
  4. Змініть щось
  5. Зберіть і протестуйте
  6. Далі

У цьому розборі ми створимо невеликий, але справжній плагін, щоб ви один раз побачили кожен етап. Той самий процес діє для будь-якого типу проєкту.

#Запит

На сторінці Створити виберіть Плагін Bukkit/Spigot/Paper (Java) і напишіть:

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.

Зверніть увагу, що в ньому є: платформа й версія, кожна команда і що вона робить, правила часу, зберігання, дозволи та що має бути налаштовуваним. Саме це робить перший результат придатним до використання.

#Що відбувається далі

  1. Codexe передає файли потоком: Maven pom.xml, головний клас, класи команд і слухачів, plugin.yml і config.yml.
  2. Банер змінюється на Перевіряємо проєкт…, а потім на Збираємо…. Codexe компілює плагін.
  3. Якщо компілятор повідомляє про помилку (наприклад, неправильний імпорт), ви побачите Виправляємо проблему…. Codexe виправляє код і збирає знову. Це не витрачає ваші токени.
  4. Проєкт отримує статус Готово.

#Перегляньте результат

  • Відкрийте plugin.yml і перевірте, що команди й дозволи відповідають тому, що ви просили.
  • Відкрийте config.yml: там мають бути перезарядка й повідомлення.
  • Перегляньте головний клас. Не обов'язково розуміти кожен рядок, але очевидні прогалини можна помітити.

#Змініть щось

У чаті проєкту напишіть:

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

Codexe редагує наявні файли замість того, щоб починати з нуля. Подальші запити коштують набагато менше, ніж новий проєкт, бо переписуються лише зачеплені файли. Коли зміна стосується проєкту, який можна зібрати, Codexe перевіряє його знову.

#Зберіть і протестуйте

Натисніть Скомпілювати, щоб запустити свіжу збірку, а потім Завантажити JAR. Покладіть JAR у теку plugins/ вашого сервера й перезапустіть його. Протестуйте кожну команду, включно з крайніми випадками (рух під час підготовки, перезарядка, перезапуск).

#Далі

Ваш перший проєкт | Codexe Docs