TessuMod TeamSpeak Plugin for World of Tanks

This plugin is part of a TessuMod game modification for World of Tanks game, and will not work without it. With this plugin TessuMod supports 3D audio, positioning users voice in TeamSpeak so that their voices appear to come from their vehicle's direction on battlefield.

See the modification here: https://github.com/jhakonen/wot-teamspeak-mod/

This plugin is available for download in myteamspeak.com at: https://www.myteamspeak.com/addons/01a0f828-894c-45b7-a852-937b47ceb1ed

Configuration

Plugin's settings can be found from TeamSpeak main window's menu:

The dialog which opens provides following settings:

You can find more information when you hover mouse over the different UI controls within the dialog for tooltips of what each control does.

Next sections attempt to describe how you should configure the audio options depending of what kind of audio hardware you're using:

1. Stereo Headphones
   1. OpenAL + HRTF
   2. Virtual Surround
   3. Stereo Only
2. External Speakers (or 5.1/7.1 Headphones)

Stereo Headphones

Most of the headphones or headsets out there use stereo input. That is one channel/speaker per ear. If you have 5.1/7.1 headphones then see instructions later on below for external speakers.

You have basically three possible ways you can configure your headphones, listed below.

OpenAL + HRTF

Perhaps best results you would get by selecting OpenAL Soft and checking Enable HRTF. The idea is that TeamSpeak (with help of OpenAL's HRTF-feature) adds audio cues to the stereo output signal which alter the audio to make it sound like it comes from a certain direction:

With those options voices are positioned so that you can tell if the voice is coming from left, right, front, back, below or above you (or somewhere between).

Do note though that the HRTF-feature is very subjective. What one hears as accurate positioning might not sound accurate at all to someone else. You might even confuse voice coming from behind you as coming from your front or vice versa.

For this reason the plugin comes with a bunch of HRTF data sets which you can select from. All data sets alter the audio cues in different ways. Hopefully you can find one that fits for you.

To calibrate the audio output do following:

• Select OpenAL Soft, check enable HRTF and Horizontally (around y-axis),
• Select a HRTF data set from the list,
• Press Test button
• Listen the test tone, it should sound like the tone is rotating around you counter-clockwise starting your behind and moving first to right, then front, then left and finally back to behind. The test tone should stay vertically at same level and you shouldn't get front and back mixed up.
• Pick next data set, rinse and repeat...

When you find a data set that works for you just leave it selected and it will be used from now on.

Virtual Surround

Your sound card or integrated audio chip, or perhaps your headphones or a separate software might provide virtual surround support. Usually the virtual surround means something that converts 5.1 or 7.1 multichannel audio to stereo adding audio cues into the output signal:

With virtual surround voices are positioned so that you can tell if the voice is coming from left, right, front or back (or somewhere between). Do note though that none of these provide ability to position audio below or above you.

To enable virtual surround you need to select either OpenAL Soft or TeamSpeak's Built-in Audio. Then you need to enable the virtual surround support from your output device/card/software/whatever...

For Creative's Zx -series this is done from Sound Blaster's control panel at SBX Pro Studio -tab and toggling on SBX Pro Studio -button. Make sure you have headphones selected.

Here's a few other virtual surround technologies out there:

• Creative CMSS-3D
• Razer Surround
• Dolpy Headphone
• Realtek Virtual Surround

See if your hardware already supports one of these.

Stereo Only

Perhaps the worst choice. TeamSpeak outputs stereo audio which is fed as is to headphones:

With this you can only hear if the sound is coming from left or right side (or somewhere between), no positioning to front, back, above or below will occur.

To use this select either OpenAL Soft or TeamSpeak's Built-in Audio. Make sure HRTF is not enabled and neither any virtual surround functionality.

External Speakers (or 5.1/7.1 Headphones)

Audio positioning accuracy depends greatly from amount of speakers you have connected.

With this choice TeamSpeak outputs whatever audio channels your sound card is configured to use and sound card then pipes the signals to your speakers:

Note that audio can be positioned at best to your left, right, front or back side (or somewhere between) if you have four or more speakers connected. No positioning to your above or below will occur.

To use this select either OpenAL Soft or TeamSpeak's Built-in Audio. Make sure HRTF is not enabled and neither any virtual surround functionality.

Building on Windows

You will need following dependencies:

• Visual Studio 2015
• Python 2.7
• Qt 5.12.3

Open Command Prompt and then build the installer:

set PATH=C:\Qt\Qt5.12.3\5.12.3\msvc2015_64\bin;C:\Python27;%PATH%
"C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 8.1
mkdir build
cd build
qmake ..
nmake package

Adjust the paths to match your environment.

Building on Linux (e.g. Ubuntu)

sudo apt install qt5-default

mkdir build
cd build
qmake ..
make package

License

This mod is licensed with LGPL v2.1.

Development

With bugs and improvement ideas please use issues page to report them. Also, pull requests are welcome. :)