Skip to content

pnClans v1.1.2 - Полное обновление: подсветка, очки, магазин, квесты, API 4

Choose a tag to compare

View all tags
@overdyn overdyn released this 10 Aug 13:14
· 8 commits to dev since this release
v1.1.2
2074c07

pnClans v1.1.2

Полное обновление после v1.0.6

Релиз собран для:

  • Paper API 1.21.11
  • Java 25
  • Paper 1.18+

Добавлено:

  • подсветка соклановцев;
  • клановые очки;
  • клановый магазин;
  • каталог квестов;
  • публичный API 4;
  • улучшенная персистентность данных.

Подсветка соклановцев

Добавлены два режима отображения:

  • ARMOR — виртуальная цветная броня поверх настоящей;
  • GLOW — светящийся контур вокруг соклановца.

Доступно 9 цветов:

AQUA, BLUE, DARK_AQUA, GREEN, RED, GOLD, YELLOW, LIGHT_PURPLE, WHITE.

Настройки доступны через меню клана:

  • выбор режима;
  • включение и выключение подсветки;
  • выбор цвета;
  • сброс настроек к стандартным.

Подсветка отображается только участникам одного клана.

Синхронизация выполняется при:

  • входе и выходе игрока;
  • возрождении;
  • смене мира;
  • создании и сохранении клана;
  • расформировании клана;
  • запуске сервера.

Реализация использует PacketEvents, встроенный в JAR с relocation. Ошибка подсветки не прерывает игровой процесс.

Новые права:

  • TOGGLE_COLOR;
  • TOGGLE_HIGHLIGHT_MODE.

Новая настройка:

clanHighlightColors:

Клановые очки

Добавлена новая валюта клана:

  • баланс Clan.points;
  • журнал операций pointsLogs;
  • дневной лимит активности.

Начисление очков

За убийства игроков:

clanPointsPerPlayerKill: 10

За убийства мобов:

clanPointsPerMobKill:
  ZOMBIE: 1
  SKELETON: 1
  CREEPER: 2
  SPIDER: 1
  WITHER: 50
  ENDER_DRAGON: 100

За активность участников:

  • 1 очко по умолчанию за 10 минут;
  • защита от AFK;
  • дневной лимит по умолчанию — 100 очков на клан.

Активностью считаются движение, чат, команды, взаимодействие и нанесение урона.

Состояние очков сохраняется между перезапусками.

Плейсхолдеры:

  • %pnclans_points%;
  • {clan_points}.

API очков:

  • ClanPoints.award();
  • ClanPoints.spend().

Источники операций: PLAYER_KILL, MOB_KILL, ACTIVITY, QUEST, SHOP, ADMIN.

Типы операций: AWARD, SPEND, ADMIN_ADJUSTMENT.

Клановый магазин

Добавлен новый раздел магазина в главном меню.

  • кнопка магазина — слот 30;
  • 6 рядов;
  • 21 слот товаров;
  • категории и сортировка настраиваются;
  • поддерживаются редкости товаров;
  • добавлена постраничная навигация;
  • отображаются балансы всех валют.

Файл конфигурации:

shop.yml

Версия схемы:

schemaVersion: 8

Стандартные категории: Все товары, Еда, Оружие, Ресурсы, Редкое.

Стандартные редкости: common, valuable, rare, legendary.

Условия покупки

Поддерживаются минимальный уровень клана, минимальное количество участников, необходимые квесты, дневной лимит клана и общий дневной лимит сервера.

Способы оплаты

  • CLAN_POINTS — очки казны клана;
  • VAULT — монеты игрока;
  • PLAYER_POINTS — бонусные очки игрока.

Перед покупкой проверяются актуальная цена, доступность валюты, разрешения игрока и ограничения товара.

После /clan reload старое окно покупки не позволит купить товар по устаревшей цене.

Награды

Поддерживаются:

  • !item_give;
  • !item_reward;
  • !console_command.

Плейсхолдеры наград: {player}, {player_name}, {product}, {quantity}, {clan}.

Предметы больше 64 единиц автоматически разбиваются на стаки. Если инвентарь заполнен, предметы выпадают рядом с игроком.

Если награда не может быть выдана, покупка отменяется, а средства возвращаются игроку.

Сообщения магазина

Поддерживаются success, insufficientFunds, currencyUnavailable, noPermission, shopChanged, requirementsNotMet, clanLimitReached, globalLimitReached, cancelled.

Квесты

Добавлена кнопка «Клановые квесты» в главном меню.

Файл конфигурации:

quests.yml

Типы целей:

  • PLAYER_KILL;
  • MOB_KILL;
  • ACTIVITY_INTERVAL.

Поддерживаются цели, фильтры мобов, условия, награды и предварительные требования.

Стандартные квесты:

  • «Охота на соперников» — 25 убийств игроков;
  • «Чистка территории» — 250 мобов;
  • «Активный клан» — 50 активных интервалов.

Quest engine пока не реализован. События ClanQuestProgressEvent и ClanQuestCompleteEvent ещё не вызываются. Товары с requiredQuests будут отклоняться.

Публичный API 4

Версия API:

PnClansProvider.API_VERSION = 4

Добавлены разделы api.points, api.operations и api.gui.

Новые операции клана:

  • changeRole;
  • transferLeadership;
  • changeSetting;
  • setHome;
  • deleteHome;
  • openChest.

Новые события:

  • ClanMemberJoinEvent;
  • ClanMemberLeaveEvent;
  • ClanMemberRoleChangeEvent;
  • ClanSettingChangeEvent;
  • ClanHomeSetEvent;
  • ClanHomeDeleteEvent;
  • ClanChestOpenEvent;
  • ClanTreasuryTransactionPreEvent;
  • ClanTreasuryTransactionEvent;
  • ClanShopPurchasePreEvent;
  • ClanShopPurchaseEvent;
  • ClanQuestProgressEvent;
  • ClanQuestCompleteEvent.

Новые типы: ClanPoints, ClanPointsTransaction, ClanPointsTransactionType, ClanPointsSource, ClanHighlightColor, ClanHighlightType, ClanShopCurrency, ClanOperationResult, ClanOperationRejection.

Аддоны, использующие API pnClans, необходимо перекомпилировать против API 4.

Исправления

  • исправлено сохранение убийств, смертей и игрового времени;
  • исправлено сохранение клановых очков и дневных лимитов;
  • восстановлена кнопка Зала славы;
  • исправлено пересечение слотов магазина и квестов;
  • исправлено исчезновение имени и lore у предметов;
  • исправлена подсветка GUI на Paper 1.21.11;
  • исправлена обработка кликов по инвентарю игрока;
  • награды больше не обрезаются размером одного стака;
  • исправлен возврат средств при ошибке выдачи награды;
  • исправлена покупка после /clan reload;
  • каталог магазина обновляется без повторного открытия меню.

Совместимость

  • Paper API 1.21.11;
  • Java 25;
  • Paper 1.18+;
  • api-version: 1.16.

PacketEvents встроен в JAR с relocation:

ua.inventorytype.pnclans.libs

Необязательные интеграции: Vault, PlaceholderAPI и PlayerPoints.

Миграция с v1.0.6

  1. Сделайте резервную копию папки plugins/pnClans/.
  2. Обновите Java до 25.
  3. Замените JAR на pnClans-1.1.2-all.jar.
  4. Перезапустите сервер.
  5. Проверьте созданные shop.yml и quests.yml.
  6. Если используется собственный menus.yml, добавьте mainMenu.items.shop и mainMenu.items.quests.
  7. Перекомпилируйте аддоны против API 4.
  8. Проверьте способы оплаты, награды и requiredQuests.

Важно

!console_command выполняется от имени консоли. Используйте такие команды только в доверенном shop.yml.

Серверы с другими плагинами подсветки, glow или scoreboard должны проверить совместимость.

Скачать

pnClans-1.1.2-all.jar

Paper 1.21.11 / Java 25

Assets 3
Loading