SAMP/AddStaticVehicle

Материал из WiKiPi
(перенаправлено с «AddStaticVehicle»)

AddStaticVehicle

Описание:

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


Параметры:

(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2)


modelidID модели транспортного средства.
Float:spawn_xКоордината X спавна транспортного средства.
Float:spawn_yКоордината Y спавна транспортного средства.
Float:spawn_zКоордината Z спавна транспортного средства.
Float:z_angleУгол поворота вокруг оси Z транспортного средства при спавне.
color1ID первичного цвета.
color2ID вторичного цвета.


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

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


Wiki note.png

Примечание

Время респавна транспорта, создаваемого данной функцией - 120 секунд (2 минуты). Указать другое время или отключить респавн при создании транспорта можно с помощью функций AddStaticVehicleEx и CreateVehicle.

Wiki note important.png

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

Диапазон валидных ID транспорта от 1 до MAX_VEHICLES - 1.

Wiki removed.png

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

Сервер не респавнит поезда.

Wiki tip.png

Подсказка

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

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;
}


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

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