Ваш первый проект
Пошаговый разбор реального первого проекта, плагина домов для Paper, от запроса до протестированного JAR.
Обновлено
На этой странице
В этом разборе мы создадим небольшой, но настоящий плагин, чтобы вы один раз увидели каждый этап. Этот же процесс подходит для проектов любого типа.
#Запрос
На странице Создать выберите Плагин Bukkit/Spigot/Paper (Java) и напишите:
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.Обратите внимание, что в нём есть: платформа и версия, каждая команда и то, что она делает, правила по времени, хранение данных, права и то, что должно быть настраиваемым. Именно это делает первый результат пригодным к использованию.
#Что происходит дальше
- Codexe по очереди выдаёт файлы: Maven
pom.xml, главный класс, классы команд и слушателей,plugin.ymlиconfig.yml. - Баннер сменяется на Проверка проекта…, а затем на Сборка…. Codexe компилирует плагин.
- Если компилятор сообщает об ошибке (например, неверный импорт), вы увидите Исправление ошибки…. Codexe исправляет код и собирает его снова. Это не расходует ваши токены.
- Проект получает статус Готов.
#Посмотрите на результат
- Откройте
plugin.ymlи убедитесь, что команды и права соответствуют вашему запросу. - Откройте
config.yml: там должны быть кулдаун и сообщения. - Пробегитесь по главному классу. Понимать каждую строку не обязательно, но очевидные пробелы вы заметите.
#Измените что-нибудь
В чате проекта напишите:
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.Codexe правит существующие файлы, а не начинает заново. Доработки стоят гораздо дешевле нового проекта, потому что переписываются только затронутые файлы. Если изменение касается собираемого проекта, Codexe проверяет его снова.
#Соберите и протестируйте
Нажмите Скомпилировать, чтобы запустить свежую сборку, затем Скачать JAR. Положите JAR в папку plugins/ вашего сервера и перезапустите его. Проверьте каждую команду, включая крайние случаи (движение во время отсчёта, кулдаун, перезапуск).