📄
pasted-code-1793116157604.txt
txt
262 lines
▶
# ЗАДАНИЕ: Разработка Minecraft-плагина TectonikClans
Ты — Senior Java Developer, специализирующийся на разработке Minecraft-плагинов для Paper/Spigot 1.16.5.
Создай полностью функциональный клановый плагин **TectonikClans** для сервера TECTONIKMC.
Это должен быть готовый к использованию проект, а не демонстрационный пример.
## 1. Технологии
- Minecraft 1.16.5.
- Paper и Spigot.
- Java 8.
- Maven.
- Главный класс: `ru.tectonikmc.clans.TectonikClans`.
- Главный конфиг: `config.yml`.
- Отдельные файлы для сообщений, кланов и меню.
- Полный исходный код и готовый JAR после успешной сборки.
Не используй API, которые появились после Minecraft 1.16.5.
## 2. Основная система кланов
Игрок создаёт клан командой:
`/clan create <название>`
Примеры:
- `/clan create Tectonik`
- `/clan create Legends`
- `/clan create Warriors`
После создания клан сохраняется в базе данных, а создатель становится лидером.
Обязательно реализуй:
- создание клана;
- удаление клана;
- приглашение игроков;
- принятие и отклонение приглашений;
- выход из клана;
- исключение участников;
- передачу лидерства;
- список участников;
- просмотр информации о клане;
- клановый чат;
- управление ролями;
- настройки клана;
- ограничение максимального количества участников;
- проверку уникальности названий;
- защиту от дублирования и некорректных названий.
Добавь SQLite для хранения данных между перезапусками сервера. Предусмотри возможность перехода на MySQL в будущих версиях.
## 3. Критически важное требование: никаких клановых тегов
**Никогда не показывай название или тег клана рядом с ником игрока.**
Не изменяй:
- TAB;
- nametag;
- scoreboard teams;
- префиксы LuckPerms;
- формат имени игрока над головой;
- список игроков в TAB.
Плагин не должен создавать команды scoreboard teams для оформления ников.
Название клана отображается только в клановом меню, сообщениях и информации о клане.
Например, в обычном чате игрок должен выглядеть так:
`[VIP] Player: Привет!`
А не так:
`[VIP] [TECTONIK] Player: Привет!`
## 4. Красивая клановая GUI-менюшка
Добавь команду:
`/clan`
Она открывает собственное инвентарное меню Minecraft.
Главное меню должно иметь размер 54 слота и красивое оформление в жёлто-зелёном стиле TECTONIKMC.
Используй названия предметов, описания, декоративные панели и удобное расположение кнопок.
Элементы меню:
- Информация о клане.
- Участники.
- Пригласить игрока.
- Управление приглашениями.
- Клановый чат.
- Настройки.
- Передача лидерства.
- Покинуть клан.
- Удалить клан — только для лидера.
- Закрыть меню.
Если игрок ещё не состоит в клане, показывай отдельное меню с кнопками:
- Создать клан.
- Список кланов.
- Принять приглашение.
- Закрыть.
Используй InventoryHolder или другой надёжный способ определения собственных GUI.
Запрещай перемещение предметов меню, их извлечение и использование декоративных предметов.
Обрабатывай клики, перетаскивания, закрытие меню и повторное открытие без ошибок.
## 5. HEX, RGB и цветовая система
Реализуй собственный ColorEngine с поддержкой:
- Legacy-цветов `&0`–`&f`;
- форматирования `&l`, `&o`, `&n`, `&m`, `&k`, `&r`;
- HEX `RRGGBB`;
- RGB через `§x§R§R§G§G§B§B`;
- градиентов от одного HEX-цвета к другому;
- цветных сообщений, заголовков меню и описаний предметов.
Пример градиента:
`FCFF00ᴛD3FF00ᴇA9FF00ᴄPFF00ᴛAFF31ᴏ6FF27ɴEFF1EɪA8FF14ᴋD2FF0AᴍFCFF00ᴄ`
Используй этот градиент для заголовков меню и сообщений плагина.
Весь дизайн должен настраиваться через YAML.
Для версии 1.16.5 используй совместимое преобразование HEX в RGB-последовательности, если это требуется API. Не своди RGB к стандартным 16 цветам.
## 6. Донатные возможности
Добавь поддержку донатных возможностей через права LuckPerms.
Примеры:
- `tectonikclans.clan.create`
- `tectonikclans.clan.delete`
- `tectonikclans.clan.invite`
- `tectonikclans.clan.upgrade`
- `tectonikclans.clan.color`
- `tectonikclans.clan.members.bonus`
Реализуй настраиваемые лимиты:
- обычный игрок: максимум 5 участников;
- VIP: максимум 10;
- VIP+: максимум 15;
- PREMIUM: максимум 20;
- ELITE: максимум 30.
Это пример: все лимиты должны изменяться в конфигурации.
Донатные преимущества не должны отображаться возле ника. Они используются только для проверки разрешений и доступных функций.
Плагин не должен самостоятельно выдавать донатные права или изменять группы LuckPerms.
## 7. Команды
Реализуй:
- `/clan` — открыть GUI;
- `/clan create <название>`;
- `/clan delete`;
- `/clan invite <игрок>`;
- `/clan accept <клан>`;
- `/clan deny <клан>`;
- `/clan leave`;
- `/clan kick <игрок>`;
- `/clan promote <игрок>`;
- `/clan leader <игрок>`;
- `/clan info [клан]`;
- `/clan list`;
- `/clan chat <сообщение>`;
- `/clan reload`.
Добавь Tab Completion.
Проверяй права, существование игроков, состояние клана и допустимость каждого действия.
Для опасных операций, например удаления клана, используй подтверждение через GUI или отдельную команду.
## 8. Настройка меню
Создай `menus.yml`, в котором можно менять:
- заголовки;
- размеры инвентарей;
- слоты предметов;
- Material;
- названия;
- описания;
- цвета;
- декоративные элементы;
- доступность кнопок;
- сообщения об ошибках;
- видимость функций в зависимости от роли.
Добавь проверку конфигурации при запуске и понятные ошибки при некорректном YAML.
## 9. Хранение и безопасность
- Используй SQLite и подготовленные SQL-запросы.
- Не выполняй SQL через конкатенацию пользовательского ввода.
- Проверяй длину и допустимые символы названий кланов.
- Не допускай дублирования кланов.
- Не допускай приглашения самого себя.
- Не допускай передачи лидерства игроку вне клана.
- Не позволяй участникам удалять чужие кланы.
- Корректно обрабатывай офлайн-игроков.
- Используй UUID как основной идентификатор игрока.
- Не блокируй главный поток длительными операциями с базой данных.
- Корректно закрывай соединения и задачи при выключении сервера.
## 10. Структура проекта
Создай отдельные классы:
- `TectonikClans`
- `ClanManager`
- `Clan`
- `ClanMember`
- `ClanStorage`
- `SQLiteStorage`
- `ClanCommand`
- `ClanTabCompleter`
- `ClanMenu`
- `ClanMenuListener`
- `ClanChatManager`
- `ColorEngine`
- `PermissionManager`
- `ConfigManager`
- `MessageManager`
Добавляй дополнительные классы по необходимости.
## 11. Готовность к использованию
Предоставь:
- полный `pom.xml`;
- полный `plugin.yml`;
- все Java-классы;
- все конфиги;
- README на русском языке;
- инструкцию по установке;
- список прав для LuckPerms;
- инструкции по изменению дизайна и лимитов;
- готовый ZIP с исходниками и JAR, если среда позволяет создать и проверить архив.
Проверь компиляцию Maven и исправь ошибки до завершения. Не утверждай, что проект протестирован на сервере, если фактического тестирования не было.
**Главная цель:** создать стабильный клановый плагин с удобной собственной GUI-менюшкой, командой `/clan create <название>`, поддержкой HEX/RGB, донатными возможностями и абсолютным отсутствием клановых тегов возле ников игроков.
Создам Maven-проект для Paper/Spigot 1.16.5 и Java 8 с конфигами и русской инструкцией.
Реализую SQLite-хранилище, кланы, роли, приглашения и проверку прав без изменения TAB, scoreboard и ника.
Добавлю команды с Tab Completion, цветовой движок, клановый чат и защищённые GUI-меню.
Создан исходный проект TectonikClans для Paper/Spigot 1.16.5 и Java 8: Maven-конфигурация, SQLite-хранилище с подготовленными запросами и отдельным потоком, управление кланами и ролями, приглашения, команды с Tab Completion, клановый чат и GUI. Оформление, сообщения, меню и лимиты участников вынесены в YAML; добавлен README на русском.
Плагин не меняет TAB, scoreboard, префиксы LuckPerms или отображение ников. Maven-сборку и тест на сервере здесь не выполнял, поэтому готовый JAR и ZIP не заявляю. Чтобы получить JAR в Kodari: нажмите Compile (на телефоне: ⋮ → Compile Project), затем Compile в открывшемся окне и Download после успешной сборки.
ClanMenuListener почини далбаеб
В проекте нет файлов, а без кода ClanMenuListener и описания ошибки нельзя понять, что именно чинить. Пришли класс и сообщение об ошибке или опиши, что в меню работает неправильно.
No files in this session