Skip to content
Janne Hakonen edited this page Jun 14, 2015 · 30 revisions

TessuMod depends of two TeamSpeak plugins to function:

  • Client Query Plugin and
  • TessuMod Plugin.

Following subsections describe them more closely.

Client Query Plugin

Client Query comes with TeamSpeak and is enabled by default. The plugin offers most of the functionality that you can do through TeamSpeak's user interface, but in a form of a simplified command line terminal:

TessuMod uses this plugin to detect when TeamSpeak is up and running, when TeamSpeak is connected to a server, when users speak or stop speaking, etc...

TessuMod is useless without this plugin, so make sure you have it enabled if TessuMod has difficulties detecting the TeamSpeak client.

For more info, see plugin's forum post:
http://forum.teamspeak.com/showthread.php/66509-Official-ClientQuery-Plugin

TessuMod Plugin

This plugin comes with TessuMod and users can install it as well. The plugin is optional, there is no need to install it, the mod will function without it.

The plugin adds support for positional audio or 3D sound. In battle, with the plugin installed, user voices appear to come from their vehicle's direction.

Installation

The mod advertises the plugin in-game in garage's system notification center (lower right corner) when the mod connects to TeamSpeak client and plugin hasn't been installed yet:

From the notification you can start the installation wizard. If you're using Windows Vista or newer you will likely get prompted for admin priviledges which looks something like this (screenshot from Finnish language Windows 7):

Alternatively you can just execute installer manually. It's installer package tessumod.ts3_plugin is found from res_mods\<version> -folder. Double clicking the file will start the installation.

You may need to restart TeamSpeak after the installation has finished.

Configuration

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

The dialog which opens provides following settings:

Hover mouse over the different UI controls for tool tips 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. First, do you use stereo headphones or external speakers with TeamSpeak?

Stereo Headphones

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 coming 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. Each data set alters 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.

External Speakers (or 5.1/7.1 Headphones)

General:

  • Enable Positional Audio - Toggles positional audio on / off.

Audio:

  • Test Speakers - With Test button you can test how different audio settings affects to audio playback. The testing feeds out noise from TeamSpeak's currently selected audio device. Position of the audio source rotates around you depending what has been chosen in Rotate audio source -setting.
  • Horizontally (around y-axis) - The noise playback's position starts from behind you and rotates counter-clockwise around you, first to right size, then to front of you, then to your left size and finally back to behind you.
  • Vertically (around z-axis) - The noise playback's position starts from below you and rotates first to right size, then to above of you, then to your left size and finally back to your below.
  • Vertically (around x-axis) - The noise playback's position starts from below you and rotates first to front of you then to above of you, then to behind you and finally back to your below.
  • Select Audio Backend - Selector for audio positioning engine. OpenAL provides more functionality and configuration options and it is enabled by default. If you encounter issues with OpenAL you can also fallback to use TeamSpeak's own internal positioning engine.
  • Enable HRTF - Improves audio positioning when using headphones or headsets.
  • Select default HRTF data set - HRTF data set to use.
  • Logging level - Selects OpenAL's logging level to use. Those logs are found from TeamSpeak > Tools > Client Log.
  • Advanced Settings - opens OpenAL configuration file to a text editor. Any changes done to that file take effect immediately upon file save.
Clone this wiki locally