FrozenShards - плагин на виртуальную валюту осколков

FrozenShards - лёгкий плагин экономики для серверов на PaperMC, который добавляет в Майнкрафт отдельную виртуальную валюту - осколки (shards). Игроки получают их от администрации, переводят друг другу и тратят в полностью настраиваемом GUI-магазине. Если вам нужна вторая валюта на сервере - например, для донат-магазина, наград за ивенты или голосования - скачать плагин FrozenShards будет самым простым решением.

Зачем серверу вторая валюта

Почти на каждом выживании или мини-игровом проекте рано или поздно появляется проблема: основная экономика через Vault уже занята, а хочется выдавать игрокам что-то отдельное - за активность, за голосование, за победы в ивентах. Делать это деньгами опасно - экономику раздует. Вот тут и нужны осколки.

FrozenShards работает как независимая валюта, не привязанная к Vault. Админ выдаёт шарды командами, игроки копят их и тратят в магазине /shardshop. По факту это готовая система поощрений: настроил товары один раз в shardshop.yml - и дальше всё крутится само.

Что умеет плагин

• Выдача и изъятие осколков - как конкретному игроку, так и всем онлайн сразу (удобно для ивентов и компенсаций)
• Переводы между игроками - команда /payshards позволяет отправить свои осколки другому
• GUI-магазин - товары, цены и выполняемые команды настраиваются в shardshop.yml, можно продавать что угодно: от предметов до прав и китов
• Топ-10 богатейших игроков - готовые плейсхолдеры для скорборда и AJLeaderboards
• Форматирование баланса - большие числа автоматически сокращаются: 1250000 превратится в 1.25m

Важный нюанс: данные топа кэшируются каждые 60 секунд. Это сделано специально, чтобы обновление скорборда не грузило сервер. На практике - никаких просадок TPS даже при большом онлайне, чего не скажешь о многих самописных решениях.

Требования и установка

• PaperMC 1.20+ (поддерживаются версии Minecraft 1.20.x, 1.21 - 1.21.8 и новее)
• Java 17+
• PlaceholderAPI - обязательно, без него плейсхолдеры работать не будут
• AJLeaderboards - опционально, если хотите красивый топ на спавне

По ядрам совместимость шире заявленного минимума: плагин заводится на Paper, Purpur, Spigot, Bukkit и даже Folia. Но лучше всего держаться Paper - именно под него проект и писался.

Установка стандартная:

1. Убедитесь, что PlaceholderAPI уже стоит на сервере
2. Закиньте FrozenShards.jar в папку /plugins
3. Сделайте полный рестарт сервера - не /reload, а именно рестарт
4. Плагин сам создаст config.yml, data.yml и shardshop.yml
5. Откройте shardshop.yml и добавьте свои товары, цены и команды

Совет из практики: не ленитесь сразу настроить магазин под себя. Дефолтный конфиг - это скорее пример, и игроки быстро раскусят, что там "заглушка".

Команды

Команда	Описание	Право
/shards give <игрок> <кол-во>	Выдать осколки игроку	frozenshards.admin
/shards take <игрок> <кол-во>	Забрать осколки у игрока	frozenshards.admin
/shards giveall <кол-во>	Выдать всем онлайн	frozenshards.admin
/shards takeall <кол-во>	Забрать у всех онлайн	frozenshards.admin
/payshards <игрок> <кол-во>	Перевести свои осколки другому	-
/shardshop	Открыть магазин осколков	-

Команды giveall и takeall - реально удобная штука. Например, после глобального ивента можно одной строкой накинуть всем присутствующим по 500 шардов, без плагинов на китайские грамоты и консольных костылей.

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

Баланс игрока

Плейсхолдер	Пример вывода
%frozenshards_value%	1250000
%frozenshards_value_formatted%	1.25m

Форматированный вариант сам сокращает числа: 1000 в 1k, 25040 в 25.04k, 789000 в 789k, 6000000 в 6m, 1000000000 в 1b. Для TAB-листа и скорборда - то что надо, длинные цифры никуда не вылезут.

Топ игроков - ники

Плейсхолдер	Пример вывода
%frozenshards_top1_player%	DrFrozen
%frozenshards_top2_player%	Steve
%frozenshards_top3_player% до %frozenshards_top10_player%	...

Топ игроков - количество осколков

Плейсхолдер	Пример вывода
%frozenshards_top1_value%	4800000
%frozenshards_top2_value%	3120000
%frozenshards_top3_value% до %frozenshards_top10_value%	...

Пример оформления топа для AJLeaderboards или скорборда:

#1  %frozenshards_top1_player%  -  %frozenshards_top1_value% осколков
#2  %frozenshards_top2_player%  -  %frozenshards_top2_value% осколков
#3  %frozenshards_top3_player%  -  %frozenshards_top3_value% осколков

Ваш баланс: %frozenshards_value_formatted%

Кому подойдёт

FrozenShards - must-have, если вы собираете сервер с донат- или ивент-валютой и не хотите городить огород из Skript'ов и самописных решений. Плагин лёгкий, ничего лишнего не тащит, топ кэшируется, а магазин настраивается за десять минут. На слабом железе и при большом онлайне проблем быть не должно.

Плагин спокойно заработает на BungeeHost (https://bungee.host) - ставится в один клик, а Paper 1.20+ с Java 17 там доступен из коробки. Если хотите поиграть с друзьями на своём сервере Майнкрафт с полноценной экономикой осколков - это самый быстрый путь.

Скачать FrozenShards стоит и тем, кто просто ищет замену раздутым экономическим плагинам: здесь всё по делу - выдача, переводы, магазин и топ. Ничего лишнего.