Onioning API

# Changelog ## 🆕 New pointers - **`eget{point_name}`** — extracts a UUID from a saved variable. Works like `get`, but returns a UUID instead of coordinates. Used as a text selector for `kill`, `tp`, etc. ## ✏️ Changes to existing pointers - **`elook{@s}[nick]`** — added the `[nick]` modifier. Without it, behavior is unchanged (returns the UUID of the first entity hit); with it, returns the player's nickname if a player was hit, otherwise the UUID of a non-player entity. ## 🧮 New math functions **Vector arithmetic:** - `add{a}{b}` — component-wise sum - `sub{a}{b}` — subtraction - `mul{a}{b}` — component-wise multiplication - `div{a}{b}` — component-wise division (zero divisor → 0) **Angles:** - `face{a}{b}` → `yaw pitch` from A to B - `yaw{a}{b}` → yaw only - `pitch{a}{b}` → pitch only **Random vectors:** - `rUnit[scale]` — random unit vector on the sphere (uniform), multiplied by `scale` - `rCone{axis}[angle]` — random vector inside a cone (cosine-weighted by solid angle) - `rRing{center}[radius]` — random point on a horizontal ring **Offsets:** - `bodyOffset{base}{dir}[right up forward]` — offset in a horizontal frame - `localOffset{base}{dir}[right up forward]` — offset in a full 3D frame relative to `dir` **World functions:** - `under{base}` — same XZ, but Y = surface height (Heightmap MOTION_BLOCKING) - `hit{a}{b}` — raycast between two points, returns the hit point (block or entity — whichever is closer) ## 🔁 New parser features **Loops:** - `[N]` — repeat N times with no delay - `[N:delay]` — repeat N times with delay between iterations **Loop variables:** - `t{}` — progress 0.0..1.0 - `i{}` — current index - `n{}` — total iterations - `t{1}`, `i{1}`, `n{1}` — access the outer loop for nested constructs ## ⚠️ Error handling - **`nothing`** — the miss marker. If any function returns `nothing`, the whole expression collapses to `nothing`, and the command is not executed (if the final string contains a `nothing` token). This lets you write safe chains that don't break on missing targets. --- # Список изменений ## 🆕 Новые указатели - **`eget{имя_точки}`** — достаёт UUID из сохранённой переменной. Работает как `get`, но возвращает UUID вместо координат. Используется как текстовый селектор для `kill`, `tp` и т.д. ## ✏️ Изменения в существующих указателях - **`elook{@s}[nick]`** — добавлен модификатор `[nick]`. Без него поведение прежнее (возвращает UUID первой попавшейся сущности), с ним — ник игрока, если попали в игрока, иначе UUID не-игрока. ## 🧮 Новые математические функции **Арифметика векторов:** - `add{a}{b}` — покомпонентное сложение - `sub{a}{b}` — вычитание - `mul{a}{b}` — покомпонентное умножение - `div{a}{b}` — покомпонентное деление (делитель 0 → 0) **Углы:** - `face{a}{b}` → `yaw pitch` от A к B - `yaw{a}{b}` → только yaw - `pitch{a}{b}` → только pitch **Случайные вектора:** - `rUnit[scale]` — случайный единичный вектор на сфере (равномерное распределение), умноженный на `scale` - `rCone{ось}[угол]` — случайный вектор внутри конуса (косинусное распределение по телесному углу) - `rRing{центр}[радиус]` — случайная точка на горизонтальном кольце **Смещения:** - `bodyOffset{база}{направление}[right up forward]` — смещение в горизонтальной системе координат - `localOffset{база}{направление}[right up forward]` — смещение в полной 3D-системе относительно направления **Мировые функции:** - `under{база}` — та же XZ, но Y = высота поверхности (Heightmap MOTION_BLOCKING) - `hit{a}{b}` — рейкаст между двумя точками, возвращает точку попадания (в блок или сущность — что ближе) ## 🔁 Новые возможности парсера **Циклы:** - `[N]` — повторить N раз без задержки - `[N:delay]` — повторить N раз с задержкой между итерациями **Переменные цикла:** - `t{}` — прогресс 0.0..1.0 - `i{}` — текущий индекс - `n{}` — всего итераций - `t{1}`, `i{1}`, `n{1}` — обращение к внешнему циклу для вложенных конструкций ## ⚠️ Обработка ошибок - **`nothing`** — маркер промаха. Если любая функция вернула `nothing`, всё выражение сворачивается в `nothing`, а команда не выполняется (если в итоговой строке есть токен `nothing`). Это позволяет писать безопасные цепочки без обрыва на несуществующих целях.