- Для версий
- 1.16.✘
- 1.17.✘
- 1.18.✘
- 1.19.✘
- 1.20.✘
- 1.21.✘
TotemPlugin — это плагин для серверов Minecraft версий
1.16–1.21 (Spigot/Paper), который добавляет в игру
летающие талисманы — маленькие головы, парящие рядом с игроком и дающие постоянные зелья эффекты.
🎯 Основные возможности
- Талисман отображается как голова (player head) на невидимом арморстанде, плавно следующем за игроком.
- У каждого талисмана может быть уникальная текстура головы (через base64 или ник скина).
- Талисманы дают пассивные зелья эффекты (сила, скорость, регенерация и т.д.).
- Вокруг талисмана можно включить частицы (огонь, души, криты и др.).
- При экипировке проигрывается звук (настраивается).
- Талисманы могут выполнять случайные анимации: покачивание, кружение, пружинистые рывки.
- Поддерживается несколько талисманов у одного игрока, но отображается всегда только один (остальные хранятся в инвентаре невидимо, их можно переключать).
- Данные сохраняются в playerdata.yml, автоматически загружаются при входе и сохраняются на выключении/по таймеру.
📦 Команды
Все команды используют базовый /totem (доступны алиасы /talisman, /тотем).
| Команда | Описание | Права |
|---|
| /totem give <ник> <id_талисмана> | Выдать талисман игроку. | totem.give |
| /totem take <ник> [id] | Забрать у игрока все талисманы или указанный. | totem.take |
| /totem on [ник] [id] | Показать указанный талисман (остальные скрываются). Если ник не указан – для себя. | totem.toggle (свой), totem.toggle.others (для другого) |
| /totem off [ник] [id] | Скрыть талисман(ы). Если указан id – только его, иначе – все. | те же |
| /totem list | Показать список всех зарегистрированных талисманов из config.yml. | totem.list |
| /totem info [ник] | Показать информацию о талисманах игрока (названия, видимость, эффекты). | totem.info |
| /totem reload | Перезагрузить конфигурацию (config.yml) и текстуры голов у уже существующих талисманов. | totem.reload |
| /totem help | Вывести справку по командам (зависит от прав игрока). | — |
🔐 Права (permissions)
| Право | Описание | По умолчанию |
|---|
| totem.give | Выдача талисмана | OP |
| totem.take | Изъятие талисмана | OP |
| totem.toggle | Включение/выключение отображения своего талисмана | Все |
| totem.toggle.others | Управление чужим талисманом | OP |
| totem.list | Просмотр списка талисманов | Все |
| totem.info | Просмотр информации о талисманах | Все |
| totem.reload | Перезагрузка конфигурации | OP |
| totem.admin | Объединяет все права (give, take, toggle.others, reload) | OP |
💡 Особенности реализации
- Талисман – это ArmorStand без гравитации, с головой в шлеме. Второй ArmorStand (маленький) – для отображения ника владельца.
- Позиция вычисляется динамически с учётом поворота игрока.
- Анимации реализованы через математические функции, настраиваются в конфиге.
- Поддержка glowing (свечение) и цветов свечения работает на Paper 1.16+.
- Плагин совместим с PlayerProfile API для текстур голов (работает на 1.20.4+). Для старых версий используется setOwningPlayer / setOwner.
📜 Примечания
- Плагин не требует сторонних библиотек (кроме Spigot API).
- Анимации и эффекты работают асинхронно, не нагружают сервер.
- При смерти игрока талисман пропадает, но восстанавливается после респавна.
- Если игрок телепортируется или меняет мир, талисман пересоздаётся на новой позиции.

2026-04-21_22.12.35.png 1 020,5 КБ · Просмотры: 46

2026-04-21_22.12.46.png 972,7 КБ · Просмотры: 46

2026-04-21_22.12.50.png 965,3 КБ · Просмотры: 39

2026-04-21_22.12.54.png 1 009,9 КБ · Просмотры: 46