player

Локальный игрок: состояние, показатели, инвентарь и действия от его имени.

Разбор с примерами — Инвентарь и действия.

Положение и взгляд

player.exists() -> bool

player.pos() -> x, y, z

player.eye_pos() -> x, y, z

player.block_pos() -> x, y, z

Координаты блока под ногами, целые числа

player.distance_to(x, y, z) -> number

Расстояние от ног игрока до точки

player.rotation() -> yaw, pitch

Реальный поворот камеры, без учёта client.silent

player.body_rotation() -> bodyYaw, headYaw

player.look_vector() -> x, y, z

Единичный вектор взгляда

player.velocity() -> vx, vy, vz

player.speed() -> number

Горизонтальная скорость в блоках/сек

player.on_ground() -> bool

player.collision() -> table

horizontal (упёрся в стену), vertical, climbing, riding

Показатели

player.name() -> string

player.uuid() -> string

player.gamemode() -> string

survival, creative, adventure или spectator

player.alive() -> boolean

player.health() -> number

player.max_health() -> number

Максимум здоровья с учётом атрибутов

player.absorption() -> number

player.armor() -> number

player.food() -> number

player.saturation() -> number

Насыщение: пока оно выше нуля, голод не падает

player.xp() -> { level, progress, total }

Уровень, заполнение полоски 0..1 и весь опыт

player.air() -> air, max_air

Запас воздуха под водой в тиках

player.hurt_time() -> number

Тики красной вспышки после урона, 10 → 0

player.fire_ticks() -> number

Сколько ещё гореть, в тиках

player.frozen_ticks() -> number

Заморозка в рыхлом снегу

player.state() -> table

sneaking, sprinting, using_item, gliding, in_water, in_lava, on_fire, swimming, creative, flying, fall_distance

player.effects() -> { {id, amplifier, level, duration} }

Бой

player.attack_cooldown([delta=0.5]) -> number

Заряд удара 0..1. От 0.9 удар считается полным и критует в падении

player.reach() -> entity, block

Дистанция досягаемости до сущностей и до блоков

player.using() -> table

Использование предмета: active, hand, ticks, ticks_left, blocking, item

player.cooldowns() -> table

Предметы на перезарядке: поля предмета плюс progress, ticks, seconds

Инвентарь: чтение

player.hotbar_slot() -> 0..8

player.held_item([hand="main"|"off"]) -> table

player.armor_items() -> table

Четыре слота брони сверху вниз

player.hotbar() -> table

Девять слотов хотбара, slot — номер 0–8 (для select_slot, не для кликов)

player.inventory() -> { item }

Непустые слоты текущего контейнера. У предмета есть slot (id для кликов), player, index и hotbar (0–8 или nil)

player.slot(slotId) -> item | nil

Содержимое одного слота текущего контейнера, включая пустой

player.find_item(itemId) -> slot, hotbar | nil

Ищет предмет в открытом контейнере. Слот хотбара в приоритете: тогда вторым значением приходит его номер 0–8

player.count_item(itemId) -> number

player.container() -> table

open, title, sync_id, size, container_size, cursor — что сейчас открыто

Инвентарь: действия

player.select_slot(0..8) -> boolean

Переключает активный слот хотбара, как колесо мыши

player.swap_slot(slotId, hotbar) -> boolean

Меняет слот контейнера со слотом хотбара 0–8 или левой рукой (40). Работает без открытого инвентаря

player.quick_move(slotId) -> boolean

Shift-клик: перекидывает стак между контейнером и инвентарём

player.drop_slot(slotId, [all=false]) -> boolean

Выбрасывает один предмет или весь стак (all = true)

player.drop_held([all=false]) -> boolean

Q: выбросить предмет из руки, all = весь стак

player.click_slot(slotId, [button=0], [action="pickup"]) -> boolean

Сырой клик: pickup, quick_move, swap, clone, throw, quick_craft, pickup_all. slotId -999 — клик мимо окна

player.close_screen()

Закрывает открытый контейнер с уведомлением сервера

Движение и управление

player.set_key(name, pressed)

forward, back, left, right, jump, sneak, sprint, use, attack. Отпускается автоматически при выключении скрипта

player.jump() -> boolean

Прыжок, только с земли

player.set_sprinting([on=true])

Включает или гасит спринт

player.set_rotation(yaw, pitch)

Поворачивает камеру по-настоящему. Для незаметного поворота — client.silent.set

player.set_velocity(x, y, z)

Задаёт скорость в блоках за тик. Серверный античит это видит

player.stop_using()

Отпустить лук, щит, еду — отправляет пакет серверу

player.respawn() -> boolean

Возродиться после смерти. false, если игрок жив

Чат

player.send_chat(text)

player.send_command(cmd) — без слеша

← Назадevents Дальше →aura