Voiceserver Connect

Nextra · **Plugin Info:**

Voiceserver Connect by Nextra
(connect teamspeak connect ventrilo connect mumble connect voiceserver)
.: Description

Für eine Deutsche Übersetzung dieses Textes lade dir den Anhang "vc_german_desc.txt" herunter.

The purpose of this plugin is to provide players an easy way of connecting with your voiceserver.

I basically created it because other voiceserver plugins lack flexibility (as far as options (cvars) and hardcoded
commands etc. are concerned) and features that I demanded of a good voiceserver connecting plugin.
It is very easy to extend this plugin to support new tools.

.: Features

- Multi-Tool support ( TS2, Ventrilo, Mumble and TS3 pre-configured )
- Easily extendable for new tools and commands
- Entirely configurable by cvars
- Banned chars and banned names support
- Advertising of the commands
- Support for separate channels for each team
- Multilanguage

.: Cvars

vc_enabled <0|1> - Disable/enable this plugin

vc_ads <0|1> - Disable/enable chat advertising for your voiceserver
vc_adfreq <float> - Frequency of ad messages
vc_adcolor <1-6> - Color of ads. (CS / CZ only)
1 = red
2 = blue
3 = grey
4 = yellow
5 = green
6 = team color

vc_bannedchars "" - Chars that are not allowed on your voiceserver and will be replaced by spaces.
vc_fwslash <0|1> - 0 = Commands with or without / , 1 = Commands require / in front
vc_tool <0|1|2|3> - The voicetool your server is running [pre-config]
0 = TeamSpeak 2
1 = Ventrilo
2 = Mumble
3 = TeamSpeak 3

vc_teamenabled <0|1> - Disable/enable support for team-based options.

.: Default voiceserver options
These are the default configuration options for the specific voice server.

vc_default_serverip "" - Voiceserver IP
vc_default_serverport "" - Voiceserver port
vc_default_serverpw "" - Password of your voiceserver
vc_default_servername "" - Voiceserver name (Ventrilo/Mumble only)
vc_default_serverversion "" - Version that the server is running (Mumble only)
vc_default_channel "" - Channel user should join to
vc_default_channelpw "" - Password of channel

.: Team-based Cvars
You are now able to configure a completely separate set of options for each team in your server.
If any of the server ip/port/pw/name cvars is left empty the accordant default cvar is used.

vc_team1_serverip "" - Voiceserver IP
vc_team1_serverport "" - Voiceserver port
vc_team1_serverpw "" - Password of your voiceservert
vc_team1_servername "" - Voiceserver name (Ventrilo/Mumble only)
vc_team1_serverversion "" - Version that the server is running (Mumble only)
vc_team1_channel "" - Channel user should join to
vc_team1_channelpw "" - Password of channel

vc_team2_serverip "" - Voiceserver IP
vc_team2_serverport "" - Voiceserver port
vc_team2_serverpw "" - Password of your voiceserver
vc_team2_servername "" - Voiceserver name (Ventrilo/Mumble only)
vc_team2_serverversion "" - Version that the server is running (Mumble only)
vc_team2_channel "" - Channel user should join to
vc_team2_channelpw "" - Password of channel

CS: Team 1 = TERRORISTS, Team 2 = CTS
DOD: Team 1 = ALLIES, Team 2 = AXIS

Spectators and unassigned players will join the default channel you define with
the default configuration options.

.: Commands

- These are the pre-configured commands for players. You can change them easily in the .sma -
- Commands are activated both by typing them into say and say_team -

TeamSpeak 2:
- ts2
- teamspeak
- teamspeak2

Ventrilo:
- vent
- ventrilo

Mumble:
- mumble
- murmur

TeamSpeak 3:
- ts3
- teamspeak
- teamspeak3

.: Admin-Commands

voice_ad_now - Displays ads instantly.

.: Advanced configuration

This plugin supports a nickname blacklist. To use this feature you have to put a textfile named "voice_blacklist.txt"
into the configs directory of your servers AMXX installation. Put a list of all names that should not be allowed on
the server, each on a seperate line, into the file. The names are case insensitive.
The list will only be updated on mapchange.

.: Notes

#1 - I do not know which mods support this plugin or not. It was tested and confirmed working on CS and DOD.
Confirmedly not working are the following mods:
- Natural Selection
- Team Fortress Classic
- Ricochet
- Earth's Special Forces
- The Specialists
- Sven Coop

If any other mod is capable of HTML MOTDs let me know and I will implement support for it.

#2 - If you want to have new voicetools merged into the official version feel free to request it, I will likely implement it.
To do that I need the following information: Name, commands and a prototype of the link syntax.

#3 - To specify subchannels for TeamSpeak 3 or Mumble use this syntax: BASECHANNEL/SUBCHANNEL/SUBSUBCHANNEL/...
If the channel structure looks like this:

Gaming
-- CounterStrike
-- -- Terrorists

Specify the channel cvar to be Gaming/CounterStrike/Terrorists and the players will join the Terrorists channel.

#4 - If a channel or subchannel contains '/' chars you will need to escape them by placing a '\' in front of them. Otherwise
Teamspeak 3 (and quite possible Mumble too) will assume that a new subchannel name begins and will not find the correct channel
or no channel at all.

#5 - For Mumble links to work correctly you _have_ to specify the server version using the appropriate server variable.
Mumble requires it and so the generated links will not work without it.

#6 - Although the plugin features URL encoding to support special characters, for some reason some of them will still not work.
This is not the fault of the plugin, though: While the generated links work perfectly fine through a desktop browser they are
apparently not correctly interpreted by the (archaic) ingame browser.
You may have to alter your channel names to not feature special characters if you encounter such problems.

.: Credits

- Thanks to teame06 and all contributors for the ColorChat function.
- Thanks to Exolent for the StringURLEncode function.

.: Translations

Since this plugin supports ML, translations are greatly appreciated and will be added as soon as possible.
Translations can be submitted both in this support thread and the translation request thread.
The following translations are already included:

[en] - Nextra
[de] - Nextra
[fr] - arkshine
[ru] - xPaw
[bp] - joaquimandrade
[nl] - crazyeffect
[es] - fezh
[da] - Multiply
[lt] - hleV
[fi] - SnoW
[sv] - kriixn
[pl] - BeAfraid
[ro] - dorin2oo7
[tr] - RuF
[cz] - CZMadman
[bg] - papyrus_kn
[hu] - KoczkaHUN
[pt] - lagayo

Thanks again to the translators.

.: Changelog ( latest changes )

* 1.1.000
- Converted link building to be entirely on-the-fly. Resulting of this is that all settings/cvars update instantly. This
should fix problems with Ventrilo not parsing some links because of empty parameters.
- Added version specifier for Mumble that is required for versions 1.2.0 through 1.2.6 and generally recommended
- Removed unnecessary subchannel cvar to hopefully make the syntax for specifying subchannels easier to understand.
- Made it possible to specify an almost entirely different set of options for the different teams. Now even two different
servers can be configured if so desired.
- VC will now automatically encode the link parameters that are specified by the cvars, using special characters
in channel names should now work fine.

* 1.1.010
- Added support for RaidCall
-- New cvars vc_[default|team1|team2]_serverid exclusively for RaidCall

* 1.1.015
- Added server password support for Mumble
- Added missing docs regarding the serverversion cvar for mumble
- Added server name support for Mumble

This plugin requires AMXX 1.8.1 or any later version.

.: Servers running the latest version :.
.: Servers running any version :.

.: Downloads: 5043+ :.

This plugin has been broken by the 2013 client updates. It will not work on updated clients (which most are, and everyone will be when the first forced update ships). I can not fix it! It's unapproved for a reason.