一个允许玩家控制生物生成的Spigot插件。
[Wiki](https://github.com/BingZi-233/OneBot/wiki) | [Issues](https://github.com/BingZi-233/OneBot/issues)
## ✨ 特性
- 🔌 **协议支持** - 完全支持 OneBot v11/v12 协议
- 🎮 **广泛兼容性** - 与 Minecraft 1.8-1.21+ 服务器兼容
- 🚀 **高性能** - 基于 TabooLib 框架以实现最佳性能
- 🔧 **易于配置** - 流行 OneBot 实现的预配置模板
- 📊 **指标集成** - 内置 bStats 指标用于使用分析
- 🌍 **国际化** - 多语言支持，支持 i18n
- 🔄 **实时同步** - 游戏和聊天平台之间双向消息转发
- 🎨 **富文本支持** - 完全支持 Minecraft 聊天组件和格式
## 📋 要求
- **Java**: 8 或更高版本
- **服务器**: Bukkit/Spigot/Paper 1.8-1.21+
- **内存**: 建议至少 2GB
- **OneBot 实现**: 任何 OneBot v11/v12 兼容的服务器 (例如, go-cqhttp, Lagrange.OneBot)
## 🚀 快速开始
### 安装
1. **下载插件**
- 从 [Releases](https://github.com/BingZi-233/OneBot/releases) 获取最新版本
- 选择文件: `OneBot-x.x.x.jar`
2. **安装到服务器**
```bash
# 将 JAR 文件放置到服务器的 plugins 目录下
cp OneBot-*.jar /path/to/server/plugins/
```
3. **启动/重启服务器**
```bash
# 重新启动你的 Minecraft 服务器
/reload
# 或
/stop && ./start.sh
```
### 配置
1. **列出可用的预设**
```bash
/onebot preset list
```
2. **应用预设配置**
```bash
# 对于 go-cqhttp
/onebot preset apply go-cqhttp
# 对于 Lagrange.OneBot
/onebot preset apply lagrange
```
3. **连接到 OneBot 服务器**
```bash
/onebot connect
```
4. **检查连接状态**
```bash
/onebot status
```
## 📁 项目结构
```
OneBot/
├── src/
│ └── main/
│ ├── kotlin/ # Kotlin 源代码
│ └── resources/ # 资源文件
│ ├── config.yml # 主配置文件
│ └── lang/ # 语言文件
├── build.gradle.kts # 构建配置文件
└── settings.gradle.kts # 项目设置
```
## 🔧 开发
### 从源代码构建
```bash
# 克隆仓库
git clone https://github.com/BingZi-233/OneBot.git
cd OneBot
# 构建插件
./gradlew build
# 输出 JAR 将在 build/libs/ 目录下
```
### 开发设置
对于想要将 OneBot 作为依赖项使用的开发者：
```bash
# 构建 API JAR (不包含实现)
./gradlew taboolibBuildApi -PDeleteCode
```
### Maven 依赖
```xml
**Made with ❤️ by [BingZi-233](https://github.com/BingZi-233)**
[报告 Bug](https://github.com/BingZi-233/OneBot/issues/new?labels=bug) · [请求 功能](https://github.com/BingZi-233/OneBot/issues/new?labels=enhancement) · [加入 讨论](https://github.com/BingZi-233/OneBot/discussions)