Skip to content

jhakonen/wot-teamspeak-mod

Repository files navigation

TessuMod

A modification for integrating TeamSpeak into Wargaming's World of Tanks game.

The mod provides visual feedback in-game when a player speaks in TeamSpeak and positions speakers voice in TeamSpeak so that their voice appears to come from their vehicle's direction on battlefield.

The visual feedback includes:

  • Normal ingame voice chat notifications under player's name in e.g. training room, platoon, etc. views:
  • and in battle (under player's name in side panels, speaker icon above vehicles and focus animation in minimap):

Installation

  1. Download newest release and extract it to your WOT folder.
  2. Download and install TS 3 client from http://www.teamspeak.com/?page=downloads
  3. Download and install TessuMod TeamSpeak plugin

Usage

  1. Start TS client
  2. Connect to TS server and join to a channel with your platoon/team mates
  3. Start WOT and join a battle with your team mates

Notes on functionality

The mod maps your WOT nickname to your TS nickname by inserting your WOT nickname to your TS client's meta data which will be then available to other TessuMods installed to your team mates' games. The presence of that nickname in you meta data enables other players to see you speaking in their WOTs. Respectively presence of the nickname in other TS users' meta data enables you to see them speaking in your WOT game. As such other all your team mates should have TessuMod installed for this to work as expected.

If the WOT nickname isn't present in speaking TS user's meta data then TessuMod, as a fallback solution, tries to find WOT player in the battle with same nickname and sets that as speaking player. Comparison is done in case-insensitive manner.

If none of the players matched then configuration options may have rules which first extract nickname from TS nickname (e.g. if TS nickname has WOT nickname and user's clan tag, or maybe user's real name) and then map the extracted nickname using mapping rules to configured WOT nickname.

The mod also collects successful matches into a cache file (located at res_mods/configs/tessu_mod_cache.ini) and the file is used to match players to TS users if the above mentioned rules fail to provide successful match. The cache stores matched TS users and players by their unique ID values. This helps the mod to remember matches even if user changes his TS nickname.

If still no matching player is found then nothing happens.

Development

Requirements:

  • Python 2.7 (for compiling the mod)
  • Python 3.7 (for running test suite)

Define environment variable with path to Python 2.7:

export BDIST_WOTMOD_PYTHON27=/usr/bin/python2

Running test suite:

python3 setup.py test

Building the mod from sources and installing it into World of Tanks:

python3 setup.py bdist_wotmod --dist-dir=<game-dir>/mods/<version>/tessumod

Creating release archive:

python3 setup.py clean package

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

License

This mod is licensed with LGPL v2.1.