Add help command.

commands.go

@@ -67,6 +67,13 @@ func parseCommand(user *gumble.User, username, command string) {
 		} else {
 			user.Send(NO_PERMISSION_MSG)
 		}
+	// Help command
+	case dj.conf.Aliases.HelpAlias:
+		if dj.HasPermission(username, dj.conf.Permissions.AdminHelp) {
+			help(user)
+		} else {
+			user.Send(NO_PERMISSION_MSG)
+		}
 	// Volume command
 	case dj.conf.Aliases.VolumeAlias:
 		if dj.HasPermission(username, dj.conf.Permissions.AdminVolume) {
@@ -232,6 +239,11 @@ func skip(user *gumble.User, username string, admin, playlistSkip bool) {
 	}
 }
 
+//Preforms help functionality. Displays a list of valid commands.
+func help(user *gumble.User) {
+	user.Send(HELP_MSG)
+}
+
 // Performs volume functionality. Checks input value against LowestVolume and HighestVolume from
 // config to determine if the volume should be applied. If in the correct range, the new volume
 // is applied and is immediately in effect.

mumbledj.gcfg

@@ -51,6 +51,10 @@ SkipPlaylistAlias = "skipplaylist"
 # DEFAULT VALUE: "forceskip"
 AdminSkipAlias = "forceskip"
 
+# Alias used for help command
+# DEFAULT VALUE: "help"
+HelpAlias = "help"
+
 # Alias used for volume command
 # DEFAULT VALUE: "volume"
 VolumeAlias = "volume"
@@ -103,6 +107,10 @@ AdminAddPlaylists = false
 # DEFAULT VALUE: false
 AdminSkip = false
 
+# Make help an admin command?
+# DEFAULT VALUE: false
+AdminHelp = false
+
 # Make volume an admin command?
 # DEFAULT VALUE: false
 AdminVolume = false

parseconfig.go

@@ -31,6 +31,7 @@ type DjConfig struct {
 		SkipPlaylistAlias      string
 		AdminSkipAlias         string
 		AdminSkipPlaylistAlias string
+		HelpAlias              string
 		VolumeAlias            string
 		MoveAlias              string
 		ReloadAlias            string
@@ -44,6 +45,7 @@ type DjConfig struct {
 		AdminAdd          bool
 		AdminAddPlaylists bool
 		AdminSkip         bool
+		AdminHelp         bool
 		AdminVolume       bool
 		AdminMove         bool
 		AdminReload       bool

strings.go

@@ -82,6 +82,23 @@ const PLAYLIST_SKIPPED_HTML = `
 	The number of votes required for a skip has been met. <b>Skipping playlist!</b>
 `
 
+// Message shown to display bot help commands.
+const HELP_MSG = `
+	<b>User Commands:</b>
+	<p><b>!help</b> - Displays this help.</p>
+	<p><b>!add </b>- Adds songs to queue.</p>
+	<p><b>!skip</b> - Casts a vote to skip the current song</p>
+	<p> <b>!skipplaylist</b> - Casts a vote to skip over the current playlist.</p>
+	<p style="-qt-paragraph-type:empty"><br/></p>
+	<p><b>Admin Commands:</b></p>
+	<p><b>!reset</b> - An admin command that resets the song queue. </p>
+	<p><b>!forceskip</b> - An admin command that forces a song skip. </p>
+	<p><b>!forceskipplaylist</b> - An admin command that forces a playlist skip. </p>
+	<p><b>!move </b>- Moves MumbleDJ into channel if it exists.</p>
+	<p><b>!reload</b> - Reloads mumbledj.gcfg configuration settings.</p>
+	<p><b>!kill</b> - Safely cleans the bot environment and disconnects from the server.</p>
+`
+
 // Message shown to users when they ask for the current volume (volume command without argument)
 const CUR_VOLUME_HTML = `
 	The current volume is <b>%.2f</b>.