Annoying API

Annoying API - это не просто очередная библиотека для плагинов Майнкрафт, а настоящая швейцарская армейская пила для разработчиков. По сути, это набор готовых утилит и классов, которые избавляют от написания тонны однотипного кода. Фреймворк он или полноценная библиотека - решать вам, но факт в том, что внутри него спрятано куда больше, чем кажется на первый взгляд.

Для кого это?

• Владельцы серверов - можете выдохнуть. Вам не придётся вручную качать Annoying API и пихать в папку plugins. Все плагины, которые используют эту библиотеку, уже идут с ней в комплекте. Просто кидаете плагин на сервер - и всё работает.
• Разработчики - вот тут самое интересное. Вместо того чтобы изобретать велосипед с квадратными колёсами, вы получаете готовые решения для типовых задач: работа с командами, конфигами, событиями, инвентарями и прочими вещами, которые в ванильном Bukkit/Spigot приходится реализовывать вручную. Это реально экономит часы, особенно если вы делаете не один плагин, а целую серию.

Что внутри?

Сказать, что там "пара утилит" - значит сильно приуменьшить. По факту Annoying API содержит:

• Вспомогательные классы для работы с текстом, числами, списками
• Удобные обёртки для команд и табуляции
• Механизмы для быстрой настройки конфигурации
• Разные хелперы, которые обычно таскают из проекта в проект

И да, это не просто набор методов - всё заточено под реальный серверный опыт. Не нужно городить костыли, когда всё уже придумали до вас.

Как этим пользоваться

Для серверов - никак. Установка не требуется, плагин сам подтянет зависимости.

Для разработчиков - есть два пути:

1. Посмотреть документацию - она лежит на GitHub Wiki. Там расписано, как подключать API к своему проекту и какие возможности доступны.
2. Javadocs - полное описание всех классов и методов доступно онлайн. Удобно, когда нужно быстро подсмотреть сигнатуру метода.

Если хотите собрать Annoying API локально - просто выполните ./gradlew build под Java 11+.

Важно знать

• Annoying API распространяется вместе с плагинами, которые его используют. Отдельно скачивать его не нужно - это частая ошибка новичков. Просто ставьте сам плагин, а API подтянется автоматически.
• Название "Annoying" (раздражающий) - это шутка автора. На деле библиотека наоборот упрощает жизнь. Не ведитесь на название.

Скачать плагины, использующие Annoying API, можно на нашем сайте. Они будут работать сразу, без лишних плясок с бубном.