SAMP/CreateVehicle

Материал из WiKiPi

CreateVehicle

Wiki added.png

Добавлено

Параметр addsiren работает только начиная с версии SA-MP 0.3.7 и не будет работать в предыдущих версиях!


Описание:

Добавляет на сервер «динамическое» транспортное средство (возможно создать прямо из игры, например, админкой).​


Параметры:

(vehicletype, Float:x, Float:y, Float:z, Float:rotation, color1, color2, respawn_delay, addsiren = 0)


vehicletypeID модели транспортного средства.
Float:xКоордината X спавна транспортного средства.
Float:yКоордината Y спавна транспортного средства.
Float:zКоордината Z спавна транспортного средства.
Float:rotationУгол поворота вокруг оси Z транспортного средства при спавне.
color1ID первичного цвета.
color2ID вторичного цвета.
respawn_delayвремя в секундах по истечении которого транспорт без водителя будет зареспавнен.Using -1 will prevent the vehicle from respawning.
addsirenуказывает на то, что транспортное средство имеет сирену (как машина полиции, например).


Возвращаемые значения:

vehicleid: ID созданного транспорта.

INVALID_VEHICLE_ID (65535): если не удалось создать транспорт (достигнут лимит транспорта или указана неверная модель).

0: если не удалось создать транспорт (например, поезда).


Wiki note important.png

Важное
примечание

Диапазон валидных ID транспорта от 1 до MAX_VEHICLES - 1.
Минимальное время респавна - 10 секунд. Сервер не будет респавнить транспорт чаще, даже если указать в respawn_delay значение меньше 10.


Wiki removed.png

Предупреждение

Поезда (ID моделей 537 и 538) создаются только с помощью функций AddStaticVehicle или AddStaticVehicleEx. При попытке их создания с помощью рассматриваемой функции, в лог будет выведено предупреждение, и поезд создан не будет.


Wiki tip.png

Подсказка

Для случайного цвета транспорта (меняется после каждого выхода из зоны стрима), необходимо указывать -1 в параметрах color1 и/или color2, в зависимости от задачи.
Указав параметру respawn_delay значение -1 можно запретить транспорту респавниться по истечении какого-либо времени.


Wiki bug.png

Баг SA-MP

Только транспорт с цветом -1 может быть покрашен в Pay'n'Spray. Однако цвет всё равно меняется при выходе из зоны стрима.
В файле a_samp.inc константа MAX_VEHICLES объявлена как 2000, однако на сервере можно создать только до 1999 машин (с ID от 1 до 1999).

Пример использования:

public OnGameModeInit()
{
	// Добавляет истребитель Hydra (520) в игру со временем респавна в 60 секунд
	CreateVehicle(520, 2109.1763, 1503.0453, 32.2887, 82.2873, -1, -1, 60);
	return 1;
}


Связанные функции

Следующие функции также могут быть полезны, поскольку они так или иначе связаны с рассматриваемой функцией.
  • AddStaticVehicle - добавляет статическое транспортное средство.
  • AddStaticVehicleEx - добавляет статическое транспортное средство с настраиваемым временем респавна.
  • DestroyVehicle - уничтожает транспортное средство.