# BistroBot

**Repository Path**: myKasa/BistroBot

## Basic Information

- **Project Name**: BistroBot
- **Description**: BistroBot 酒馆机器人框架
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-13
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BistroBot

BistroBot 是一个基于 OneBot 协议的 Minecraft Spigot 插件，用于连接游戏与机器人平台，实现跨平台消息互通。

## 功能特性

- **跨平台通信**：支持 Minecraft 与机器人平台（如 QQ）之间的消息转发
- **多语言支持**：提供中文等多语言界面
- **自动重连机制**：包含断线自动重连功能
- **消息格式化**：支持颜色代码和占位符替换
- **插件集成**：提供 Bukkit/Spigot 事件系统集成
- **性能监控**：内置插件使用情况统计功能

## 安装指南

1. 下载最新版本的 BistroBot 插件
2. 将插件文件放入服务器 plugins 文件夹
3. 启动服务器完成插件初始化
4. 编辑 `plugins/BistroBot/config.yml` 配置连接参数
5. 使用 `/bistrobot reload` 命令加载配置

## 配置说明

- `config.yml`：主配置文件，包含机器人连接参数
- `lang/zh_CN.yml`：中文语言文件
- `lib.properties`：依赖库配置

## 使用示例

```yaml
# config.yml 示例配置
bots:
  - id: 10001
    enable: true
    autoConnect: true
    autoReconnect: true
    type: "qq"
    url: "ws://127.0.0.1:8080"
    accessToken: "your_token_here"
```

## 事件系统

插件提供 Bukkit 兼容的事件系统，可监听处理以下事件：

- `SpigotGroupMessageEvent`：群组消息事件
- 自定义插件事件（通过 `PluginBotEvent`）

## 依赖管理

插件使用 Maven 进行依赖管理，核心模块包括：

- `bistro-bot-core`：核心功能模块
- `bistro-bot-onebot`：OneBot 协议实现
- `bistro-bot-spigot`：Spigot 插件实现

## 开源许可

本项目采用 MIT 许可协议，详细信息请参阅 LICENSE 文件。

## 版本更新

插件支持配置文件版本检查与自动升级功能，确保配置文件格式与插件版本兼容。

## 性能监控

内置插件使用情况统计功能，可收集以下数据：

- 服务器在线玩家数
- 插件配置信息
- 系统运行状态

如需禁用数据收集功能，可在 `config.yml` 中设置 `metrics: false`。