README

Task Force Arma 3 Radio

TeamSpeak радио плагин для Arma 3.

####Документация     

##Поддержите нас на Make Arma Not War

###Установка

• Скачайте архив с рацией 0.9.7 и распакуйте его.
• Скопируйте содержимое папки TeamSpeak 3 Client в корневую папку TeamSpeak.
• Скопируйте содержимое папки Arma 3 в папку с игрой – ...\SteamApps\common\Arma 3.

TFAR использует последнюю версию СBA (Community Base Addons). Поэтому, если этот мод у вас уже установлен – Windows предложит перезаписать поверх содержимого папки.

###Настройка

• Убедитесь, что в TeamSpeak клавиша Caps Lock не используется для разговора.
• Также в Arma 3 отключите разговор по внутренней связи (VON) по нажатию Caps Lock (чтобы не двоиться).
• Откройте список плагинов в TeamSpeak – Settings> Plugins.

1. Включите Task Force Arma 3 Radio.
2. Отключите ACRE и radio ts ARMA3.ru version, если они есть, чтобы избежать конфликтов.
3. На всякий случай внизу слева можно нажать кнопку Reload All для перезагрузки всех плагинов.

• Убедитесь, что громкость оповещений в TeamSpeak не отключена – Options> Payback> Sound Pack Volume – установите в положительное значение.
• Запустите игру с аддонами @CBA_A3 и @task_force_radio. Это можно сделать, прописав в ярлыке игры имена модов после EXE файла …\arma3.exe -mod=@CBA_A3;@task_force_radio, но рекомендуется включить необходимые моды в настройках игры – Settings> Expansions.
• Зайдите в тот же канал, где находятся другие игроки, играющие с данной рацией, либо вас перебросит в канал TaskForceRadio в случае его наличия при старте миссии.

Если ник в профиле игры и TeamSpeak совпадает – плагин изменит ваш ник в TS в процессе игры.

Не рекомендуется использовать плагин при одновременном подключении к нескольким серверам в TeamSpeak.

Рекомендуется отключить встроенные звуки оповещений TeamSpeak – Options> Notifications> Sound Pack: "Sounds Deactivated". Для применения этой опции необходимо перезапустить TeamSpeak.

###Использование

Клавиши	Действие
Кнопка разговора в TS	Прямая речь.
Caps Lock	Разговор по рации.
CTRL + Caps Lock	Разговор по рации дальней связи.
CTRL + P	Открыть интерфейс ручной рации (рация должна быть в слоте инвентаря). В том случае, если у вас имеются несколько раций - вы сможете выбрать требуемую. Также есть возможность установить рацию как активную (ту, которая будет использоваться для передачи). Кроме того, существует возможность скопировать настройки для раций и другой радиостанции, если она использует аналогичный код шифрования.
NUM[1-8]	Быстрое переключение каналов коротковолновой рации.
ALT + P	Открыть интерфейс рации дальней связи - она должна быть надета на спину, либо вы должны быть в технике за водителя, стрелка, командира или помощника пилота. Если доступно несколько раций - вам будет предложено выбрать. Также одну из них можно установить как активную. Кроме того, существует возможность скопировать настройки для раций и другой радиостанции, если она использует аналогичный код шифрования.
CTRL + NUM[1-9]	Быстрое переключение каналов рации дальней связи.
CTRL + TAB	Изменить громкость прямой речи. Можно говорить шепотом (Whispering), нормально (Normal) и кричать (Yelling). Не влияет на громкость сигнала в радио передаче.
SHIFT + P	Открыть интерфейс переговорного устройства для водолазов (на вас должен быть надет ребризер).
CTRL + ~	Разговор по переговорному устройству для водолазов.
CTRL + ]	Следующая рация ближней связи.
CTRL + [	Предыдущая рация ближней связи.
CTRL + ALT + ]	Следующая рация дальней связи.
CTRL + ALT + [	Предыдущая рация дальней связи.
CTRL + [←,↑,→]	Изменение стерео режима рации ближней связи.
ALT + [←,↑,→]	Изменение стерео режима рации дальней связи.
T	Передача на дополнительном канале рации командира.
Y	Передача на дополнительном канале рации дальней связи.
ESC	Выход из интерфейса рации.

###Рации

Рация	Сторона	Диапазон /Дальность
📻 AN/PRC-152 (командира)	Синие	30-512 МГц /5 км
📻 RF-7800S-TR (бойца)	Синие	30-512 МГц /2 км
📻 RT-1523G (ASIP) (дальней связи)	Синие	30-87 МГц /20 км (30 км для встроенной)
📻 AN/ARC-210 (авиационная)	Синие	30-87 МГц /40 км
📻 AN/PRC148-JEM (командира)	Независимые	30-512 МГц /5 км
📻 AN/PRC-154 (бойца)	Независимые	30-512 МГц /2 км
📻 AN/PRC-155 (дальней связи)	Независимые	30-87 МГц /20 км (30 км для встроенной)
📻 AN/ARC-164 (авиационная)	Независимые	30-87 МГц /40 км
📻 FADAK (командира)	Красные	30-512 МГц /5 км
📻 PNR-1000A (бойца)	Красные	30-512 МГц /2 км
📻 MR3000 (дальней связи)	Красные	30-87 МГц /20 км (30 км для встроенной)
📻 MR6000L (авиационная)	Красные	30-87 МГц /40 км
📻 Приемопередатчик (подводный)	Все	32-41 кГц /70-300 м (в зависимости от уровня волн)

Ручная и дальняя рации одной фракции поддерживают единый протокол, поэтому могут связываться друг с другом. В случае если передача осуществляется с ручной – звук будет высокочастотным. В случае передачи с дальней – низкочастотным.

Распространению радио сигнала мешает ландшафт. В худшем случае – вы прямо за крутым холмом. Если вы начнете двигаться от края холма в направлении противоположном вещающему игроку – сигнал будет улучшаться. В лучшем случае – прямая видимость.

Рация командира и рация дальней связи позволяют одновременно принимать и передавать два канала. Нажатие на рации «Настроить дополнительный канал» сделает текущий канал дополнительным. Переключившись на другой канал вы будет слышать два канала – активный и дополнительный.

####Распределение

• По умолчанию рация дальней связи выдается лидерам отрядов. Если у игрока надет рюкзак - он его автоматически сбросит на землю.

• Рация ближней связи выдается игрокам, у которых есть ItemRadio в инвентаре. Выдача рации может потребовать нескольких секунд ожидания – следите за сообщениями в центре экрана.

####В технике

• Рация дальней связи доступна в технике водителю, командиру, стрелку и помощнику пилота. Не вся техника имеет встроенные рации.

• У каждого слота техники своя рация, которая должна быть настроена отдельно. Если вы планируете пересаживаться с места на места в технике - предварительно настройте рацию на всех слотах – например на слоте водителя и на слоте стрелка.

• Техника делиться на открытую и закрытую (изолированную). Если вы находитесь в изолированной технике, то почти не будете слышать голоса снаружи (и наоборот). Однако если вы выглянете из техники, то будете слышать как голоса внутри, так и снаружи.

####Радиоперехват

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

Рекомендуется поднимать рации открывая инвентарь на том месте, где она лежит (чтобы она не пропала из-за ошибок игры).

• Настройки рации в технике также сохраняются.
• По умолчанию рации каждой фракции используют свои коды шифрования, поэтому вы не будете слышать вражеские переговоры, даже введя используемую врагами частоту. Чтобы прослушивать (и говорить в эфир) противника - необходимо каким-либо образом захватить вражескую радиостанцию.

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

####Водолазам

• Вы не можете говорить голосом находясь под водой (даже в водолазном костюме). Однако на близком расстоянии ваш собеседник сможет расслышать что-либо очень невнятное (исключение - если вы под водой в изолированной технике).
• Находясь под водой, вы невнятно и слабо слышите голоса на суше.
• Для связи между водолазами используйте Переговорное устройство.
• Вы не можете пользоваться радио связью под водой (ни говорить, ни слышать). Если нужно что-то передать на сушу - всплывайте на поверхность. Исключение - подводный аппарат на перископной глубине, т.к. в нем водолазам можно использовать рацию дальней связи.

###Режимы работы плагина Плагин поддерживает два режима работы — серьезный и упрощенный.

• Упрощенный — используется по умолчанию. Он предназначен главным образом для кооперативных игр. Его особенностью является то, что игроки с плагином и в игре слышат мертвых, не играющих, играющих на другом сервере и играющих без плагина игроков минуя рацию (просто как через TeamSpeak). Это делает менее удобным игры против людей, но позволяет вашему другу без проблем узнать, где вы играете, какая у вас частота и т.д. Разумеется, те кто играет на одном сервере со включенными аддонами и плагинами будут слышать друг друга по «законам» рации с учетом расстояния и частот.

• Серьезный — предназначен для проведения игр, где игроки играют против других игроков. Для его активации в TeamSpeak необходимо создать канал с названием TaskForceRadio и паролем 123. Игроки должны включить плагин рации, зайти на сервер и, разойдясь по каналам сторон, проходить инструктаж. После загрузки миссии, через несколько секунд игроки будут переброшены в канал TaskForceRadio. В данном случае игроки будут слышать только живых игроков, со включенным плагином, играющих на этом же сервере. Мертвые игроки, в свою очередь, могут общаться друг с другом. Если мертвый игрок респавниться - он снова будет слышать только живых. После того, как игра заканчивается, игроки перебрасываются в канал, в котором они проходили инструктаж до игры.

###Решение проблем

• Pipe error 230 - вы скорее всего вы забыли включить плагин в TeamSpeak.
• Плагин в TS показываться красным и не загружается - скорее всего вам нужно обновить TeamSpeak.
• Если что-то поломалось - попробуйте перезапустить плагин.
• Не работают действия на Caps Lock - возможно из-за геймерской клавиатуры, где код Caps Lock отличается. Попробуйте изменить используемые клавиши (путем редактирования userconfig).
• Если из-за ошибки или еще чего-то вы перестали слышать других игроков даже вне игры, откройте Setup 3D Sound в TeamSpeak и кликните Center All.
• Для устранения возможных ошибок с плагином разработчикам может потребоваться лог TeamSpeak. Чтобы его скопировать зайдите в Tools> Client Log – поставьте все галочки сверху и – выделив весь текст через CTRL + A – скопируйте его в буфер обмена.
• Если TeamSpeak упал при использовании плагина – он покажет окошко с описанием того, где можно найти дамп (путь к файлу). Буду очень благодарен за этот файлик.

###Администраторам TS На всякий случай уменьшите уровень защиты от флуда – правый клик по серверу> Edit Virtual Server> More> Anti Flood – поставьте значения 30, 300, 3000 (сверху вниз).

###Разработчикам Если данная разработка будет как-либо популярна, то хотелось бы избежать кучи несовместимых форков. По этой причине, в случае желания внесения изменений связывайтесь со мной - велика вероятность, что ваши разработки будут включены в главную ветку. Ждем запросов на включение ваших изменений. 😄

###Спасибки

• Отряду Task Force Arrowhead за тестирование, поддержку, терпение и всяческую помощь.
• MTF (varzin) за помощь с графикой и документацией.
• Hardckor за помощь с графикой.
• Shogun за помощь с графикой.
• Блендеру за шрифт.
• vinniefalco за DSP фильтры.
• WOG и лично TRUE за помощь в тестировании.
• Music DSP Collection за компрессор.
• Avi за инспекцию кода.
• Vaulter (GitHub) за помощь в разработке.
• Дине за перевод.
• Zealot (GitHub) за помощь в разработке и полезные скрипты.
• NouberNou за советы и конкуренцию.
• Megagoth1702 за свою давнюю работу по эмуляции звучания рации.
• Naught за инспекцию кода.
• Andy230 за перевод.
• L-H за помощь с кодом.
• NorX_Aengell за перевод на французский.
• lukrop (GitHub) за помощь с кодом.
• nikolauska (GitHub) за помощь с SQF кодом.
• Kavinsky за AN/PRC-154, RF-7800S-TR и другие рации.
• JonBons (GitHub) за помощь с кодом.
• ramius86 за перевод на итальянский.
• Killzone Kid за статьи.
• Krypto202 (GitHub) за звуки.
• pastor399 (GitHub) за модель рюкзаков и текстуры.
• J0nes за помощь с моделями.
• Raspu86 (GitHub) за модель рюкзаков.
• Gandi за текстуры.
• Pixinger за помощь с Зевсом.
• whoozle за звуковой движок и помощь.
• CptDavo за помощь с текстурами.
• KoffeinFlummi за помощь с кодом.
• R.m.K Gandi за текстуры рюкзаков.
• Pomigit за паттерны текстур.
• Priestylive за текстуры для BWMOD.
• Audiocustoms (SoundCloud) за звуки раций.
• EvroMalarkey (GitHub) за перевод на чешский.
• Tourorist за помощь с документацией.
• Разработчикам RHS за помощь в интеграции.
• Всем, кто делал видео и статьи с обзорами.
• Всем пользователям (особенно тем, что нашли баги).
• Извините, если кого-то случайно забыл.