Перейти к содержимому
Начало работы

Ваш первый проект

Пошаговый разбор реального первого проекта, плагина домов для 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