Локальный игрок и транспорт

Vector3 = { x = number, y = number, z = number }

Методы Handle вызываются через двоеточие. Handle нельзя сохранять после смерти, респавна, отключения или смены сессии.

samp.player.local_player()

Требует game.player.read. Возвращает nil, если игрок недоступен, иначе Player Handle с полями type="player", poolId, generation, sessionId.

Метод	Разрешение	Результат / диапазон
player:is_valid()	game.player.read	boolean, безопасен для устаревшего Handle.
player:position()	game.player.read	Vector3.
player:health()	game.player.read	number.
player:armor()	game.player.read	number.
player:velocity()	game.player.read	Vector3.
player:vehicle()	game.vehicle.read	Vehicle Handle или nil.
player:set_health(value)	game.player.write	Конечное 0..1000.
player:set_armor(value)	game.player.write	Конечное 0..1000.
player:set_position(vector)	game.player.write	Компоненты -100000..100000.
player:set_velocity(vector)	game.player.write	Компоненты -1000..1000.

Методы записи ничего не возвращают и разрешены только в управляемом callback: событии, таймере, задаче или callback меню. Они запрещены при вычислении entry. draw.hud является управляемым событием, но запись игрового состояния в этом горячем callback настоятельно не рекомендуется. Все методы, кроме is_valid(), дают ошибку для устаревшего Handle.

Vehicle Handle

player:vehicle() представляет только текущую машину локального игрока. Поля: type="vehicle", poolId, generation, sessionId. Handle устаревает при выходе/смене транспорта или поколения игрока.

Метод	Разрешение	Результат / диапазон
vehicle:is_valid()	game.vehicle.read	boolean.
vehicle:position()	game.vehicle.read	Vector3.
vehicle:health()	game.vehicle.read	number.
vehicle:velocity()	game.vehicle.read	Vector3.
vehicle:set_health(value)	game.vehicle.write	Конечное 0..10000.
vehicle:set_position(vector)	game.vehicle.write	Компоненты -100000..100000.
vehicle:set_velocity(vector)	game.vehicle.write	Компоненты -1000..1000.