# История версий

### 2.5.4 - 27.05.2026

**Список изменений:**

* Добавлена поддержка версий игры **26.1.X***.*
* Добавлена задержка в **1 тик** между командами на выдачу покупок. Интервал устраняет конфликты в работе некоторых сторонних плагинов, чувствительных к одновременному выполнению нескольких команд.
* Добавлена проверка возможности выдачи покупок при запуске плагина для обнаружения несовместимости с ядром игрового сервера.

### 2.5.3 - 28.01.2026

**Список изменений:**

* Добавлена поддержка версии игры **1.21.11**. (NMS 1\_21\_R7)*.*
* Удалена опция `permission-level` из конфигурации плагина, исполнитель команд теперь всегда имеет все права. Причина такого решения изложена в [#36](https://github.com/EasyDonate/EasyPayments/issues/36).
* Добавлены таймауты ожидания завершения задач при выключении плагина.

*Ручное обновление конфигурации не требуется — плагин всё сделает сам.*

{% embed url="<https://easydonate.s3.easyx.ru/resources/plugins/easypayments/2.5.3/EasyPayments-2.5.3.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.5.3
{% endembed %}

### 2.5.2 - 06.11.2025

**Список изменений:**

* Добавлена поддержка версий игры **1.21.9 — 1.21.10**. *(NMS 1\_21\_R6).*
* Изменен способ получения UUID игрока, которого никогда не было на сервере.
* Улучшен вывод `/ep status`: добавлена информация о платформе и имени исполнителя команд выдачи.
* Исправлена работа плагина на 1.21.9 и выше.
* Добавлены новые опции **для опытных пользователей** в конфигурации плагина:
  * `executor-name` для настройки имени исполнителя команд выдачи;
  * `force-internals-backed-platform` для принудительного использования реализации платформо-зависимых инструментов, основанной на работе с внутренним кодом игры (NMS), вместо универсальной реализации, где имя исполнителя команд выдачи зафиксировано на ***FeedbackForwardingSender***.
* Следующие опции в конфигурации плагина были перемещены в раздел **для опытных пользователей**:
  * `feedback-await-time` ;
  * `permission-level` .

*Ручное обновление конфигурации не требуется — плагин всё сделает сам.*

{% embed url="<https://easydonate.s3.easyx.ru/resources/plugins/easypayments/2.5.2/EasyPayments-2.5.2.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.5.2
{% endembed %}

### 2.5.1 - 30.09.2025

**Список изменений:**

* Добавлена поддержка фоновой синхронизации информации об игроках с EasyDonate.
* Добавлена поддержка режимов работы плагина, определяемых платформой.
* Исправлена работа плагина в аспекте регистра символов в никах.
* Исправлены ложный статус «В корзине покупателя» и потеря покупок в некоторых ситуациях.
* Исправлено прерывание инициализации плагина при первом запуске.
* Исправлен баг, останавливающий работу плагина после перезапуска `/ep reload`

{% embed url="<https://easydonate.s3.easyx.ru/resources/plugins/easypayments/2.5.1/EasyPayments-2.5.1.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.5.1
{% endembed %}

### 2.4.3 - 12.09.2025

**Список изменений:**

* Добавили поддержку версий Spigot 1.21.5–1.21.8.
* Улучшили обнаружение некорректной [настройки](https://t.me/easydonate_news/105).

{% embed url="<https://easydonate.s3.easyx.ru/resources/plugins/easypayments/2.4.3/EasyPayments-2.4.3.jar>" fullWidth="true" %}
Прямая ссылка на скачивание EasyPayments 2.4.3
{% endembed %}

### 2.4.0 - 25.08.2024 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлен переключатель автоматической выдачи товаров из корзины, если игрок находится онлайн в момент обработки покупок. Также при включении данной опции покупки будут выданы автоматически при входе игрока на сервер.
* Добавлен функционал фильтрации товаров, которые проходят выдачу в обход корзины. Товары фильтруются по уникальным ID с панели управления, что дает возможность корректно обрабатывать, например, покупки "разбанов".
* Теперь по умолчанию, если плагин запускается впервые, корзина и автоматическая выдача будут включены.
* Добавлена поддержка ядра **Folia** с версии **1.20.2**. ([#10](https://github.com/EasyDonate/EasyPayments/issues/10))
* Изменена механика работы на **Paper 1.18.1** и новее. ([#16](https://github.com/EasyDonate/EasyPayments/issues/16))
* Изменена логика выдачи товаров, что может решить некоторые проблемы.
* Каждая итерация обработки покупок теперь атомарная - плагин не выключится до завершения обработки текущей итерации.
* Добавлена механика ведения собственного журнала событий в плагине. ([#18](https://github.com/EasyDonate/EasyPayments/issues/18))\
  Теперь плагин выводит всю отладочную информацию в файлы логов по пути `plugins/EasyPayments/logs/`.\
  Автоматическая очистка старых файлов производится по принципу времени их жизни - количества дней с момента создания файла, которое может быть ограничено опцией `log-file-time-to-life` в конфиге.
* Все файлы конфигурации теперь будут обновляться автоматически при изменении их композиции. ([#19](https://github.com/EasyDonate/EasyPayments/issues/19))
* Проект с исходным кодом плагина переведен на систему сборки Gradle. ([#17](https://github.com/EasyDonate/EasyPayments/issues/17))

О внутренних изменениях в механике работы плагина на **Paper 1.18.1+** и **Folia** читайте на [форуме](https://forum.easydonate.ru/d/117-mc-easypayments-alternativnyy-sposob-vydachi-tovarov/29).

{% embed url="<https://s3.easyx.ru/easydonate/resources/plugins/easypayments/2.4.0/EasyPayments-2.4.0.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.4.0
{% endembed %}

### 2.2.4 - 23.06.2024 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка версии игры **1.21**. *(NMS 1\_21\_R1).*
* Добавлена поддержка версий игры 1.20.5, 1.20.6. (NMS 1\_20\_R4).
* Внесено исправление временного характера для корректной работы плагина под Paper 1.20.5 и новее.
* Обновлен выводимый copyright при запуске плагина.

{% embed url="<https://s3.easyx.ru/easydonate/resources/plugins/easypayments/2.2.4/EasyPayments-2.2.4.jar>" %}
Прямая ссылка на качивание EasyPayments 2.2.4
{% endembed %}

### 2.2.2 - 03.01.2024 (НЕБЕЗОПАСНО)

**Список изменений:**

* Исправлена работа плагина на версиях игры **1.17.X**. *(NMS 1\_17\_R1)*
* Небольшие технические изменения, направленные на исправление проблемы.

{% embed url="<https://s3.easyx.ru/easydonate/resources/plugins/easypayments/2.2.2/EasyPayments-2.2.2.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.2.2
{% endembed %}

### 2.2.1 - 28.12.2023 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка версии игры **1.20.4**. *(NMS 1\_20\_R3).*

{% embed url="<https://s3.easyx.ru/easydonate/resources/plugins/easypayments/2.2.1/EasyPayments-2.2.1.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.2.1
{% endembed %}

### 2.2.0 - 21.11.2023 (НЕБЕЗОПАСНО)

{% hint style="warning" %}
Необходимо обновить файлы локализации, если вы обновляетесь до новой версии EasyPayments. Актуальные файлы локализации можно скачать [здесь](https://github.com/EasyDonate/EasyPayments/tree/main/plugin/src/main/resources/lang).

Скачайте файлы локализации и установите  в папку`/plugins/EasyPayments/lang` с заменой.
{% endhint %}

**Нововведения:**

* Добавлена команда `/cart clear [игрок]` для очистки корзины игрока.\
  Право на использование: `easypayments.command.clear` (для **Операторов**)\
  Право на очистку корзин других: `easypayments.command.clear.other` (для **Операторов**)
* Добавлена команда `/cart transfer <от кого> <ID платежа> <кому>` для передачи покупок в корзине.\
  При помощи аргументов `<от кого>` и `<кому>` можно определить, из чьей корзины покупки будут изъяты, и в чью корзину они будут добавлены.\
  Аргумент `<ID платежа>` (целое положительное число) соответствует реальному идентификатору платежа, который можно посмотреть в интерфейсе платформы EasyDonate.\
  Право на использование: `easypayments.command.transfer` (для **Операторов**)

**Изменения:**

* Теперь, если покупатель находится на сервере в момент добавления покупок в корзину, он также получит уведомление, как если бы он перезашёл на сервер после этого.

**Исправления:**

* Исправлена визуальная ошибка с аргументами некоторых команд в `/ep help`.

{% embed url="<https://s3.easyx.ru/easydonate/resources/plugins/easypayments/2.2.0/EasyPayments-2.2.0.jar>" fullWidth="false" %}
Прямая ссылка на скачивание EasyPayments 2.2.0
{% endembed %}

### 2.1.1 - 27.09.2023 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка версии игры **1.20.2**. *(NMS 1\_20\_R2).*

{% embed url="<https://s3.easyx.ru/easydonate/resources/plugins/easypayments/2.1.1/EasyPayments-2.1.1.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.1.1
{% endembed %}

### 2.1.0 - 12.06.2023 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка Minecraft 1.20.1.
* Другие мелкие технические изменения.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.1.0/EasyPayments-2.1.0.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.1.0
{% endembed %}

### 2.0.9 - 18.03.2023 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка Minecraft 1.19.4.
* Другие мелкие технические изменения.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.9/EasyPayments-2.0.9.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.9
{% endembed %}

### 2.0.8 - 01.01.2023 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка версии игры 1.19.3. (NMS 1\_19\_R2).
* Добавлено отображение версии плагина в /ep status.
* Исправление неожиданных ошибок в консоли.
* Другие мелкие технические изменения.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.8/EasyPayments-2.0.8.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.8
{% endembed %}

### 2.0.7 - 17.08.2022 (НЕБЕЗОПАСНО)

**Список изменений:**

* Улучшена обработка неожиданных ошибок при запросе новых платежей.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.7/EasyPayments-2.0.7.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.7
{% endembed %}

### 2.0.6 - 07.07.2022 (НЕБЕЗОПАСНО)

**Список изменений:**

* Улучшена обработка исключений при выполнении команд:\
  Теперь вместо большого `stack-trace` в консоли будет отображаться сообщение в **2 строки** и конечный `stack-trace`, содержащий информацию об ошибке, полезную для разработчика плагина, в котором и произошла данная ошибка.
* Изменена выводимая ссылка на документацию по `EasyPayments`.
* Исправлена небольшая опечатка в стандартном файле локализации плагина для русского языка.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.6/EasyPayments-2.0.6.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.6
{% endembed %}

### 2.0.5 - 08.06.2022 (НЕБЕЗОПАСНО)

**Список изменений:**

* Добавлена поддержка новейшей версии Minecraft 1.19 от 07.06.2022

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.5/EasyPayments-2.0.5.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.5
{% endembed %}

### 2.0.4 - 01.06.2022 (НЕБЕЗОПАСНО)

**Список изменений:**

* Фикс багов в предыдущей версии.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.4/EasyPayments-2.0.4.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.4
{% endembed %}

### 2.0.3 - 31.05.2022 (НЕБЕЗОПАСНО)

**Список изменений:**

* Исправлен баг, при котором платежи, ожидающие выдачи на игровом сервере, "зависали" на долгое время.
* Улучшена обработка возможных ошибок при работе с EasyPayments API. Описание доступно при активированном *debug* режиме.
* Оптимизирован механизм выполнения команд на игровом сервере при одновременной обработке двух и более ивентов.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.3/EasyPayments-2.0.3.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.3
{% endembed %}

### 2.0.2 - 15.03.2022 (НЕБЕЗОПАСНО)

#### **Список изменений:**

* Добавлена поддержка версии Minecraft 1.18.2.
* Добавлена обработка ошибки при использовании неподдерживаемой версии плагина.
* Исправлена обработка некоторых ошибок при работе с API.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.2/EasyPayments-2.0.2.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.2
{% endembed %}

### 2.0.1 - 25.02.2022 <mark style="background-color:blue;">Experimental</mark> (НЕБЕЗОПАСНО)

#### Список изменений:

* Исправлена проблема утечки памяти, связанной с неправильной работой планировщика задач.
* Изменена логика задачи опроса EasyPayments API для получения новых событий.
* Исправлена проблема с бесконечным созданием блокирующихся потоков.
* Уменьшено количество параллельных потоков, создаваемых плагином без необходимости.
* Изменен алгоритм синхронизации работы двух задач, выполняющих запросы к базе данных.
* Добавлено назначение своих имён для потоков, создаваемых плагином.
* Перезагрузка компонентов (`/ep reload`, `/ep setup`) теперь выполняется асинхронно.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.1/EasyPayments-2.0.1.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.1
{% endembed %}

### 2.0.0 - 23.02.2022 <mark style="background-color:red;">No longer supported</mark>

#### Список изменений?

* Уменьшена задержка на выдачу товаров на игровом сервере в 12 раз! Теперь задержка составляет до 5 секунд благодаря применению технологии LongPoll.
* Добавлена корзина для покупок ваших игроков, чтобы они могли забрать их в любое время.
* Добавлен режим интерактивной настройки плагина.
* Добавлена возможность перезагрузки плагина без необходимости перезагрузки игрового сервера.
* Добавлена поддержка событий повторения платежа, команд снятия и наград.
* Добавлена локализация и кастомизация всех выводимых сообщений.

#### Технические изменения

* Слияние двух модулей в один универсальный JAR. Теперь нет зависимости от версии Minecraft вашего игрового сервера.
* Переход на API v3.
* Использование EasyDonate4j SDK.
* Работа с базами данных с использованием ORMLite Framework.

{% embed url="<https://storage.easyx.ru/plugins/easydonate/easypayments/je/2.0.0/EasyPayments-2.0.0.jar>" %}
Прямая ссылка на скачивание EasyPayments 2.0.0
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://easypayments.easydonate.ru/version-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
