🤖 vcbot-napcat – 基于 NapCat 的 Velocity QQ 机器人

---

一款基于 NapCat 构建的 QQ 机器人，对接 Velocity 服务器。支持在线查询、玩家绑定、全服喊话等功能

QQ交流群

🚀 主要功能

• ✅ 入群欢迎消息
• 🚪 退群提醒
• 🤝 自动添加好友
• 📡 列出服务器在线人数
• 🔍 查询指定玩家是否在线
• 🔐 绑定游戏账户
• 📢 全服广播喊话

[开发中功能]

• 使用/find @用户 查找玩家知否在线
• 智能问答

🛠️ 部署指南

环境要求

安装python > 3.9

安装步骤

1. 下载本项目最新源码：

   git clone https://github.com/xyit2025/vcbot-napcat.git
   

2. 安装依赖库
3. 运行 main.py

vc插件请见 GitHub - xyit2025/vcapi

配置

配置文件：

        #napcat配置
        bot_qq = 123456 #机器人q号
        root_qq = 1234567 # 管理员q号
        ws_uri = "ws://localhost:3001" # ws 地址, 可自定义端口, 默认 3001
        webui_uri = "http://localhost:6099" # webui 地址, 可自定义端口, 默认 6099
        webui_token =  "napcat" # webui 令牌, 默认 napcat
        ws_token = "" # ws_uri 令牌, 默认留空
        ws_listen_ip = "localhost" # ws_uri 监听 ip, 默认 localhost 监听本机，监听全部则配置 0.0.0.0
        remote_mode = false # 是否远程模式, 即 NapCat 服务不在本机运行 ps：ncatbot官方已废弃该参数

        # 功能配置
        allowed_groups = "all" # 授权群聊，all为全部，eg：[123456789, 987654321]
        allowed_users = "all" # 授权用户，all为全部，eg：[123456789, 987654321]
        velocity_ip = "127.0.0.1" # velocity ip
        velocity_port = 8080 # velocity port
        velocity_token = "your velocity_token" #`velocity token
        friend_auto = true # 好友自动同意
        group_auto = true # 无作用
        group_welcome = true # 入群欢迎
        group_welcome_message = "!at 欢迎加入本群，使用@bot /help获取此bot帮助" # 入群消息 !at 为@加群用户
        group_leave = true # 退群提醒
        group_leave_message = "用户{userid}退群了" # 退群消息 ，{userid}为退群用户id

参与开发

由于部分原因，我们的代码均在私有git开发。 如希望参与开发请联系我们