EarShot OpenAL

Здравствуйте! Очень рекомендую вам прочитать всё до конца, чтобы вы полностью поняли, как добавлять новые звуки в вашу сборку игры! (Если не прочтёте — это уже не моя проблема)

О моде:

Это переработка заброшенного мода «EarShot», который позволял добавлять новые звуки оружия без замены стандартных.

Идея возникла у моего друга, когда он столкнулся с проблемами в этом моде и отсутствием некоторых эффектов, например, эхо после выстрела, эффекта Доплера, реверберации и т. д.

Он спросил меня, могу ли я что-то с этим сделать — и тут всё началось…

Я начал с того, что заменил устаревший движок «irrKlang» на OpenAL, который используется в большинстве игр и приложений, исправил баги и улучшил мод.

И вот мы здесь! Приятного добавления новых звуков в вашу игру! Максимально подробная инструкция приведена ниже.

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

Самое важное: убедитесь, что ваш звук в формате МОНО, если хотите объёмное 3D-звучание (иначе, если он в СТЕРЕО, он не будет иметь затухания по дистанции и будет звучать в 2D!).

Но если вам действительно нужно стерео — оставляйте так. Это полезно только для свиста пуль, так как у них нет конкретной позиции в 3D-пространстве.

Все аудиофайлы должны быть строго в формате .wav.

Мод имеет несколько пунктов отладочного меню, например, включение логирования и перезагрузку всех аудиопапок (это может вызвать необычное поведение, но во время тестирования проблем не обнаружено).

Авторство принадлежит оригинальному создателю EarShot (HzanRsxa2959), я лишь переработал мод.

Особая благодарность:

Shimada — тестирование.

Mentraze — оружейный пак VC, видео обзор, и тестирование.

Lividkilla66 — пак шагов из Driv3r и тестирование.

Dun & CrimsonW — оружейный пак из Manhunt и тестирование.

Matt1010 и Mentraze — лого.

Скачать последнюю версию OpenAL можно здесь:

https://github.com/kcat/openal-soft

GitHub: https://github.com/theartemmaps1/EarShotOpenAL

Видео:

*GameFolder это папка игры.

Вопросы и ответы:

В: Почему мои звуки рандомизируются?

О: Поверьте, странно это говорить, но причина в том, что в конце имени файла есть число. Плагин думает, что вы хотите больше одного варианта звука.

Решение: либо оставьте только «0», либо вообще уберите цифры в названии файла.

В: Мод не работает, звуки не заменяются!

О: Дважды проверьте пути и имена файлов, загляните в логи для получения информации.

Также убедитесь, что у вас есть OpenAL32.dll в корневой папке игры (без него мод даже не запустится).

И проверьте, отключён ли у вас мод ModelExtras, так как он отключает EarShot и подменяет его своей реализацией.

Задалбывайте Grinch’а, чтобы он убрал это.

# Установка:

Файлы .asi и .ini, а также папка «EarShot» могут быть размещены в любом месте (скрипты, корень, modloader), но файл OpenAL32.dll должен всегда находиться в корневой папке.

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

GameFolder\EarShot.asi, EarShot.ini, EarShot (папка), OpenAL32.dllGameFolder\scripts\EarShot.asi, EarShot.ini, EarShot (папка)GameFolder\modloader\EarShotMod\EarShot.asi, EarShot.ini, EarShot (папка)

1. Звуки оружия

Добавление новых звуков выстрелов почти такое же, как в предыдущей версии EarShot.

Нужно создать папку внутри «EarShot» с любым названием (например, AK-47), создать в ней файл с расширением .earshot и именем оружия из weapon.dat (например, ak47.earshot).

Внутрь положить shoot.wav (звук выстрела).

Совет: чтобы не создавать слишком много папок, можно положить несколько .earshot-файлов в одну папку с нужными звуками.

Примечание:

Если вы хотите, чтобы звуки чередовались для разнообразия, добавьте цифры в конце названия файла.

Например: shoot0.wav, shoot1.wav, filename0.wav, filename1.wav и т. д.

Можно добавить до 10 вариантов (и до 300 для амбиента).

Высоту звука (pitch) выстрела или «after sound» можно менять прямо в файле .earshot оружия.

Откройте файл и добавьте строчку pitch=x, где x — число с плавающей точкой (например, pitch=1.1).

Подробнее о числе с плавающей точкой:

https://en.wikipedia.org/wiki/Floating-point_arithmetic

Эхо или звук после выстрела → after.wav

Перезарядка → reload.wav

Две части перезарядки → reload_one.wav и reload_two.wav

Дальний выстрел → distant.wav (срабатывает, если стрелок в 50+ единицах от вас)

Совет: проверяйте лог-файл EarShotOpenAL.log для дополнительной полезной информации.

1.1. Миниган

Если заменяете звуки минигана, учтите:

основной звук вращения → spin.wav

конец вращения → spin_end.wav

Если же звуки вращения не нужны, просто замените звук выстрела.

Пример:

GameFolder\EarShot\Minigun\spin.wav

GameFolder\EarShot\Minigun\spin_end.wav

1.2. Ракеты

Создайте папку "Missiles" (строго) внутри «EarShot» и положите туда missile_flyloop.wav.

Пример: GameFolder\EarShot\Missiles\missile_flyloop.wav

1.3. Пушка танка

Чтобы у Rhino был звук пушки, создайте папку с названием "Tank Cannon" (Строго) в «EarShot» и положите туда cannon_fire.wav.

1.4. Свист пуль

Путь: GameFolder\EarShot\generic\bullet_whizz

Файлы:

left_rear.wav

left_front.wav

right_rear.wav

right_front.wav

Левый/правый → сторона относительно камеры.

Rear → если пуля прилетает сзади.

Звуки должны быть стерео, так как они проигрываются в 2D пространстве и не имеют позиции в 3D пространстве.

1.5. Драй-файр и лоу-файр

Фишка из CS:GO, когда обойма постепенно уменьшается, проигрывается специальный звук.

Драй-файр → dryfire.wav (срабатывает, когда обойма пустая).

Лоу-файр → low_ammo.wav (срабатывает при падении боезапаса ниже 33%, постепенно увеличивается в громкости).

2. Звуки взрывов

Это мой личный фаворит. Все мы любим взрывы, не так ли? И мы хотим правильные звуки для них без замены стандартных. Следуйте этим шагам для максимального погружения!

Звуки заменяются в папке GameFolder\EarShot\generic\explosions.

Основные звуки взрыва называются explosion.wav, и вы можете добавлять к ним альтернативы (как я уже говорил ранее, вы можете добавить альтернативы для любого звука).

Для дальних взрывов добавьте файл distant.wav, для обломков — debris.wav.

Звук далёкого взрыва будет воспроизводиться, если взрыв произошёл на расстоянии 100 единиц от камеры.

Типы взрывов: https://wiki.multitheftauto.com/wiki/Explosion_types

Пример пути для взрывов которые распространяются на все виды взрывов:

GameFolder\EarShot\generic\explosions\explosion.wav

Пример пути для типов взрывов:

GameFolder\EarShot\generic\explosions\explosionTypes\4\explosion.wav, debris.wav и т. д. (4 — это тип взрыва автомобиля).

3. Звуки шагов

Если вам кажется, что стандартные шаги скучные, вы можете заменить их здесь!

Путь: GameFolder\EarShot\generic\footsteps

В этой папке можно создавать подпапки для каждой поверхности, по которой вы ходите:

"default", "grass", "metal", "wood", "sand", "water", "dirt", "pavement", "carpet", "flesh", "tile".

Создайте папку для нужной поверхности и положите внутрь звук step.wav.

Вы также можете добавить особые звуки для разных видов обуви!

Путь: GameFolder\EarShot\generic\footsteps\shoename, где shoename — это название модели обуви, например sneaker или feet.

Затем внутри создайте папки для поверхностей и положите туда step.wav.

Примеры:

4. Звуки рикошета

Вы также можете заменить звуки рикошета (или попадания пули).

Путь: GameFolder\EarShot\generic\ricochet

Каждая подпапка может иметь название поверхности, по которой попадает пуля:

"default", "metal", "wood", "water", "dirt", "glass", "stone", "sand", "flesh"

Как и со звуками шагов, создайте папку и добавьте в неё файл ricochet.wav.

Пример:

GameFolder\EarShot\generic\ricochet\wood\ricochet.wav (звук рикошета от дерева).

5. Звуки огня

Заменить звуки огня очень просто. Они находятся в папке GameFolder\EarShot\generic\fire.

В игре несколько типов огня, поэтому каждый файл нужно назвать по типу:

Пример:

GameFolder\EarShot\generic\fire\fire_carloop.wav (звук горящего двигателя автомобиля).

6. Звуки ближнего боя

Здесь можно заменить звуки ударов руками и оружием ближнего боя, так же как и в предыдущем EarShot. Поддерживаются и кулаки.

Звуки удара пистолетом (прикладом) заменяются просто: положите hit.wav в папку огнестрельного оружия.

Пример:

GameFolder\EarShot\Pistol\hit.wav (звук удара пистолетом).

6.1. Звуки угона (Jacking sounds)

Этот подраздел относится к звукам угона автомобилей.

Перед добавлением убедитесь, что звуки совпадают по таймингу с анимацией удара и звуком падения тела!

Например: если удар в анимации приходится примерно на 1,3 секунды, то в Audacity или другом редакторе установите ударный звук точно в это время. Также добавьте звук падения тела.

Звуки должны находиться в папке: GameFolder\EarShot\generic\jacked

Файлы:

Пример:

GameFolder\EarShot\generic\jacked\jack_car.wav (звук угона машины).

7. Амбиентные звуки

А вот и самая интересная часть — амбиентные звуки на карте!

Главная папка: GameFolder\EarShot\generic\ambience

Файлы:

В подпапке zones можно создать папки с названиями зон. Например, аэропорт с шумом самолётов или лес с воем волков.

Формат тот же: добавьте имя зоны после подчёркивания.

Пример:

GameFolder\EarShot\generic\ambience\zones\creek\ambience.wav (дневной амбиент в зоне creek).

В нашем случае «creek» — это имя зоны из GXT-ключа. Полный список зон можно посмотреть здесь:

https://docs.sannybuilder.com/scm-documentation/sa/zones

Принцип работы:

Подпапка gunfire задаёт амбиент выстрелов в Лос-Сантосе.

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

По умолчанию: только ak47 и pistol. Положите внутрь shoot.wav.

Подпапка interiors задаёт амбиент для интерьеров.

Внутри неё создаётся папка с ID интерьера (например, 1).

А в ней уже папка с GXT-ключом интерьера (например, CARTER).

Внутрь кладётся ambience.wav.

Информацию об интерьерах можно найти здесь:

https://docs.sannybuilder.com/scm-documentation/sa/interiors

или посмотреть в логах текущий интерьер.

Папки country, LS, LV и SF, которые можно создать внутри zones, задают глобальный амбиент зон.

Это значит, что амбиент будет воспроизводиться на всей зоне, а не кусками.

Примеры:

Для разработчиков:

Мод предоставляет экспортируемую функцию GetContext, так как если два плагина используют OpenAL Soft одновременно, возможен конфликт.

Используйте эту функцию для получения контекста из данного мода.

Приятной игры!

Присоединяйтесь к моему дискорд серверу: https://discord.com/invite/4dxtJCwSx8