Text Placeholder API Expressions
Активный0.0
Установок
Последнее обновление
Версии
Text Placeholder API Expressions
Это расширение для Text Placeholder API добавляет мощные возможности работы с математическими выражениями, условными операторами и манипуляциями со строками прямо в плейсхолдерах Minecraft.
Использование плейсхолдеров в выражениях
Расширение поддерживает синтаксис ${категория:плейсхолдер}
для использования числовых значений из других плейсхолдеров в вычислениях. Например, чтобы отобразить здоровье игрока в процентах (например, в списке игроков), можно использовать:
%expr:math ${player:health} 100 / ${player:max_health}%
Математические плейсхолдеры
Основной функционал расширения доступен через плейсхолдер expr:math
, который работает с тремя типами элементов:
- Компоненты: числа, функции, константы и плейсхолдеры, возвращающие числовые значения
- Бинарные операторы: применяются между двумя компонентами (сложение, вычитание и т.д.)
- Унарные операторы: применяются к одному компоненту (отрицание, факториал)
Операторы и функции
Бинарные операторы:
+
- сложение:%expr:math 2 + 2%
→ 4-
- вычитание:%expr:math 4 - 1%
→ 3- умножение:
%expr:math 3 3%
→ 9/
- деление:%expr:math 9 / 4%
→ 2.25^
- возведение в степень:%expr:math 3 ^ 3%
→ 27
Унарные операторы:
-
- отрицание:%expr:math 1 + -1%
→ 0!
- факториал:%expr:math 5!%
→ 120
Математические функции:
mod(7, 2)
→ 1 (остаток от деления)abs(-10)
→ 10 (модуль)sqrt(34)
→ 5.8309 (квадратный корень)sin(rad(30))
→ 0.4999 (синус)ceil(0.4)
→ 1 (округление вверх)min(1, 0.3, 7)
→ 0.3 (минимальное значение)avg(1, 0.3, 7)
→ 2.7666 (среднее значение)
Константы:
PI
- число πe
- число Эйлера
Условные плейсхолдеры
Аргументы для этих плейсхолдеров разделяются точкой с запятой (;
).
%expr:ifeq%
Проверяет равенство значений a
и b
, возвращая c
или d
в зависимости от результата.
%expr:ifeq aIsMath a bIsMath b cIsMath c dIsMath d%
Пример:
Player %expr:ifeq false; ${player:equipment_slot mainhand}; false; Diamond Sword; false; is; false; is not% holding a Diamond Sword.
%expr:iflt%
Проверяет, меньше ли a
чем b
, возвращая соответствующий результат.
%expr:iflt a b cIsMath c dIsMath d%
Пример:
Player is in %expr:iflt ${player:health}; 14; false; poor; false; good% health
%expr:ifgt%
Проверяет, больше ли a
чем b
, возвращая соответствующий результат.
%expr:ifgt a b cIsMath c dIsMath d%
Пример:
Health: %expr:ifgt ${player:health}; 4; true; ${player:health} 100 / ${player:max_health}%; false; Nearly dead!%
Строковые плейсхолдеры
Функции дополнения строк
%expr:pad%
, %expr:padleft%
, %expr:padright%
- дополняют строку str
символом c
до указанной длины.
Пример:
%expr:padleft 2 ${server:online} 0% / %server:max_players%
Функции соответствия длины
%expr:padmatch%
, %expr:padmatchleft%
, %expr:padmatchright%
- дополняют строку str
до длины строки match
.
Пример:
%expr:padmatchleft ${server:max_players} ${server:online} 0% / %server:max_players%