Плагин xAlmas для Minecraft: Экономика на душах в PvP
На многих Minecraft-серверах PvP-режим давно перестал быть просто развлечением — он превратился в полноценную экономическую систему. Плагин xAlmas предлагает свежий взгляд на награды за убийства: каждая победа приносит не абстрактные очки, а физический предмет — душу поверженного врага. Этот премиум-инструмент позволяет администраторам создавать многоуровневые валюты, настраивать визуальные эффекты и защищать сервер от накруток. Плагин оптимизирован для Paper 1.16.5 и выше, а его открытый API открывает дорогу для глубокой кастомизации.
Почему xAlmas выделяется среди аналогов
В отличие от стандартных плагинов наград, xAlmas превращает PvP в самостоятельную экономическую механику. Вы не ограничены одной валютой — можно создать десятки типов душ с уникальным дизайном, звуками и условиями выпадения. Гибкая система анти-фарма анализирует IP-адреса и задаёт персональные кулдауны, а поддержка HEX-цветов и MiniMessage делает каждый предмет визуально привлекательным. Плагин легко интегрируется с PlaceholderAPI и предоставляет разработчикам мощный API для расширения функционала.
Ключевые возможности
- Собственные предметы-души: Создавайте валюты из любых материалов — от стандартных красителей до кастомных голов с Base64. Настраивайте названия, описания, зачарования и скрытые флаги.
- Продвинутая анти-фарм система: Встроенная проверка IP-совпадений и настраиваемые кулдауны для каждого игрока предотвращают искусственное накручивание душ.
- Современное форматирование: Полная поддержка MiniMessage и HEX-цветов (&#HEX или <#HEX>) позволяет создавать стильные сообщения и предметы.
- Гибкая механика выпадения: Души могут сразу попадать в инвентарь убийцы или падать на землю. Доступен режим случайного дропа из вашего списка предметов.
- Чёрный/белый список миров: Отключайте выпадение душ в конкретных мирах — например, на спавне или в Энде.
- PlaceholderAPI: Используйте плейсхолдер %xa_almas% для отображения статистики на скорбордах или в кастомных меню.
- Настраиваемые звуки: Воспроизводите звуки с регулируемой громкостью и тоном при получении души.
- API для разработчиков: Мощный программный интерфейс с событиями позволяет сторонним плагинам взаимодействовать с экономикой душ.
Если вы ищете серверы с подобной уникальной системой или хотите быстро собрать собственный клиент с нужными модами, обратите внимание на лаунчер foxygame.net. Это удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню и без лишних хлопот подключиться к любому проекту.
Команды и разрешения
Управление плагином сосредоточено в одной базовой команде /xa с полной поддержкой Tab-Completer. Все административные действия требуют права xalmas.admin.
/xa help— отображает кастомное меню помощи./xa give <валюта> <количество>— выдаёт игроку указанное количество душ./xa reload— безопасно перезагружает config.yml, almas.yml и файлы данных.
Интеграция с PlaceholderAPI
Для работы плейсхолдера необходимо установить PlaceholderAPI. Используйте %xa_almas%, чтобы получить общее количество собранных игроком душ. Это идеальное решение для создания рейтингов PvP-игроков на сервере.
Пример настройки предмета в almas.yml
Конфигурация душ интуитивно понятна. Ниже показан пример премиум-головы с Base64, кастомным названием и скрытыми зачарованиями:
items:
alma_premium:
material: "PLAYER_HEAD"
base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGRjODgwNTNjMWE4NTNmNzE2NmM5ZTkzYmIzYzUxN2YwODE5NTQ0NzM5ZGJlYWJkNDhhODU5Y2VkNDIwYjcwYiJ9fX0="
name: "&#FACBCB☠ Premium Soul &#FACBCB&lF&#EED1D0&lA&#E2D8D5&lN&#D5DED9&lI&#C9E4DE&lA &#FACBCB♫"
lore:
- ""
- "&8 ℹ Information "
- ""
- "&f Exchange this rare coin for "
- "&f VIP rewards at spawn. "
- ""
- "&#FACBCB ▸ Special Edition! "
- ""
enchantments:
- "DURABILITY:3"
flags:
- "HIDE_ENCHANTS"Вы можете свободно менять материал, описание, зачарования и флаги. HEX-цвета задаются через &# или <#>, что открывает безграничные возможности для дизайна.
API для разработчиков
xAlmas создан с расчётом на расширяемость. Вы можете подключить его через JitPack и использовать события и методы для интеграции с другими плагинами.
Добавление зависимости
Добавьте репозиторий JitPack и зависимость в ваш проект (замените VERSION на актуальную, например, v1.0.1).
Gradle (Kotlin DSL):
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
compileOnly("com.github.WilfryDev:xAlmas:VERSION")
}Maven:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.WilfryDev</groupId>
<artifactId>xAlmas</artifactId>
<version>v1.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>События
PlayerReceiveSoulEvent вызывается непосредственно перед тем, как игрок получит душу за убийство. Вы можете отменить событие, динамически изменить тип души или получить информацию об убийце и жертве.
@EventHandler
public void onSoulReceive(PlayerReceiveSoulEvent event) {
if (event.getKiller().hasPermission("vip.doublesouls")) {
event.setSoulType("alma_premium");
}
}Методы API
Класс XAlmasAPI позволяет легко работать с данными игроков:
import jn.willfrydev.xalmas.api.XAlmasAPI;
int totalSouls = XAlmasAPI.getSouls(player.getUniqueId());
XAlmasAPI.addSouls(player.getUniqueId(), 5);
XAlmasAPI.removeSouls(player.getUniqueId(), 2);Заключение
Плагин xAlmas — это мощный и гибкий инструмент для создания уникальной PvP-экономики на вашем Minecraft-сервере. Богатые настройки предметов, надёжная защита от фарма, современная поддержка HEX-цветов и открытый API делают его идеальным выбором для администраторов, стремящихся выделиться. Благодаря простоте конфигурации и полной совместимости с Paper, вы сможете запустить систему душ за считанные минуты. А игроки оценят визуальную привлекательность и честную механику наград, которая превращает каждое сражение в захватывающее событие.