ts3MusicBot

• English
• Zh

👋Introduction

A simple python bot based on TS3AudioBot for teamspeak3.

基于TS3AudioBot的简易teamspeak3机器人框架。

🚩Features

• 🎵基础音乐功能
  • 播放音乐
  • 歌单管理
  • 多曲库API管理
  • ....
• 🤖聊天功能：接入大模型供聊天。
• 🐶宠物功能：创建宠物并进行战斗。
• 📢广播功能: TTS广播。
• 自定义指令。
• 自定义API。
• ....

⚙️Installation

首先必须安装TS3AudioBot。

git clone https://github.com/Joooook/ts3MusicBot
pip install -r requirements.txt

▶️Quick Start

请务必查看使用指南。

from apis.chatApi.ChatApi import ChatApi
from apis.petApi.PetApi import PetApi
from apis.ttsApi.TTSApi import TTSApi
from TS3Bot import TS3Bot,my_commands
from examples.ExampleMusicApi import ExampleMusicApi
if __name__ == '__main__':
    bot_api = "http://x.x.x.x:58913"
    chat_api_key = "sk-xxxxxxxxxxx"
    tts_api = "www.?.?"
    password= 'password'
    server_host = 'xxx.xxx.xxx.xxx'
    bot = TS3Bot('serveradmin', password, bot_api, server_host)
    # 创建并注册api
    example_music_api = ExampleMusicApi("https://www.xxxxxxx.xxxxx/")
    bot.register_music_api(example_music_api,"default",priority=50)
    bot.chat_api = ChatApi(chat_api_key)
    bot.pet_api = PetApi(chat_api_key)
    bot.tts_api = TTSApi(tts_api)
    # 注册指令
    bot.register_commands(my_commands)
    bot.run()

⚠️Notice

尽管机器人内置了很多基础功能，本项目也并非一个开箱即用的项目，需要进行二次开发，尤其是音乐API部分。

👉️Reference

• ZHANGTIANYAO1/TS3AudioBot-NetEaseCloudmusic-plugin
• Splamy/TS3AudioBot
• benediktschmitt/py-ts3
• Binaryify/NeteaseCloudMusicApi

💭Murmurs

一开始我在我的服务器上使用的是 ZHANGTIANYAO1/TS3AudioBot-NetEaseCloudmusic-plugin。 但是由于不可抗力网易云音乐的API现在不能用了很多歌都听不了了。因此我干脆自己写一个。但是Teamspeak又没有Python SDK，所以我只好用pyts3来配合Ts3AudioBot来实现。Python的易扩展性显然更适合开发机器人。

本项目仅抛砖引玉，欢迎催更。

☕️Donate

请我喝杯奶茶吧。