Плагин DateTimeUtils Expansion - заполнитель для papi 2.1

DateTimeUtils - Expansion — Small Caps, русские даты и удобное форматирование

Часто вижу, как админы ломают голову над красивым оформлением серверов. Делать обязательный ресурспак ради пары красивых менюшек — сомнительное удовольствие, а дефолтный майнкрафтовский шрифт выглядит слишком просто.

Поэтому решил обновить свой Expansion для PlaceholderAPI. Изначально он просто выводил дату и время на русском, но со временем превратился в удобную утилиту для оформления сервера: Small Caps для текста и плейсхолдеров, русские даты, часовые пояса и произвольное форматирование времени.

Идеально подходит для Scoreboard, TAB, голограмм, меню и других мест, где хочется аккуратного оформления без ресурспака.

Главные фичи:

• Магия Small Caps: можно обернуть практически любой текст или чужой плейсхолдер и получить красивое оформление.
• Нормальные даты и время: русские названия месяцев и дней недели, отдельные плейсхолдеры для даты, времени и их частей.
• Часовые пояса: можно задать основной часовой пояс в конфиге или указать его прямо в плейсхолдере.
• Произвольный формат: используйте любой формат DateTimeFormatter, если стандартных вариантов недостаточно.
• Цвета и MiniMessage: форматирование текста не должно ломать цветовые коды, HEX, MiniMessage и другие плейсхолдеры.

You must be logged in to see this link. Как это использовать (Плейсхолдеры)

1. Работа с текстом и чужими плейсхолдерами

(Важно: чужие плейсхолдеры внутри нашего можно оборачивать в фигурные скобки {})

• %datetimeutils_caps_Привет, сервер!% ➔ пᴘиʙᴇᴛ, ᴄᴇᴘʙᴇᴘ!
• %datetimeutils_caps_Игрок: {player_name}% ➔ иᴦᴘᴏᴋ: sᴛᴇvᴇ
• %datetimeutils_caps_Баланс: {vault_eco_balance}% ➔ бᴀлᴀʜᴄ: 1000

Также можно передавать обычные PAPI-плейсхолдеры напрямую:

• %datetimeutils_caps_%player_name%%
• %datetimeutils_caps_%vault_eco_balance%%

2. Работа со временем

• %datetimeutils_now% — текущее время по дефолтному формату из конфига.
• %datetimeutils_time% — только время.
• %datetimeutils_date% — только дата.
• %datetimeutils_datetime% — дата и время по дефолтному формату.
• %datetimeutils_day% — день месяца.
• %datetimeutils_month% — номер месяца.
• %datetimeutils_year% — год.
• %datetimeutils_weekday% — день недели.
• %datetimeutils_weekday_ru% — день недели на русском.
• %datetimeutils_month_ru% — название месяца на русском.

3. Свой формат

- %datetimeutils_format_<ваш_формат>% — время в вашем формате.

* %datetimeutils_format_HH:mm% ➔ 15:30
* %datetimeutils_format_dd MMMM% ➔ 19 ȹᴇʙᴘᴀля
* %datetimeutils_format_EEEE% ➔ пᴏʜᴇдᴇльʜиᴋ

Можно сразу указать нужный часовой пояс:

• %datetimeutils_format@Europe/London@HH:mm%
• %datetimeutils_format@Asia/Tokyo@dd.MM.yyyy HH:mm%

Также часовой пояс можно указать для стандартных плейсхолдеров:

• %datetimeutils_time_Europe/London%
• %datetimeutils_date_Asia/Tokyo%
• %datetimeutils_weekday_ru_Europe/London%

You must be logged in to see this link. Установка

1. Кидаем скачанный .jar в /plugins/PlaceholderAPI/expansions/
2. Прописываем /papi reload
3. Идем в plugins/PlaceholderAPI/config.yml — там появится секция datetimeutils.
4. Настраиваем свой часовой пояс, формат по умолчанию и нужные параметры.
5. Готово. Пользуемся.

(P.S. В расширении есть защита от неправильных форматов. Если случайно ошибиться в DateTimeFormatter, вместо спама ошибками будет выведено аккуратное сообщение из конфига.)