A plugin-based All-In-One mumble bot solution in python 3.7+ with extensive features and support for custom plugins.
GPL-3.0 License
Published by DuckBoss over 4 years ago
!help: Displays a list of the help commands for all the available plugins.
(or)
!help 'plugin_name': Displays all the commands available for the given plugin.
!comment 'comment_text': Sets the bot's user comment with the given text.
!resetcomment: Resets the bot's user comment to the default text.
Published by DuckBoss over 4 years ago
Published by DuckBoss over 4 years ago
!sbskip 'seconds' : Skips ahead in the current sound board track by the given amount of seconds.
Published by DuckBoss over 4 years ago
!sbloop 'sound_clip': Plays a locally saved wav file, but endlessly loops until it is stopped.
!loop: Toggles the loop mode for the youtube plugin.
Published by DuckBoss over 4 years ago
!sbplaying: Displays the current sound board clip that is being played and the duration of the clip.
Published by DuckBoss over 4 years ago
Published by DuckBoss over 4 years ago
Published by DuckBoss over 4 years ago
JJMumbleBot has been updated through multiple python revisions,
and with this update it will now require Python 3.7 or higher.
There is now a global_aliases.csv file that must be placed in the JJMumbleBot/cfg/ directory, which will function similarly as the previous versions of the aliases.csv file.
In addition, individual plugins now require an aliases.csv file which will contain any command aliases related to that plugin.
The directory structure of this new system can be seen in the Plugins section below.
Plugins are now separated into 'core' and 'extensions' folders.
Third party plugins that extend the functionality of the bot should be placed in the 'extensions' folder.
Various changes such as separating the help data and metadata into individual files have been made to improve the development and functionality of plugins.
Due to these changes, all existing custom third party plugins must be updated to the new format.
Plugins now require the following base heirarchy:
Any additional utility files, scripts, folders or media can be added to this.
For more information on creating custom plugins, look at this documentation. ADD DOC HERE
The core commands of the bot service has now been separated into it's own core plugin.
This plugin contains all critical service commands for the bot.
This includes all commands relating to aliases, rebooting, refreshing plugins, exiting the bot, etc.
Added new commands:
!clearhistory
Added new commands:
!remove
A plugin that allows users to type messages that can be read out by various TTS voices.
The plugin also allows users to download TTS clips to be played at a later time like the sound board plugin.
!tts 'voice_name' 'message'
!ttsvoices
ttsdownload 'clip_name' 'voice_name' 'message'
!ttsplay 'clip_name'
!ttsdelete 'clip_name'
!ttsv '0...1'
...
A plugin that allows server administrators to check for bot dependency updates and update dependency packages as necessary
through commands in the plugin.
!checkforupdates youtube-dl
!updatedependency pymumble
The previous web interface plugin implementation was very messy and experimental.
I will be releasing v3.0.0 without a web interface plugin, and will work on implementing
it properly in the near future.
For the full list of default aliases, please check the documentation provided here. ADD DOC HERE
Users can now set what plugins are included in safe mode by modifying the 'SafeModePlugins' list in their bot config.
Please note that you should always include the 'bot_commands' and 'core_commands' plugins in the list of safe mode plugins!
Published by DuckBoss over 4 years ago
Published by DuckBoss over 5 years ago
Note: Dependencies in this release may be outdated. Please update them after installation.
Published by DuckBoss over 5 years ago
Published by DuckBoss over 5 years ago
Published by DuckBoss over 5 years ago
⚠️ This update modifies how echo/private commands are handled by the bot. Whisper targets override some echo commands such as !queue, !playlist, etc since they are the audio thread users. Other commands like !echo, !move, etc ignore whisper targets when sent by other users. This makes a lot of sense once you start to use commands with/without whispering enabled.
!setwhisperuser 'username' --> Sets the whisper target to the given user
!setwhisperchannel 'channelname' --> Sets the whisper target to the given channel
!clearwhisper --> Clears any previously set whisper target
!setwhisperme --> Sets the whisper target to the command sender.
!addwhisperuser 'username' --> Adds the given user to the whisper targets
!removewhisperuser 'username' --> Removes the given user from the multi-user whisper targets
!getwhisper --> Displays the current whisper target, if any.
Published by DuckBoss over 5 years ago
⚠️ Existing users will have to update their config.ini files with the new properties from the sample_config.ini template file under the templates directory.
Published by DuckBoss over 5 years ago
!sbreplay
command for the sound board plugin.!imgl --> !imglist
!imgle --> !imglist_echo
!pl --> !playlist
!streamfront --> !linkfront
!rand_help --> !randomizer_help
Published by DuckBoss over 5 years ago
⚠️ For existing users, this update contains changes to your config.ini file. Please look at the sample_config.ini file in the template folder.
⚠️ This update also contains changes to plugins which will require any custom user-made plugins to be updated. The changes are listed below.
!autoplay
command to enable/disable autoplay for the youtube queue.Usage:
!autoplay --> enables autoplay if disabled, disables if enabled.
!remove
command to remove tracks from the youtube queue.Usage:
!remove 5 --> Removes the 5th track in the queue (you can view the queue with !queue)
!linkfront
command to priority insert direct link videos to the front of the queue!link
command but inserts to the front instead of the back of the queue,Usage:
!linkfront my_yt_link --> Adds direct link video to the front of the queue
!queue
command now wraps the resulting list like the !sblist/!imglist
commands so that it doesn't hit the mumble text limit if the user allows very large queues.!uptime
command to properly display the elapsed timePublished by DuckBoss over 5 years ago
For existing users, this update contains changes to your config.ini file. Please look at the sample_config.ini file in the template folder.
(Added 'Youtube_MaxPlaylistLength=50' and 'Youtube_AllowPlaylistMax=true' under 'Plugin_Settings' section)
!playlist
command which will add all the songs in a youtube playlist to the queue.Usage:
!playlist my_youtube_playlist_link --> Adds all the songs from the playlist into the queue.
!skipto
command which will skip to the given track number in the queue.Usage:
!skipto 5 --> Skips to track #5 in the queue.
!shuffle
command which will shuffle the tracks in the queue.Usage:
!shuffle --> Shuffles all the tracks in the queue.
!skipto
and !shuffle
to the youtube privileges csv file with a default privilege level of 2.Youtube_MaxPlaylistLength
in the config.ini file (default=50) which will limit the number of videos from a youtube playlist.Youtube_AllowPlaylistMax
in the config.ini file (default=true) which will allow users to play playlists up to the playlist length limit instead of rejecting the playlist if it exceeds the length limit.!clear
command in the youtube plugin now deletes temporary thumbnail images when the queue is cleared.Published by DuckBoss over 5 years ago
For existing users, this update contains changes to your config.ini file. Please look at the sample_config.ini file in the template folder.
(Added 'Images_FrameColor=black' and 'Images_FrameSize' under 'Plugin_Settings' section)
Example: Changing 'Images_FrameColor' value to 'blue' in the config (default=black):
This changes the frame around the image to the color blue.
Example: Changing 'Images_FrameSize' value to '0' in the config (default=5):
This changes the frame size around the image to 0 (no frame).
Image Source - Commons.wikimedia.org
Published by DuckBoss over 5 years ago
The PGUI System now has limited image support which is implemented in the youtube plugin update.
Since the PGUI System has image support, the youtube plugin can now show you the youtube thumbnail for the currently playing video.
The !song
command has also been updated to show thumbnail images.
New "Now Playing..." Message Examples:
In previous versions of JJMumbleBot, updating the bot overwrote configured config.ini files which made it inconvenient to update and reconfigure files every update. To resolve this, the bot now provides a 'sample_config.in' file in the templates folder which users must copy to the bot's root directory, rename it to 'config.ini' and configure as they please.
This is useful for existing users, who don't want their config files overwritten every update
I've updated the wiki's quick start guide to reflect this change for new users.
!sblist/!imglist
type commands.!song
command in the youtube plugin displays the thumbnail when showing the current song.Published by DuckBoss over 5 years ago
You can now change the default canvas colors, text colors, etc for the PGUI System in the config.ini file and customize it to your liking.
For more information on the Pseudo-GUI (PGUI) System, check the v1.8.0 release notes:
v1.8.0 Release
!imglist_echo
command to privileges file