Salty Chat

Salty Chat is a TeamSpeak voice plugin which adds more realism to your gamemode (like GTA 5 FiveM/RAGEMP). In order to serve a wide range of mods, the plugin provides a WebSocket server, which allows bidirectional communication. Due to the possibility of communication in both directions, the plugin can also send "State Trigger" (player speaks, microphone muted/unmuted, sound muted/unmuted and more).

We provide resources for some mods and also maintain them. Since it is impossible for us to provide a resource for every mod and every framework, we need your help. If you write resources for certain mods or frameworks that we haven't covered, you are welcome to add them to our resources list through a pull request.

You can help us to improve our docs by contributing via pull requests - we appreciate any contribution.

Join our Discord and start with Salty Chat!

Features

Proximity

• 3D audio
• Adjustable ranges (for e.g. whispering and screaming)
• Distance-based flattening of the volume
• Multiple audio streams for one player (in combination with phone and radio)
• Voice effects
  • Muffling - Are you behind a wall?
  • Echo - Tunnel? HELLO...hello...hello
  • Megaphone - Police, stop right there!

Radio

• Realistic voice distortion
• Distortion based on distance
• Different ranges
  • Ultra Short Range (1.8km)
  • Short Range (3km)
  • Long Range (8km)
• Communication from radio to radio, or distributed via radio towers
• Loudspeaker (players can listen to the radio traffic)
• Customizable audio mode for playback (left, right or stereo)

Phone

• Realistic voice distortion
• Distortion based on signal strength
• Loudspeaker (players can hear the conversation partners)
• Customizable audio mode for playback (left, right or stereo)

Audio Player

• Sounds in the respective sound pack (%appdata%\TS3Client\plugins\SaltyChat) can be played and stopped
• Play multiple sounds at the same time (e.g. a ringtone and vibration)
• Clean looping of sounds
• Global overwriting of sounds (%appdata%\TS3Client\plugins\SaltyChat\override)
• Fallback if a file is missing (override > specified sound pack > default sound pack)

Swiss Channels

In the initiate command there is the possibility to declare TeamSpeak channels as swiss channels.\ Swiss channels are channels in which the plugin keeps the original name of the client and does not move them into the ingame channel.\ For example, support channels can be set as swiss channels, which gives you the ability to move users out of the in-game channel without them having to leave the game first.\ After declaring a channel as swiss channel, all it's sub-channels will be a swiss channel as well.

Configuration file

When the plugin is starting, the configuration file under %appdata%\TS3Client\plugins\SaltyChat\settings.json will be loaded an applied. Here are various options that can be customized:

Versioning and Update Branches

With version 0.4.0 we introduce a new versioning schema for Salty Chat.
Versions within the same major version will be compatible with each other, even if there are changes like new features or fixes.

0.4.0
| | |
| | --- Patch (fixes and changes)
| --- Minor (new features)
--- Major (incompatible changes)

Any update will be tested in our multi-stage release process:

TeamSpeak Server Settings

To avoid issues with your TeamSpeak server, we recommend the following settings:

• Manage Virtual Server --> Misc tab --> Min clients in channel before silence: More then your server slots
• Adjust anti-flood (only if needed)
  • Method 1: Manage Virtual Server --> Anti-Flood tab --> adjust values as needed
  • Method 2: Set b_client_ignore_antiflood permission flag to the group your users are in

Ensure that users can whisper among themselves while in the ingame channel. In larger and more restrictive environments, you may not want to give all users permission to whisper. There are ways to solve this with bots, but here are "easy" ones:

• Method 1 (only users in the ingame channel can whisper):
  • Remove the i_client_whisper_power permission flag in the group to which your users belong and set i_client_needed_whisper_power to, say, 10
  • Edit the permissions for your ingame channel (Permissions --> Channel Permissions and select the channel on the left) and set i_client_whisper_power to 10 (>= needed power from before)
• Method 2 (everony can whisper):
  • Set i_client_whisper_power permission flag for your user group >= i_client_needed_whisper_power of all your groups

Available resources

Credits

We are using code from the following open source projects:

• Newtonsoft.Json
• RadioFX
• DSPFilters
• Fleck

Sounds we ship in the default sound pack are made by BeatbaronTV, except from the radio sounds, these are recorded from two Motorola Talkabout T82 Extreme we bought for this.