- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
- 26
- Ядра и Прокси
- Bukkit
- Spigot
- Paper
- Минимальная версия Java
- 16
- Исходный код
- https://github.com/SuperCHIROK1/PlayerThemes
« PlayerThemes »
Самый функциональный, лучший плагин на персональное оформление для каждого игрока.
Как работает?
Самый функциональный, лучший плагин на персональное оформление для каждого игрока.
Как работает?
- Игрок использует команду /themes (или кастомную из конфига) и выбирает доступное ему оформление.
- Плагин сохраняет выбор в БД и сразу транслирует его через плейсхолдеры в ваш чат, таб или скорборд.
- При использовании сети серверов выбор темы моментально синхронизируется через Redis на всех секторах.
- При смене группы или истечении доната плагин сам автоматически сбросит тему на стандартную.
Особенности
- Поддержка MiniMessage (<цвет>)
- Поддержка SQLite и MySQL c гибкой настройкой пула соединений
- Синхронизация между серверами через Redis
- Установка нескольких значений на одну тему
- Специальные темы для донатеров с гибкой привязкой к правам
- Автоматический сброс темы на дефолтную при истечении доната или прав на тему.
- Расширенная кастомизация команд плагина: команда, алиасы, задержки.
- Система миграции данных со старой версии
Миграция
Миграция со старых версий (1.x -> 2.x)
Плагин поддерживает автоматический перенос данных из старого формата YAML в базы данных (SQLite / MySQL). Для корректного переноса выполните следующие шаги:
Готово! Все сохраненные данные игроков успешно перенесены в новую базу данных.
Плагин поддерживает автоматический перенос данных из старого формата YAML в базы данных (SQLite / MySQL). Для корректного переноса выполните следующие шаги:
- Выключите сервер. Скопируйте старую папку plugins/PlayerThemes в надежное место (чтобы сохранить темы из старого конфига и файл data.yml), после чего очистите исходную папку плагина.
- Загрузите новую версию плагина в папку plugins и запустите сервер для генерации обновленных конфигов.
- Скопируйте сохраненный файл data.yml в созданную папку plugins/PlayerThemes.
- Перенесите списки ваших тем из старого сохраненного конфига в новый config.yml.
- Выполните команду /pth migrate data data.yml в консоли или от имени администратора.
Готово! Все сохраненные данные игроков успешно перенесены в новую базу данных.
Конфигурация
You must be logged in to see this link.
You must be logged in to see this link.
YAML:
# Присоединяйтесь к нам в Discord-сервер: https://dsc.gg/amazingplugins
# Тип форматирования сообщений.
#: LEGACY - Классика (&a, &#rrggbb)
#: MINI_MESSAGE - <цвет> (1.18+)
# Подробнее о MiniMessage: https://docs.papermc.io/adventure/minimessage/format/
serializer: LEGACY
# Оповещать при выходе новых версий (рекомендуется)
notify-updates: true
# Настройки базы данных.
database-settings:
type: sqlite # sqlite / mysql
sqlite: # настройки только для sqlite
file-path: "data.db"
mysql: # настройки только для mysql
host: "127.0.0.1"
port: 3306
database: "playerthemes"
username: "root"
password: ""
# Параметры подключения к внешней базе данных.
# Лучше не изменяйте, если не разбираетесь в этом.
arguments: "?useSSL=false&autoReconnect=true&characterEncoding=utf8"
# Настройки пула HikariCP.
# Можете добавлять любые параметры, поддерживаемым им.
pool-settings:
maximum-pool-size: 10
connection-timeout: 5000
max-lifetime: 1800000
# Настройки Redis для мультисерверности.
# Используется в добавок с MySQL.
redis:
enabled: false
server-id: 'grief-1'
channel: 'playerthemes:sync'
connection:
host: "127.0.0.1"
port: 6379
username: ""
password: ""
database: 0
# Настройки команды выбора темы.
command-settings:
main-command: "themes"
aliases:
- "design"
- "customization"
- "custom"
select:
command-cooldown: 5000 # время кд в миллисекундах. чтобы отключить - установите значение 0
cooldown-bypass: true # байпас кд игрокам с правом playerthemes.cooldown.bypass
select-other:
command-cooldown: 0 # время кд в миллисекундах. чтобы отключить - установите значение 0
cooldown-bypass: true # байпас кд игрокам с правом playerthemes.cooldown.bypass
# Сообщения плагина.
messages:
prefix: "&6[★] &7»&f"
no-permission: "%prefix% У вас &cнет полномочий&f, чтобы &6выполнить&f данное действие."
only-players: "%prefix% Данную команду могут выполнять только игроки."
cooldown: "%prefix% Подождите &a%time% сек.&f перед &6следующим использованием&f команды."
admin:
reloaded: "%prefix% Плагин &aуспешно&f перезагружен!"
help: |-
&6[★] Помощь по Плагину:
&8- &e/pth reload &8» &7Перезагрузить плагин.
&8- &e/pth migrate data <файл> &8» &7Мигрировать данные с 1.x версий.
migration:
file-not-found: "%prefix% Файл &c%file% &fне найден в &6plugins/PlayerThemes&f."
success: "%prefix% Миграция данных &aпрошла&f успешно. Мигрировано &6%count% записей&f."
theme:
not-found: "%prefix% Тема &c%theme%&f не найдена."
no-permission: "%prefix% Вы &cне можете&f использовать тему &6%theme%&f."
installed: "%prefix% Вы &aуспешно&f установили тему оформления &6%theme%&f."
installed-player: "%prefix% Тема &a%theme%&f успешно установлена для игрока &6%player%&f."
reset-success: "%prefix% Ваше оформление было &aуспешно&f сброшено до &6стандартного&f."
reset-success-player: "%prefix% Оформление игрока &6%player%&f успешно сброшено."
help: |-
&6[★] Помощь по Кастомизации:
&8- &e/themes [тема] &8» &7Выбрать тему оформления.
&8- &e/themes reset &8» &7Сбросить текущую тему до стандартной.
config-version: 2 # Не изменяйте данный параметр!
YAML:
# Присоединяйтесь к нам в Discord-сервер: https://dsc.gg/amazingplugins
# ВАЖНЫЙ ПАРАМЕТР ДЛЯ ДОНАТ-ГРУПП.
# Режим проверки прав на тему оформления.
#: `true` - будет проверяться права ТОЛЬКО один раз при выборе темы.
# после выбора тема сохраняется и работает даже при отсутствии права.
#: `false` - будет проверяться права ПРИ КАЖДОМ ВЫЗОВЕ плейсхолдеров.
# идеально для временных привилегий: при истечении срока права
# выбранная тема игрока сразу переключается на дефолтную.
check-permission-only-on-select: false
default-theme: "gold" # дефолтная тема (если игрок не выбрал тему).
themes: # кастомные темы для выбора.
gold: # идентификатор темы (%pth_id%)
display-name: "Янтарный" # название темы (%pth_name%)
value: "&6" # основное значение темы (в большинстве случаев - главный цвет темы)
description: "Янтарный цвет" # описание темы (%pth_desc%)
permission: "playerthemes.gold" # не будет влиять, если эта тема установлена как дефолтная
values: # второстепенные значения темы (%pth_<ключ>%)
bossbar: "YELLOW" # %pth_bossbar%
glass_pane: "ORANGE_STAINED_GLASS_PANE" # %pth_glass_pane%
mm: "<gold>" # %pth_mm%
red:
display-name: "Красный"
value: "&c"
description: "Красный цвет"
permission: "playerthemes.red"
values:
bossbar: "RED"
glass_pane: "RED_STAINED_GLASS_PANE"
mm: "<red>"
green:
display-name: "Зеленый"
value: "&a"
description: "Зеленый цвет"
permission: "playerthemes.green"
values:
bossbar: "GREEN"
glass_pane: "GREEN_STAINED_GLASS_PANE"
mm: "<green>"
config-version: 2 # Не изменяйте данный параметр!
You must be logged in to see this link.
You must be logged in to see this link.
- Зависимости
- PlaceholderAPI
- Команды и права
- /themes <тема> <?игрок> - Выбрать тему (по умолчанию в конфиге)
- /pth reload - Перезагрузка плагина
- /pth migrate data <файл> - Миграция старых данных
- playerthemes.admin - Использование всех команд плагина.
- playerthemes.install - Установка темы.
- playerthemes.install.other - Установка темы другим игрокам
- playerthemes.cooldown.bypass - Игнорировать задержку для команд
- playerthemes.notify - Оповещать о выходе обновлений плагина
- %pth_id% - Идентификатор темы.
- %pth_name% - Название темы.
- %pth_value% - Цвета темы.
- %pth_description% - Описание темы
- %pth_permission% - Право для использования темы
- %pth_значение_id-темы% - Значение определенной темы
- %pth_ключ-значения% - Дополнительное значение темы.