Напиши полный, готовый к продакшену плагин для плагинного ядра Paper (Minecraft version 1.21.5, Java 21) под названием "CustomShulkerEvent".
Требования к серверу и окружению:
- Версия: Paper 1.21.5 (используй актуальные методы API 1.21.5, избегай застаревших/deprecated методов).
- Язык: Java 21.
- Зависимости: DecentHolograms.
Основной функционал:
- Система 3 Редкостей и Настройка Шансов в Config:
- Уровень 1: Обычный (Зеленый шалкер, название "§aОбычный шалкер", 5 ударов). - Уровень 2: Редкий (Фиолетовый шалкер, название "§bРедкий шалкер", 10 ударов). - Уровень 3: Легендарный (Желтый/Оранжевый шалкер, название "§6Легендарный шалкер", 20 ударов). - В config.yml должна быть секция шансов спавна по умолчанию: chances: level1: 45 level2: 35 level3: 20 - При автоматическом спавне плагин динамически высчитывает редкость на основе этих процентов.
- Время Жизни Шалкеров (Деспавн 3 Минуты):
- Каждый спавнящийся шалкер живет ровно 3 минуты (180 секунд, настраивается в config.yml: despawn-time-seconds: 180). - Каждую секунду плагин обновляет таймер в голограмме (формат MM:SS). - Если за 3 минуты игроки не сломали шалкер: блок превращается в воздух, голограмма и задачи удаляются, лут НЕ выпадает.
- GUI-Настройка Лута (КРИТИЧЕСКИ ВАЖНО):
- Команда /shulker setloot <1|2|3> открывает GUI-инвентарь на 54 слота. - Администратор может класть любые кастомные предметы (NBT, Data Components 1.21.5, ExecutableItems). - При закрытии GUI все предметы сохраняются в config.yml через сериализацию ItemStack без ошибок и вылетов.
- Голограммы и Урон (через DecentHolograms):
- Над шалкером отображается 3 строки: Строка 1: "§aОбычный шалкер" (зависит от уровня) Строка 2: "§eПрочность: [ХП/МаксХП] ударов" Строка 3: "§cИсчезнет через: 02:59" (динамический таймер) - Удар по блоку отнимает 1 ХП и сразу обновляет строку ХП. - Когда ХП = 0: блок ломается, голограмма и таймер удаляются, из таблицы лута выбранного уровня выпадает 1-3 случайных предмета.
- Управление Точками и Команды:
- /shulker addpoint <имя> — сохранить точку спавна. - /shulker delpoint <имя> — удалить точку. - /shulker points — список сохраненных точек. - /shulker spawn <1|2|3> <точка> — принудительно заспавнить конкретный уровень. - /shulker start [количество] — запустить ивент: выбирает случайные точки и спавнит шалкеры, генерируя их уровень по процентам шансов (45% / 35% / 20%).
Напиши весь Java-код (со всеми BukkitTask/Runnable для таймера 3 минут, проверками на null, отной отмены урона блоку) и файл plugin.yml. Код должен быть полностью готовым к компиляции. вот тз сделай мне плагин и сразу скинь мне файл .jar
План:
Подготовить Gradle-сборку под Java 21, Paper 1.21.5 и DecentHolograms.
Реализовать команды, точки спавна, конфигурируемый выбор редкости, таймер, урон и выпадение лута.
Добавить сохранение GUI-лут-таблиц и
plugin.yml;.jarздесь собрать и приложить не могу, но подготовлю проект для сборки.
Создал проект CustomShulkerEvent: команды управления точками и ивентом, три уровня шалкеров, голограммы DecentHolograms, таймер исчезновения и GUI лут-таблиц с сохранением ItemStack в config.yml.
Собрать JAR в этой среде и прикрепить его не могу. В проекте настроена сборка Java 21; команда gradle build создаст build/libs/CustomShulkerEvent-1.0.0.jar. На сервере должен быть установлен DecentHolograms.
без вопросов сделай то что я сказал не больше не меньше так что просто сделай плагин из моего тз баги и фичи сделай так чтобы их не было и все просто скинь мне уже готовый джар файл
Готового .jar файла в проекте нет. Собрать и прикрепить бинарный файл из этой среды я не могу.
что нажать чтоб мне сделали джар файл сразу
Нажми Build / Собрать проект в интерфейсе проекта. После успешной сборки скачай файл:
build/libs/CustomShulkerEvent-1.0.0.jar
Если кнопки сборки нет, запусти в терминале проекта gradle build — JAR появится по этому же пути.
куда нажать
Нажми зелёную кнопку Compile в правом верхнем углу. Дождись завершения сборки — затем открой build/libs в панели Files и скачай .jar файл.
Нажми Gradle — синюю кнопку справа от Java. Это проект на Gradle; после выбора начнётся сборка или появится следующий шаг.
ахуительно но меняй нек вещи
- спавн я не имел в виду то что спав 3 мин или наоборот
смотри шалкер стоит и не изчезает до момента пока его не поломают и идет отсчет 3 мин и шалкер спавнитьься
- лут в шалкерах должен тоже как то с шансамы выпадать чтоб не был одинаковым там не знаю насьолйки лута и там как то присоидени настройку шансов
так же точка стоит и как я уже сказал шалкер стоит пока не сломают идет отсчет 3 мин спавниться 1 из 3 лв шалкер и так же не изчезает пока не сломаюи на той же точке
План:
Исправить жизненный цикл точки: шалкер остаётся до поломки, через 3 минуты после поломки на той же точке появляется следующий.
Добавить независимые шансы выпадения предметов в настройку лута и применять их при выдаче награды.
Исправил цикл точки: шалкер не исчезает по таймеру; после поломки запускается 3-минутный отсчёт и на той же точке появляется шалкер случайного уровня.
Добавляю шансы выбора лута отдельными весами для предметов каждого уровня; веса задаются в
config.yml.
Исправил цикл: шалкер не исчезает по таймеру. После поломки точка отсчитывает 3 минуты, затем на ней появляется шалкер случайного уровня. Во время ожидания таймер отображается голограммой.
Для лута добавлены веса выбора предметов: настрой их в config.yml в loot-chances.level1, level2 и level3. Вес 100 используется по умолчанию, 0 отключает выпадение предмета. За одно разрушение одинаковые предметы не выбираются повторно.
Новый .jar появится после сборки проекта кнопкой Compile.
нет настройка шансов лута тоже чтоб была в майпе чепез легкую гуи так же сделай более поняткую настройку ур шалкера
План:
Добавить удобную GUI-настройку шанса выпадения для каждого предмета в луте.
Сделать уровни шалкеров понятными и настраиваемыми через отдельные секции в
config.yml(название, прочность, цвет и шанс спавна).
Добавил настройку шансов лута через GUI: открой /shulker setloot <1|2|3> и нажми книгу в нижнем ряду. В меню шансов ПКМ повышает шанс на 5%, ЛКМ снижает; Shift+ПКМ устанавливает 100%, Shift+ЛКМ — 0%. Также доступна команда /shulker lootchance <1|2|3>. Шанс проверяется для каждого предмета из случайной выборки 1–3 предметов.
Настройки уровней теперь собраны в config.yml в секциях levels.level1, levels.level2, levels.level3: там можно менять отображаемое имя, материал шалкера, количество ударов и шанс спавна.
Чтобы получить обновлённый .jar, нажми Compile.
убераем не красиве надписи все чотко и красиво просто оставь до след шалкера : 1.20 остально все заебись только нужно сделать так чтобы с шалкера падало не 2 предмета а макс 3 а так все заебись сделай меньше нагрузку на сервер так же добавь команду которая обновит все шалкера не взависимости от прочности и времени
План:
Упростить голограмму до одной строки «До следующего шалкера: 1:20».
Проверить выпадение лута и ограничить его максимумом в 3 предмета.
Снизить нагрузку на таймеры и добавить команду для немедленного обновления всех точек/шалкеров.
[Generation stopped]
нет ты не понял оставь все как в прошлой версии я имею в виду лут и предметы измени все остольное
Оставляю текущие настройки лута и предметов без изменений.
Меняю только оформление голограммы, нагрузку таймера и команду принудительного обновления шалкеров.
Лут и предметы не менял. Оставил голограмму таймера одной строкой «До следующего шалкера: 1:20», снизил нагрузку — поиск метода обновления голограммы теперь кэшируется, а команда /shulker refresh обновляет шалкеры на всех точках независимо от прочности и таймера.
Нажми Compile, чтобы собрать обновлённый .jar.
убери сообщения в чате о поломке шалкера дальше при поломке шалкера должно падать мин 3 предмета и макс 3 предмета лут сколько угодно но при поломке шалкера 3 предмета типо лут там хоть 20 вещей но при поломке падает только 3
План:
Убрать из чата сообщения о прочности и поломке шалкера, не трогая голограмму.
Настроить выпадение ровно 3 предметов за поломку, выбирая их из всего настроенного лута.
Убрал сообщения в чате о прочности и поломке шалкера — голограмма осталась. При поломке теперь выпадает ровно 3 предмета, даже если в таблице лута больше трёх: выбор учитывает настроенные шансы. Если предметов с ненулевым шансом меньше трёх, они могут повториться.
Собери обновлённый .jar кнопкой Compile.
📄
pasted-code-1791638570109.txt
txt
180 lines
▶
Сделай рабочий плагин SpookyStash для Paper/Spigot 1.16+ на основе следующего ТЗ:
1. Описание: Плагин создает виртуальный тайник (GUI на 27 слотов) для каждого игрока с автосохранением содержимого в файл cache.yml.
2. Команды: /stash (алиас /тайник) — открывает GUI личного тайника игрока.
3. Главная задача: Реализовать сохранение предметов при закрытии меню через InventoryCloseEvent и загрузку массива ItemStack[] из cache.yml при вызове /stash.
Структура кода:
1. plugin.yml
name: SpookyStash
version: 1.0
main: net.spooky.stash.SpookyStash
api-version: 1.16
commands:
stash:
description: Открыть личный тайник
permission: spookystash.use
aliases: [тайник]
2. SpookyStash.java
package net.spooky.stash;
import org.bukkit.plugin.java.JavaPlugin;
public class SpookyStash extends JavaPlugin {
private static SpookyStash instance;
private StashManager stashManager;
@Override
public void onEnable() {
instance = this;
saveDefaultConfig();
this.stashManager = new StashManager(this);
this.stashManager.loadStashes();
getCommand("stash").setExecutor(new StashCommand(this));
getServer().getPluginManager().registerEvents(new InventoryListener(this), this);
}
@Override
public void onDisable() {
if (stashManager != null) {
stashManager.saveAll();
}
}
public static SpookyStash getInstance() { return instance; }
public StashManager getStashManager() { return stashManager; }
}
3. StashManager.java
package net.spooky.stash;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.inventory.ItemStack;
import java.io.File;
import java.io.IOException;
import java.util.*;
public class StashManager {
private final SpookyStash plugin;
private final File cacheFile;
private FileConfiguration cacheConfig;
private final Map stashes = new HashMap<>();
public StashManager(SpookyStash plugin) {
this.plugin = plugin;
this.cacheFile = new File(plugin.getDataFolder(), "cache.yml");
if (!cacheFile.exists()) {
plugin.saveResource("cache.yml", false);
}
this.cacheConfig = YamlConfiguration.loadConfiguration(cacheFile);
}
@SuppressWarnings("unchecked")
public void loadStashes() {
if (!cacheConfig.contains("stashes")) return;
for (String key : cacheConfig.getConfigurationSection("stashes").getKeys(false)) {
UUID uuid = UUID.fromString(key);
List list = (List) cacheConfig.get("stashes." + key);
if (list != null) {
stashes.put(uuid, list.toArray(new ItemStack[0]));
}
}
}
public void setStashContent(UUID uuid, ItemStack[] contents) {
stashes.put(uuid, contents);
saveStash(uuid, contents);
}
public ItemStack[] getStashContent(UUID uuid) {
return stashes.getOrDefault(uuid, new ItemStack[27]);
}
public void saveStash(UUID uuid, ItemStack[] contents) {
cacheConfig.set("stashes." + uuid.toString(), contents);
try {
cacheConfig.save(cacheFile);
} catch (IOException e) {
e.printStackTrace();
}
}
public void saveAll() {
for (Map.Entry entry : stashes.entrySet()) {
cacheConfig.set("stashes." + entry.getKey().toString(), entry.getValue());
}
try {
cacheConfig.save(cacheFile);
} catch (IOException e) {
e.printStackTrace();
}
}
}
4. StashCommand.java
package net.spooky.stash;
import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
public class StashCommand implements CommandExecutor {
private final SpookyStash plugin;
public StashCommand(SpookyStash plugin) {
this.plugin = plugin;
}
@Override
public boolean onCommand(CommandSender sender, Command cmd, String label, String[] args) {
if (!(sender instanceof Player)) {
sender.sendMessage("Команда только для игроков!");
return true;
}
Player player = (Player) sender;
Inventory stashGui = Bukkit.createInventory(null, 27, ChatColor.DARK_PURPLE + "Личный Тайник");
ItemStack[] items = plugin.getStashManager().getStashContent(player.getUniqueId());
if (items != null) {
stashGui.setContents(items);
}
player.openInventory(stashGui);
return true;
}
}
5. InventoryListener.java
package net.spooky.stash;
import org.bukkit.ChatColor;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.inventory.InventoryCloseEvent;
public class InventoryListener implements Listener {
private final SpookyStash plugin;
public InventoryListener(SpookyStash plugin) {
this.plugin = plugin;
}
@EventHandler
public void onInventoryClose(InventoryCloseEvent event) {
if (event.getView().getTitle().equals(ChatColor.DARK_PURPLE + "Личный Тайник")) {
Player player = (Player) event.getPlayer();
plugin.getStashManager().setStashContent(player.getUniqueId(), event.getInventory().getContents());
}
}
}
План:
Заменить старый плагин шалкеров на SpookyStash и настроить команду
/stashс алиасом/тайник.Добавить GUI на 27 слотов и надёжное сохранение/загрузку тайника игрока в
cache.ymlпри закрытии и запуске плагина.
Заменил проект на SpookyStash: /stash и /тайник открывают личный тайник на 27 слотов. Предметы сохраняются в cache.yml при закрытии меню и загружаются снова при следующем открытии или перезапуске плагина.
Исправление GUI настройки лута тайников
В плагине CustomStash необходимо реализовать полноценную настройку лута через графический интерфейс (GUI) непосредственно в Minecraft.
Как должен работать GUI
- Администратор вводит
/stash edit <id>, например/stash edit res. - Открывается инвентарь Minecraft с редактором лута именно выбранного тайника.
- Администратор может перетаскивать предметы из своего инвентаря в GUI, добавлять и удалять награды, менять количество предметов и настраивать шансы выпадения.
- Все изменения сохраняются отдельно для каждого тайника.
- После закрытия GUI изменения автоматически сохраняются.
- После повторного открытия редактора все ранее добавленные предметы, их количества и шансы должны отображаться правильно.
- После перезапуска сервера настройки не должны пропадать.
- При открытии тайника игрок получает награду только из лута того тайника, который он открыл.
Главная проблема, которую нужно исправить
Сейчас настройка лута через GUI не работает правильно: необходимо проверить, почему предметы не сохраняются, не применяются или могут попадать в лут другого тайника.
Проверь:
- Передаётся ли ID тайника при открытии GUI и сохраняется ли он в обработчике кликов.
- Не используют ли все GUI один общий список наград.
- Сохраняется ли содержимое редактора после закрытия инвентаря.
- Правильно ли обрабатываются события
InventoryClickEventиInventoryCloseEvent. - Не отменяются ли все клики так, что администратор не может добавлять предметы.
- Не теряются ли предметы при перетаскивании через
InventoryDragEvent. - Сохраняются ли изменения в YAML под правильным ID тайника.
- Не перезаписывает ли
/stash reloadсохранённые настройки значениями по умолчанию.
Настройка шансов
Для каждого предмета в редакторе должна быть возможность настроить шанс выпадения. Например, при нажатии на предмет открывается меню, в котором можно изменить шанс через чат, нажатия по предмету или другой удобный способ.
Шансы должны храниться отдельно для каждого тайника. Изменение шанса в res не должно менять шанс в bronya или других тайниках.
Обязательные требования
- Использовать актуальный Paper API для версии 1.21.5 и Java 21.
- Сделать удобный GUI с цветными названиями и подсказками.
- Добавить кнопки сохранения, выхода и возврата.
- Не допускать дюпов и потери предметов при закрытии GUI.
- Обеспечить корректную обработку кликов и перетаскивания.
- Сохранять настройки каждого тайника независимо.
- Проверить весь путь от редактирования лута до фактической выдачи награды игроку.
Предоставь полный исправленный код, а не только объяснение или отдельный фрагмент. Если исходный код плагина доступен, сначала найди конкретную причину ошибки, затем исправь её.
📄
pasted-code-1791639700093.txt
txt
1 lines
▶
Создай полноценный аналог плагина SpookyStash для Minecraft Paper 1.21.5 на Java 21 под названием CustomStash: плагин должен создавать тайники с уникальными ID, цветными названиями и привязкой к выбранному месту, позволять удалять и переносить тайники, редактировать их через GUI, настраивать содержимое, награды и шансы выпадения, открывать тайники с помощью специальных отмычек, причём каждый тип отмычки привязан к своему тайнику; реализуй сохранение всех тайников, координат, миров, наград, шансов и количества отмычек после перезапуска сервера, конфигурацию в YAML, проверку прав доступа, защиту от дюпов и повторного открытия, обработку ошибок, поддержку цветных названий через legacy-коды `&`/`§` или MiniMessage, совместимость с Java- и Bedrock-игроками через Geyser/Floodgate и возможность интеграции голограмм через DecentHolograms; если один и тот же предмет находится в нескольких слотах наград, его суммарный шанс должен учитывать количество повторений, если это подтверждается настройкой системы; добавь команды `/stash create <название>` — создать тайник, `/stash edit ` — открыть редактор тайника, `/stash givekey <игрок> <количество>` — выдать отмычки конкретного тайника, `/stash delete ` — удалить тайник, `/stash reload` — перезагрузить конфигурацию и `/stashShop` — открыть магазин тайников; добавь администраторское право `spookystash.admin` либо аналогичное `customstash.admin`; предусмотрите ресурсы и команды управления ими `/stash givesilver`, `/stash takesilver`, `/stash givesplinter`, `/stash takesplinter`, `/stash changesplinter`, `/stash givesoul`, `/stash takesoul`, `/stash changesoul`, `/stash changefish <игрок> <тип рыбы> <количество/all>`; создай начальные типы тайников `res` — ресурсы, `bronya` — броня, `talisman` — талисманы, `sfers` — сферы, `pickaxe` — кирки, с поддержкой отдельных цветов и редактируемых названий; сделай подробную документацию по всем командам, permissions, аргументам и конфигам, используй актуальные API без deprecated-методов и предоставь готовый собираемый Maven-проект с `pom.xml`, `plugin.yml`, Java-классами и конфигурацией по умолчанию; не выдумывай неизвестные оригинальные функции SpookyStash — если точное поведение не подтверждено, реализуй его как отдельную настраиваемую функцию.
План:
Проверить текущую структуру проекта и найти причину, почему редактор лута не сохраняет данные тайника отдельно.
Исправить GUI: редактирование предметов и шансов, сохранение при закрытии, защита от дюпов и независимые данные каждого тайника.
Согласовать команды, конфиги и выдачу наград с редактором, сохранив работоспособный Paper-проект.
[Generation stopped]
наскольно все готово ?
Основная часть редактора лута внесена: затронуты команды и менеджер тайников, обработчики инвентаря, добавлены GUI-редактор и меню списка, обновлены конфигурация и plugin.yml.
Но считать работу полностью готовой пока нельзя: генерация остановилась до итоговой проверки. Сборка и проверка в игре — включая сохранение после закрытия и перезапуска, перетаскивание предметов и раздельную выдачу лута для разных тайников — не подтверждены. Поэтому честный статус: кодовые изменения внесены, но работоспособность ещё не проверена.
все могу комплите нажимать ?
Да, нажимай Compile — так проверится, собирается ли проект. Если появится ошибка, нажми Auto-fix в чате или Fix в окне сборки.
на новый тз сделай только по нему
📄
pasted-code-1791641400879.txt
txt
293 lines
▶
# Техническое задание: разработка аналога SpookyStash
## 1. Основная информация
Разработай полноценный плагин для Minecraft Java под названием **CustomStash** — функциональный аналог SpookyStash.
**Среда:**
- Ядро: Paper / совместимые форки Paper, включая Leaf.
- Версия сервера: Minecraft 1.21.8.
- Java: 21.
- Язык программирования: Java.
- Сборка: Gradle или Maven.
- Результат: готовый рабочий файл `.jar`, который можно сразу установить на сервер.
- Плагин должен корректно работать с инвентарями, предметами, NBT/PDC и сторонними плагинами на кастомные предметы.
Важно: это не демонстрационный проект и не просто пример кода. Нужен полноценный плагин, готовый к использованию на реальном сервере.
## 2. Главная механика
Плагин добавляет на сервер тайники с разными категориями лута. Игрок получает ключ или отмычку, использует её на тайнике и получает случайные предметы из настроенного списка наград.
Каждый тайник должен иметь:
- Уникальный ID.
- Название с поддержкой цветовых кодов.
- Собственную конфигурацию лута.
- Собственные шансы выпадения предметов.
- Настраиваемое количество предметов и диапазоны количества.
- Возможность выдавать несколько предметов за одно открытие.
- Настраиваемую стоимость открытия, если такая механика предусмотрена.
- Собственные сообщения и параметры открытия.
- Возможность включать и выключать тайник без удаления его настроек.
Примеры тайников:
- `res` — тайник с ресурсами.
- `bronya` — тайник с бронёй.
- `talisman` — тайник с талисманами.
- `sfers` — тайник со сферами.
- `pickaxe` — тайник с кирками.
Это примеры. Все тайники должны создаваться и редактироваться администраторами, а не быть жёстко прописанными в коде.
## 3. Самая важная функция — GUI-редактор лута
**Настройка лута должна выполняться непосредственно в игре через графический инвентарь Minecraft. Это обязательная функция. Не заменяй её редактированием YAML-файлов.**
Добавь удобное меню управления тайниками.
### Главное меню
В меню должны отображаться:
- Список созданных тайников.
- Название и ID каждого тайника.
- Кнопка создания тайника.
- Кнопка редактирования выбранного тайника.
- Кнопка удаления с подтверждением.
- Кнопка перезагрузки конфигурации.
### Редактор лута
При выборе тайника администратор открывает GUI, в котором можно:
- Перетаскивать предметы из своего инвентаря в меню.
- Забирать предметы обратно из меню.
- Перемещать предметы между слотами.
- Добавлять новые предметы в список наград.
- Удалять ненужные награды.
- Настраивать шанс выпадения предмета.
- Настраивать минимальное и максимальное количество.
- Настраивать вероятность выпадения отдельных предметов.
- Сохранять изменения и возвращаться в главное меню.
- Отменять изменения, если они ещё не были сохранены.
Если для настройки шанса требуется отдельное меню, открывай его при нажатии на предмет. Числовые значения можно вводить через чат или другой удобный интерфейс, но сам список предметов должен редактироваться через GUI.
### Обязательное поведение GUI
- Обрабатывай `InventoryClickEvent`, `InventoryDragEvent` и `InventoryCloseEvent` корректно.
- Не позволяй случайно перемещать декоративные кнопки.
- Не допускай дублирования или исчезновения предметов.
- Не допускай переноса предметов между меню разных тайников.
- Не сохраняй декоративные предметы интерфейса в качестве наград.
- Не перезаписывай лут одного тайника данными другого.
- После закрытия и повторного открытия меню настройки должны соответствовать последнему сохранённому состоянию.
- При перезапуске сервера весь настроенный лут должен сохраняться.
- Если игрок закрывает редактор без сохранения, должна работать предусмотренная логика отмены изменений.
- Не сохраняй изменения многократно при каждом клике, если это может вызвать повреждение конфигурации. Используй безопасное сохранение.
**Исправь типичные ошибки GUI-редакторов:** потерю предметов при закрытии, дублирование предметов, неправильные слоты, обработку Shift-клика, перетаскивание мышью, закрытие меню клавишей Esc и конфликты с другими обработчиками инвентаря.
## 4. Система ключей и отмычек
Реализуй отдельные ключи или отмычки для открытия тайников.
Требования:
- Ключ привязывается к определённому ID тайника.
- Нельзя открыть тайник ключом от другого тайника.
- Предмет должен иметь уникальный идентификатор через PersistentDataContainer или другой надёжный механизм.
- Проверяй идентификатор предмета, а не только его название и материал.
- Поддерживай кастомные предметы с зачарованиями, описанием и дополнительными данными.
- Настрой расход ключей: один ключ за открытие либо другой режим из конфигурации.
- Не допускай двойного открытия при одном использовании.
- Добавь возможность выдачи ключей администраторами.
- Добавь поддержку бесконечных ключей, если это включается настройкой.
- Ключи должны корректно работать в основных руках и с предметами из сторонних плагинов.
При открытии тайника покажи игроку анимацию или последовательность выбора награды, если она предусмотрена настройками. После завершения выдай награду и отправь сообщение об успешном открытии.
Если инвентарь игрока заполнен, предметы не должны пропадать: положи их на землю рядом с игроком или используй другой настраиваемый безопасный способ выдачи.
## 5. Команды
Реализуй команды с проверкой прав доступа и понятными сообщениями об ошибках.
Основная команда: `/stash`
Предусмотри следующие подкоманды:
- `/stash` — открыть главное меню управления тайниками для администратора или показать доступную игроку информацию.
- `/stash help` — показать список команд.
- `/stash list` — показать список тайников.
- `/stash create <название>` — создать тайник.
- `/stash edit ` — открыть GUI редактирования тайника.
- `/stash delete ` — удалить тайник с подтверждением.
- `/stash givekey <игрок> <количество>` — выдать ключи.
- `/stash reload` — безопасно перезагрузить конфигурацию.
- `/stash info ` — показать информацию о тайнике.
- `/stash setname <название>` — изменить название тайника.
- `/stash open <игрок> ` — административно открыть тайник игроку, если такая возможность предусмотрена.
- `/stash preview ` — посмотреть содержимое или возможные награды без получения предметов.
Если в оригинальном SpookyStash существуют дополнительные команды для валют, осколков, душ, рыб или других предметов, изучи исходный код и конфигурацию оригинального плагина, если они доступны, и реализуй совместимые аналоги. Не придумывай несуществующие команды и не утверждай, что они присутствовали в оригинале без проверки.
Добавь Tab Completion для подкоманд, ID тайников и имён игроков, где это возможно.
## 6. Права доступа
Добавь разрешения:
- `customstash.admin` — полный доступ к управлению тайниками.
- `customstash.create` — создание тайников.
- `customstash.edit` — редактирование тайников.
- `customstash.delete` — удаление тайников.
- `customstash.givekey` — выдача ключей.
- `customstash.reload` — перезагрузка конфигурации.
- `customstash.preview` — просмотр наград.
- `customstash.open` — открытие тайников, если это требуется для отдельной механики.
Административные команды должны проверять права доступа на сервере. Игрок не должен иметь возможность вызвать административное действие через GUI без соответствующего разрешения.
## 7. Система выпадения предметов
Реализуй надёжный генератор наград.
Для каждого предмета должны поддерживаться:
- Материал.
- Название.
- Описание.
- Зачарования.
- Количество или диапазон количества.
- Шанс выпадения.
- Дополнительные метаданные, если они присутствуют у предмета.
- Кастомные данные сторонних плагинов, насколько это возможно через API.
По возможности сохраняй полноценный ItemStack, а не только материал и количество. Для кастомных предметов это особенно важно.
Проверяй корректность шансов и количества. Не допускай отрицательных значений, некорректных диапазонов и вероятностей, приводящих к ошибкам.
Добавь настраиваемые режимы:
- Одна случайная награда.
- Несколько случайных наград.
- Выбор количества наград из диапазона.
- Независимые шансы для каждого предмета.
Опиши в документации, как рассчитываются шансы и как они взаимодействуют друг с другом.
## 8. Конфигурация и хранение данных
Создай понятную структуру файлов, например:
- `config.yml` — основные настройки.
- `stashes.yml` или отдельные файлы тайников — ID, названия и параметры.
- Файлы данных предметов — если это необходимо для надёжного хранения кастомных ItemStack.
- `messages.yml` — сообщения плагина.
Все важные параметры должны быть настраиваемыми.
При сохранении данных:
- Используй безопасную сериализацию предметов.
- Не теряй зачарования, названия, описание и поддерживаемые кастомные данные.
- Создавай резервную копию перед опасными операциями, если это возможно.
- Не удаляй существующие настройки при обновлении плагина.
- Проверяй конфигурацию при загрузке и выводи понятные ошибки.
- Не отключай весь плагин из-за одной некорректной награды, если ошибку можно безопасно изолировать.
- Не повреждай файл при внезапном завершении сервера.
При удалении тайника предупреди администратора, что его настройки будут удалены. Не удаляй данные других тайников.
## 9. Совместимость
Плагин должен работать на Paper 1.21.8 и совместимых форках, включая Leaf, на Java 21.
По возможности обеспечь совместимость с:
- ExecutableItems.
- DecentHolograms.
- PlaceholderAPI.
- LuckPerms.
- Vault.
- Geyser/Floodgate.
Не делай эти плагины обязательными, если они не нужны для основной механики. Отсутствие необязательной зависимости не должно мешать запуску CustomStash.
Не используй NMS без необходимости. Предпочитай стабильный Bukkit/Paper API. Не добавляй в проект методы, которые не существуют в целевой версии API.
## 10. Защита от ошибок и эксплойтов
Обязательно предусмотрены:
- Проверка прав доступа для каждой административной операции.
- Защита от подделки ключей по названию предмета.
- Защита от дублирования наград при двойном клике.
- Защита от повторного открытия одного тайника в процессе анимации.
- Проверка существования ID тайника.
- Проверка количества и шансов наград.
- Корректная обработка выхода игрока во время открытия.
- Очистка временных данных при выходе игрока.
- Защита от ошибок при перезагрузке конфигурации.
- Понятные сообщения в консоли и логирование важных ошибок.
Не блокируй обычные инвентари других плагинов. Все GUI CustomStash должны идентифицироваться надёжным способом, а не только по названию меню.
## 11. Сообщения и оформление
Все сообщения должны редактироваться в `messages.yml`.
Поддержи:
- Цветовые коды `&a`, `&c`, `&d` и остальные стандартные коды.
- HEX-цвета, если это поддерживается выбранным API.
- Настраиваемые названия меню.
- Настраиваемые названия и описание ключей.
- Сообщения об успешном открытии.
- Сообщения о нехватке ключей.
- Сообщения об отсутствии прав.
- Сообщения о неизвестном тайнике.
- Сообщения об ошибках конфигурации.
Текст сообщений не должен быть жёстко прописан во всём коде.
## 12. Производительность
- Не используй бесконечные циклы и блокирующие операции в основном потоке сервера.
- Не сохраняй весь файл конфигурации при каждом действии игрока без необходимости.
- Не создавай утечки памяти из-за открытых GUI и временных объектов.
- Корректно очищай задачи и данные после завершения открытия.
- Не допускай массовой выдачи наград из-за ошибок логики.
## 13. Критерии готовности
Перед выдачей готового `.jar` проверь:
1. Плагин успешно собирается под Java 21.
2. Плагин запускается на Paper 1.21.8.
3. Плагин не отключается при старте из-за ошибок API или конфигурации.
4. Команда `/stash` работает.
5. Администратор может создать тайник.
6. Администратор может открыть GUI-редактор лута.
7. Предметы можно добавлять, перемещать и удалять через GUI.
8. Настройки лута сохраняются и загружаются после перезапуска.
9. Разные тайники имеют независимые настройки.
10. Ключ от одного тайника не открывает другой.
11. Награды выдаются корректно и не дублируются.
12. Полный инвентарь не приводит к потере наград.
13. Команды и разрешения работают корректно.
14. Перезагрузка не повреждает данные.
15. В консоли отсутствуют ошибки, связанные с самим плагином.
Протестируй отдельно клики мышью, Shift-клики, перетаскивание предметов, закрытие GUI, выход игрока, перезапуск сервера и заполненный инвентарь.
## 14. Что нужно предоставить в результате
Предоставь:
- Полный исходный код проекта.
- Готовый файл `CustomStash.jar`.
- `plugin.yml`.
- Все необходимые конфигурации.
- Инструкцию по установке и использованию.
- Полный список команд и разрешений.
- Пример создания тайника и настройки лута через GUI.
- Отчёт о выполненных тестах.
- Исправления всех ошибок компиляции и запуска, найденных во время тестирования.
Не выдавай только отдельные классы, фрагменты кода или инструкции по самостоятельной сборке. Если среда позволяет, собери настоящий `.jar` и приложи его. Не заявляй, что плагин протестирован, если он фактически не был собран и запущен.
## 15. Если доступен оригинальный SpookyStash
Если предоставлен оригинальный `.jar`, исходный код или папка данных SpookyStash, сначала изучи доступные материалы, чтобы установить фактические команды, механику ключей, названия меню, способы настройки лута и структуру хранения.
Сохрани поведение оригинала там, где оно подтверждено. Если оригинальный код недоступен, реализуй функционально эквивалентную механику по этому ТЗ и явно укажи, какие детали являются предположениями.
**Главный приоритет: рабочая настройка лута через GUI, надёжное сохранение данных, отсутствие дублирования или потери предметов и корректный запуск плагина на сервере.**
План:
Сверить текущий проект с новым ТЗ и определить, что уже реализовано, а что отсутствует.
Доработать только функции из нового ТЗ, в первую очередь независимый GUI-редактор лута и сохранение.
Проверить доступную сборку и сообщить, что реально подтверждено тестами.
Обновил проект по новому ТЗ: целевая версия — Paper 1.21.8 и Java 21. В редакторе можно добавлять предметы кликами, Shift-кликом и перетаскиванием, менять их шансы и диапазон количества, перемещать между слотами и удалять. Сохранить записывает изменения; кнопки выхода, возврата и Esc отменяют изменения после последнего сохранения. Незаписанные добавленные предметы возвращаются игроку, а настройки тайников сохраняются раздельно в YAML. Добавлены ключи с PDC, независимые шансы наград, подтверждение удаления, права, команды и инструкция README.md.
Полностью готовым и протестированным плагин пока назвать нельзя: сборка и запуск на сервере не подтверждены, готового .jar здесь нет. Также ещё не вынесены все сообщения в messages.yml и не подключены необязательные интеграции со сторонними плагинами. Нажми Compile, чтобы проверить, собирается ли текущая версия проекта.
package net.spooky.stash;
import com.cryptomorin.xseries.XMaterial;
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer;
import org.bukkit.NamespacedKey;
import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.meta.ItemMeta;
import org.bukkit.persistence.PersistentDataType;
import org.bukkit.plugin.java.JavaPlugin;
public final class SpookyStash extends JavaPlugin {
private StashManager stashManager;
private NamespacedKey stashKeyTag;
@Override
public void onEnable() {
saveDefaultConfig();
stashKeyTag = new NamespacedKey(this, "stash_id");
stashManager = new StashManager(this);
if (getCommand("stash") == null) {
getLogger().severe("Команда stash отсутствует в plugin.yml; плагин будет отключен.");
getServer().getPluginManager().disablePlugin(this);
return;
}
StashCommand stashCommand = new StashCommand(this);
getCommand("stash").setExecutor(stashCommand);
getCommand("stash").setTabCompleter(stashCommand);
if (getCommand("stashshop") != null) {
getCommand("stashshop").setExecutor((sender, command, label, args) -> {
if (!(sender instanceof org.bukkit.entity.Player player)) {
sender.sendMessage("Команда доступна только игрокам.");
return true;
}
if (!player.hasPermission("customstash.use") && !player.hasPermission("customstash.admin")) {
player.sendMessage("§cНедостаточно прав.");
return true;
}
StashGUI.openShop(this, player);
return true;
});
}
getServer().getPluginManager().registerEvents(new InventoryListener(this), this);
}
@Override
public void onDisable() {
if (stashManager != null) {
stashManager.save();
}
}
public StashManager getStashManager() {
return stashManager;
}
ItemStack createKey(String stashId, int amount) {
ItemStack item = XMaterial.matchXMaterial("TRIPWIRE_HOOK").map(XMaterial::parseItem).orElse(null);
if (item == null) throw new IllegalStateException("XSeries не смог создать предмет отмычки.");
item.setAmount(amount);
ItemMeta meta = item.getItemMeta();
meta.displayName(LegacyComponentSerializer.legacyAmpersand().deserialize("&6Отмычка: " + stashManager.getName(stashId)));
meta.lore(java.util.List.of(Component.text("ID: " + stashId), Component.text("ПКМ по привязанному тайнику")));
meta.getPersistentDataContainer().set(stashKeyTag, PersistentDataType.STRING, stashId);
item.setItemMeta(meta);
return item;
}
String readKeyId(ItemStack item) {
if (item == null || !item.hasItemMeta()) return null;
return item.getItemMeta().getPersistentDataContainer().get(stashKeyTag, PersistentDataType.STRING);
}
}