Bug fixes, QOL tweaks, and code clean up. (#2404)

* Bug fixes, QOL tweaks, and code clean up.

* Fix regression of relative seek.

config/example_options.ini

@@ -30,6 +30,10 @@ BotExceptionIDs =
 # e.g if you set this to *, the play command would be triggered using *play.
 CommandPrefix = !
 
+# Enable using commands with @[YourBotNameHere]
+# The CommandPrefix is still available, but can be replaced with @ mention.
+CommandsByMention = yes
+
 # Restricts the bot to only listening to certain text channels.
 # Space-separated list of text channel IDs.
 BindToChannels =
@@ -136,6 +140,16 @@ DebugLevel = INFO
 
 # Specify a custom message to use as the bot's status. If left empty, the bot
 # will display dynamic info about music currently being played in its status instead.
+# Status messages may also use the following variables in custom status messages:
+#  {n_playing}   = Number of currently Playing music players.
+#  {n_paused}    = Number of currently Paused music players.
+#  {n_connected} = Number of connected music players, in any player state.
+#
+# The following variables give access to information about the player and track.
+# These variables may not be accurate in multi-guild bots:
+#  {p0_length}   = The total duration of the track, if available. Ex: [2:34]
+#  {p0_title}    = The track title for the currently playing track.
+#  {p0_url}      = The track url for the currently playing track.
 StatusMessage = 
 
 # Write what the bot is currently playing to the data/<server id>/current.txt FILE.
@@ -202,8 +216,7 @@ LeaveInactiveVC = no
 # Default value is 300 seconds.
 LeaveInactiveVCTimeOut = 300
 
-# If enabled, MusicBot will leave the channel immediately when the song queue is empty.
-# Default is set to:  no
+# Sets if if the bot should leave immediately once all songs have finished playing.
 LeaveAfterQueueEmpty = no
 
 # Set a period of seconds that a player can be paused or not playing before it will disconnect.
@@ -216,12 +229,10 @@ LeavePlayerInactiveFor = 0
 # When enabled the bot will automatically rotate between user requested songs.
 RoundRobinQueue = no
 
-# Enable the user block list feature, without emptying the block list.
-# Default is set to:  yes
+# This setting allows you to quickly enable or disable use of User Blocklist. 
 EnableUserBlocklist = yes
 
 # This setting allows you to quickly enable or disable the use of Song Blocklist.
-# Default is set to:  no
 EnableSongBlocklist = no
 
 # Allow MusicBot to use system ping command to detect network outage and availability.

config/example_permissions.ini

@@ -73,11 +73,14 @@
 ;    that the bot is already joined in the server. It is also expected that the user have ability to invoke summon command to
 ;    use this option.
 ;
-;    Extractors = example1 example2
-;    Specify the name of youtube-dl extractors that people will be able to play using the bot. Seperated by spaces.
-;    This is to allow restriction of playing porn videos through the bot, as these are supported by yt-dl. Leave blank to allow all.
-;    For a list of possible extractors, see https://github.com/rg3/youtube-dl/tree/master/youtube_dl/extractor
-;    The generic extractor is used by the bot to query the song when the query text is given via the play command.
+;    Extractors = spotify:musicbot youtube youtube:playlist youtube:tab youtube:search
+;    Specify yt-dlp extractor names that MusicBot will allow users to play media from.
+;    Each extractor name should be separated by spaces.
+;    If left empty, all services will be allowed.  Including porn services.
+;    The yt-dlp project has a list of supported services here:  
+;      https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md
+;
+;    The extractor `spotify:musicbot` is provided by MusicBot, not yt-dlp.
 ;
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;