SAMP/AddStaticVehicleEx

Материал из Wiki.Pawno-Info.Ru
Перейти к навигации Перейти к поиску

AddStaticVehicleEx

Wiki added.png

Добавлено

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


Описание:

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


Параметры:

(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2, respawn_delay, addsiren = 0)


modelidID модели транспортного средства.
Float:spawn_xКоордината X спавна транспортного средства.
Float:spawn_yКоордината Y спавна транспортного средства.
Float:spawn_zКоордината Z спавна транспортного средства.
Float:z_angleУгол поворота вокруг оси Z транспортного средства при спавне.
color1ID первичного цвета.
color2ID вторичного цвета.
respawn_delayвремя в секундах по истечении которого транспортное средство без водителя будет пересоздано.
addsirenуказывает на то, что транспортное средство имеет сирену (как машина полиции, например).


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

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


Wiki note important.png

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

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


Wiki removed.png

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

Сервер не респавнит поезда. Время, указанное в параметре respawn_delay, игнорируется как для локомотива, так и для вагонов поезда.


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).

По непонятным причинам в SA-MP сделали две функции:

native AddStaticVehicle(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2);
native AddStaticVehicleEx(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2, respawn_delay);

в то время, как можно было всего лишь сделать параметр respawn_delay опциональным:

native AddStaticVehicle(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2, respawn_delay = 120);

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

public OnGameModeInit() 
{ 
	// Добавляем Гидру в игру 
	AddStaticVehicle(520, 2109.1763, 1503.0453, 32.2887, 82.2873, 0, 1);
	return 1;
}


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

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