AlliedModders - [ANY] MumbleMan

MumbleMan v1.0.3
By iGib.Hawkeye

This mod is designed to allow players to join a Mumble Server (Murmur) via in-game commands.

Features

· Fully configurable by CVARs
· Config file created automatically by plugin
· Autoupdate support

Requirements

Required for usage

· Latest Metamod:Source build: link
· Latest Sourcemod build: link

Recommended

· Socket extension (only if autoupdater is used): link
· Plug-in Autoupdater: link

Server CVars

mumbleman_version
- Version of MumbleMan currently running.
mumbleman_server
- FQDN of the mumble server. (def: mumble.domain.tld)
mumbleman_port
- Port of the mumble server. (def: 64378 )
mumbleman_password
- Password for the mumble server. (def: NULL)
mumbleman_channelpath
- Path to base channel on the server. (def: Server)
mumbleman_clientversion
- Version of the mumble client to use. (def: 1.2.0)
mumbleman_teamchannels
- If mumbleman should utilize team specific channels. (def: 0)
mumbleman_team1name
- Name of channel for team 1 (def: Spectator)
mumbleman_team2name
- Name of channel for team 2. (def: Team%20A)
mumbleman_team3name
- Name of channel for team 3. (def: Team%20B)
mumbleman_filterchars
- Characters that should be filtered out of user names. (def: "()[]{}")

Commands

Client Commands

sm_mumble
- Allows players to join the designated Murmur server in the specified channel.
- Example: sm_mumble

Quick Installation

Copy the compiled MumbleMan.smx file and place it the plugins directory.

<mod>/addons/sourcemod/plugins

Copy the translation file to the translation folder

<mod>/addons/sourcemod/translations

Load the plugin via sm plugins load MumbleMan
Modify the created config file

<mod>/cfg/sourcemod/plugin.mumbleman.cfg

Example Config file

PHP Code:


		
			
// This file was auto-generated by SourceMod (v1.3.0-dev)
// ConVars for plugin "mumbleman.smx"
&#12288;
// Path to the base channel on the server.
// -
// Default: "Server"
mumbleman_channelpath "Servers/TF2%20-%20Chicago"
 
// Version of the Mumble client to use.
// -
// Default: "1.2.0"
mumbleman_clientversion "1.2.0"
 
// Passowrd for mumble server.
// -
// Default: ""
mumbleman_password ""
 
// Port of the mumble server.
// -
// Default: "64738"
mumbleman_port "64738"
 
// FQDN of mumble server.
// -
// Default: "mumble.domain.tld"
mumbleman_server "mumble.instagib.org"
 
// Characters that should be filtered out of usernames.
// -
// Default: "()[]{}"
mumbleman_filterchars "()[]{}"
 
// Name of Channel for Team 1.
// -
// Default: "Spectator"
mumbleman_team1name "Spectator"
 
// Name of Channel for Team 2.
// -
// Default: "Team%20A"
mumbleman_team2name "RED"
 
// Name of Channel for Team 3.
// -
// Default: "Team%20B"
mumbleman_team3name "BLU"
 
// Whether team specific channels should be used.
// -
// Default: "0"
mumbleman_teamchannels "1"

Change Log

1.0.0
- First public release
1.0.1
- Autoupdate feature has been enabled
- Multi-lingual support enabled
1.0.2
- Added automated team switch
1.0.3
- Added configurable character filter ability

Notes
This mod was slammed together in about 30 minutes to prevent me from having to tab out and move players around during Pick-up games. It has the optional ability to have team specific channels for PuGs and so forth.

I saw a few requests to update the existing plugin with Mumble support, not sure if that will happen but decided to share this one.

The autoupdate feature is now enabled.

Translation support is enabled, english is provided as I do not trust google on most of the languages.

Please be aware, in your channelpath, team#name cvars to replace spaces with %20 since I am just using these to generate the URL. An example would be "Team A" becomes "Team%20A"

The clientversion CVAR is designed to accomodate the 1.2 Beta release which has a slightly different protocol. If the version specified is 1.1.0 your existing mumble clients (the Legacy client in 1.2) will be used, if 1.2.0 is used it will use the 1.2.0 client.

The character filter subroutine is basically a copy paste of berni's function with really minor edits to have it pull from the CVAR. All credit to that routine goes to him.