RU/Resource:Realdriveby

Вступление

RealDriveby - полностью настраиваемый ресурс, предоставляющий гибкую систему driveby (драйвбаев) для вашего сервера.

Все совместимые с драйвбаем оружия GTA, включая дробовики, пистолеты, M4 и AK-47 поддерживаются и данным ресурсом. Задержка между выстрелами для такого оружия, как пистолеты, доведена до нормальной.

По умолчанию пользователи могут переключаться между оружием по клавишам "Vehicle Look Left" и "Vehicle Look Right" в режиме драйвбая.

Как бы то ни было, все это идет на усмотрение админа: используя систему настроек MTA, задержки между выстрелами можно отрегулировать; доступность оружия для драйвбая водителю можно задать; доступность оружия для драйвбая пассажирам тоже можно задать.

Доступно две опции для отключения драйвбая - только на время руления или полное отключение, но настроить это можно отдельно для разных транспортных средств.

К тому же, RealDriveby предоставляет функции для скриптинга на клиентской стороне, так что атрибуты могут меняться в зависимости от игрока, позволяя разным игрокам давать возможности стрелять с разными видами оружия и задержками.

Настройки

Все настройки могут быть изменены через MTA'шные функции set(), изменение meta.xml ресурса или изменение settings.xml.

Оружие водителя

• Название настройки: driveby_driver
• Описание: Задает оружия, с которых может стрелять водитель. Чтобы полностью отключить ему возможность к драйвбаю, просто оставьте таблицу пустой. См. здесь совместимые виды оружия.
• XML-образец:

  <setting name="driveby_driver" value="[[ 22,23,24,26,28,29,32 ]]"/>

Оружие пассажиров

• Название настройки: driveby_passenger
• Описание: Задает оружия, с которых могут стрелять пассажиры. Чтобы полностью отключить им возможность к драйвбаю, просто оставьте таблицу пустой. См. здесь совместимые виды оружия.
• XML-образец:

  <setting name="driveby_passenger" value="[[ 22,23,24,25,26,28,29,32,30,31,33 ]]"/>

Задержка между выстрелами

• Название настройки: driveby_shot_delay
• Описание: Задает задержку между выстрелами отдельно для каждого из указанных оружий. Неуказанные оружия будут иметь GTA'шную задержку по умолчанию. Задается в формате таблицы, где ключ - строка с ID оружия, а значение - задержка в миллисекундах.
• XML-образец:

  <setting name="driveby_shot_delay" value="[{ '22':300,'23':300,'24':800,'26':700 }]"/>

Заблокированный транспорт

• Название настройки: driveby_blocked_vehicles
• Описание: Задает транспортные средства, в которых режим драйвбая недоступен. Полезен для блокировки таких странностей, как драйвбай из танка. В формате массива из ID транспортных средств.
• XML-образец:

  <setting name="driveby_blocked_vehicles" value="[[ 432,601,437,431,592,553,577,488,497,548,563,512,476,447,425,519,520,460,417,469,487,513,441,464,501,465,564,538,449,537,539,570472,473,493,595,484,430,453,452,446,454,606,591,607,611,610,590,569,611,435,608,584,450 ]]"/>

Руление авто во время драйвбая

• Название настройки: driveby_steer_cars
• Описание: Задает возможность водителю рулить вправо/влево в режиме драйвбая для транспорта помимо двухколесного транспорта. Формат - булевая переменная, где true дает возможность полноценно рулить.
• XML-образец:

  <setting name="driveby_steer_cars" value="[true]"/>

Руление двухколесным транспортом во время драйвбая

• Название настройки: driveby_steer_bikes
• Описание: Задает возможность водителю двухколесного транспортного средства рулить вправо/влево в режиме драйвбая. Если false, это придает больше реализма. Формат - булевая переменная, где true дает возможность полноценно рулить.
• XML-образец:

  <setting name="driveby_steer_bikes" value="[true]"/>

Авто-оснащение оружием для драйвбая

• Название настройки: driveby_auto_equip
• Описание: Задает возможность включения драйвбай-режима сразу при посадке игрока в транспорт.
• XML Example:

  <setting name="driveby_auto_equip" value="[false]"/>

Клавиша переключения в режим драйвбая

• Название настройки: driveby_toggle_mode
• Описание: Задает клавишу, которая будет использоваться в качестве переключателя в драйвбай-режим.
• XML-образец:

  <setting name="driveby_toggle_mode" value="mouse2"/>

Клавиша переключения на следующее оружие для драйвбая

• Название настройки: driveby_next_weapon
• Описание: Задает клавишу, которая будет использоваться для переключения на следующее оружие (если таковое есть).
• XML-образец:

  <setting name="driveby_next_weapon" value="vehicle_look_right"/>

Клавиша переключения на предыдущее оружие для драйвбая

• Название настройки: driveby_prev_weapon
• Описание: Задает клавишу, которая будет использоваться для переключения на следующее оружие (если таковое есть).
• XML-образец:

  <setting name="driveby_prev_weapon" value="vehicle_look_left"/>

Функции скриптинга

Все функции скриптинга - клиентские, так что будут затрагивать только local player (локального игрока). Все функции должны вызываться через функцию call, напр.

call(getResourceFromName("realdriveby"),"setWeaponShotDelay",22,300)

setDriverDrivebyAbility

Эта функция позволяет задавать оружия, которые будут доступны для драйвбая local player, если он управляет транспортом.

bool setDriverDrivebyAbility ( table weapons )

• weapons: Массив/таблица, содержащая ID оружия, которые могут использоваться для драйвбая водителем. См. здесь совместимые виды оружия.

getDriverDrivebyAbility

Эта функция позволяет вам запрашивать, какие оружия local player может использовать для драйвбая, если он управляет транспортом.

table getDriverDrivebyAbility ()

Возвращает таблицу оружий, которые водитель может использовать для драйвбая.

setPassengerDrivebyAbility

Эта функция позволяет задавать оружия, которые будут доступны для драйвбая local player, если он - пассажир.

bool setPassengerDrivebyAbility ( table weapons )

• weapons: Массив/таблица, содержащая ID оружия, которые могут использоваться для драйвбая пассажиром. См. здесь совместимые виды оружия.

getPassengerDrivebyAbility

Эта функция позволяет вам запрашивать, какие оружия local player может использовать для драйвбая, если он - пассажир.

table getPassengerDrivebyAbility ()

Возвращает таблицу оружий, которые пассажир может использовать для драйвбая.

setWeaponShotDelay

Эта функция позволяет задавать задержку между выстрелами для каждого из оружий для local player

bool setWeaponShotDelay(int weaponID, int delay)

• weaponID: Целое число, представленное weapon ID, задержку для которого вы хотите задать.
• delay: An integer representing the delay in between each shot, in milliseconds.

getWeaponShotDelay

Эта функция позволяет запрашивать задержку между выстрелами для каждого из оружий для local player

int getWeaponShotDelay(int weaponID)

• weaponID: Целое число, представленное weapon ID, задержку для которого вы хотите запросить.

Возвращает целое число, представленное задержку между выстрелами.

setDrivebySteeringAbility

Эта функция позволяет задавать возможность local player вести в режиме драйвбая.

bool setDrivebySteeringAbility( bool otherVehicles, bool bikes )

• otherVehicles: Булевая переменная, отвечающая за то, будет ли руление доступно для ТС, кроме двухколесного транспорта, где true включает руление и false отключает его.
• bikes : Булевая переменная, отвечающая за то, будет ли руление доступно для двухколесного транспорта, где true включает руление и false отключает его.

getDrivebySteeringAbility

Эта функция позволяет запрашивать, может ли local рулить при драйвбай-режиме.

bool getDrivebySteeringAbility( string drivebyType )

• drivebyType : Строка, которая может быть либо "bike", отвечающая за двухколесный транспорт, либо "car", отвечающая за весь остальной.

Возвращает булевую переменную, отвечающую за доступность опредленного вида драйвбая, где true - вкл и false - выкл.

setDrivebyAutoEquip

Эта функция позволяет задавать возможность авто-оснащения оружием для драйвбая при посадке в транспорт для local player.

bool setDrivebyAutoEquip( bool enabled )

• enabled : Булевая переменная, отвечающая за то, должно ли быть включено авто-оснащение.

getDrivebyAutoEquip

Эта функция позволяет запрашивать, срабатывает ли авто-оснащение оружием для драйвбая при посадке в транспорт для the local player.

bool getDrivebyAutoEquip()

Возвращает булевую переменную, отвечающую за то, включено ли авто-оснащение.

Совместимые с драйвбаем оружия в GTA

Это - оружия, совместимые с драйвбаем в GTA/MTA, они могут быть использованы в этом скрипте.

Name	ID		Name	ID
Pistol	22		Silenced Pistol	23
Desert Eagle	24		Chrome Shotgun	25
Sawn-Off Shotgun	26		Combat Shotgun	27
Uzi	28		MP5	29
Tec-9	32		AK-47	30
M4	31		Country Rifle	33
Minigun	38