# impart-pro-plugin

**Repository Path**: sumght/impart-pro-plugin

## Basic Information

- **Project Name**: impart-pro-plugin
- **Description**: yunzai impart
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 24
- **Forks**: 6
- **Created**: 2023-05-20
- **Last Updated**: 2026-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# impart-pro-plugin

> **牛牛大作战** —— Yunzai-Bot 的多人在线互动插件
>
> 过程中无需繁琐操作，自然升级，随机获得道具和武器，解锁成就。

---

## ✨ 特性

- **零外部依赖** —— 无需 Python，无需 MariaDB/MySQL，无需独立后端服务器，插件自带全套游戏引擎
- **即装即用** —— 克隆插件 → 重启机器人 → 开玩
- **事件系统** —— 包含 100+ 随机事件，数据以 Excel 表格形式提供，用户可自行编辑增删
- **天赋/Tag 系统** —— 188 种 tag，影响角色成长和事件触发
- **武器系统** —— 多种武器可获取
- **锅巴 GUI** —— 支持锅巴插件可视化配置

---

## 🚀 安装

### 前置要求

- 已部署 [Miao-Yunzai](https://gitee.com/yoimiya-kokomi/Miao-Yunzai) 或 [Yunzai-Bot V3](https://gitee.com/Le-niao/Yunzai-Bot)
- 已安装 [redis](https://redis.io/)（用于指令冷却功能）

### Git 安装（推荐）

在 Yunzai-Bot 根目录执行：

```sh
git clone https://gitee.com/sumght/impart-pro-plugin.git ./plugins/impart-pro-plugin/
```

重启 Yunzai-Bot 即可使用，最终 impart-pro-plugin 将被放置在 Yunzai-Bot 的 plugins 目录下。

### 可选：如果要用 xlsx 编辑事件表格

如需用 Excel 直接编辑事件数据，需要在 Yunzai 根目录安装 SheetJS 依赖：

```sh
npm install xlsx
```

不安装也不影响使用，插件会使用内置的 JSON 数据文件。

---

## 📖 使用说明

| 指令 | 说明 |
| --- | --- |
| `#银趴帮助` | 查看帮助图 |
| `#生成牛牛` | 开始你的n牛牛一生 |
| `#开导` / `#打胶` | 疯狂求导，增长牛牛长度 |
| `#嗦牛牛` @某人 | 嗦对方的牛牛 |
| `#决斗` @某人 | 发起对决！ |
| `#remake` | 重生，重置角色 |
| `#精神状态查看` / `#查看` | 查看自己/他人的属性状态 |
| `#今日排行` | 查看群内今日排行榜 |
| `#开始银趴` / `#结束银趴` | 群主/管理员开启或关闭本群银趴 |
| `#银趴版本` | 查看版本信息 |
| `#银趴设置` | 主人修改插件配置 |

---

## ⚙️ 配置

配置文件位于 `plugins/impart-pro-plugin/config/config/impart-config.yaml`：

```yaml
ypcd: 65        # 开导 CD（秒）
jjcd: 66        # 决斗 CD（秒）
suonncd: 90     # 嗦牛牛 CD（秒）
noImpart: []    # 黑名单群号
yesImpart: []   # 白名单群号
```

也可通过锅巴插件（Guoba-plugin）直接在管理界面修改。

---

## 📝 自定义事件

事件数据储存在 `resources/data/events.xlsx`（或 `events.json`），用 Excel 即可打开编辑：

| 列 | 说明 |
|---|------|
| 事件 ID | 唯一编号 |
| 名称 | 事件标题 |
| 触发文案 | 触发时显示的文字 |
| 触发条件 | 如 `STR>=5 and TAGS([10000])` |
| 优先级 | 数字越大越优先触发 |
| 效果代码 | 如 `STR=STR+1\|SAN=SAN-5` |
| 添加 Tag | 触发后获得的 tag ID |
| 删除 Tag | 触发后移除的 tag ID |
| 添加武器 | 触发的武器 ID |
| 删除武器 | 触发的武器 ID |

编辑保存后重启机器人即可生效。

---

## ⚡ 技术说明

### 数据存储

- 玩家数据保存在 `data/players/{QQID}.json`，每个玩家一个文件
- 无需数据库，无需 Python 后端
- 数据直观可读，方便迁移和备份

---

## 鸣谢

* [miao-plugin](https://gitee.com/yoimiya-kokomi/miao-plugin) : 使用的 UI 代码及实现均来自 miao-plugin
* [ws-plugin](https://gitee.com/xiaoye12123/ws-plugin) : 代码的实现经由 [xiaoye12123](https://gitee.com/xiaoye12123) 大神的指导
* [Miao-Yunzai](https://github.com/yoimiya-kokomi/Miao-Yunzai) : 喵版 Yunzai
* [Yunzai-V3](https://github.com/yoimiya-kokomi/Yunzai-Bot) ：Yunzai V3 - 喵喵维护版（使用 icqq）
* [Yunzai-V3](https://gitee.com/Le-niao/Yunzai-Bot) ：Yunzai V3 - 乐神原版（使用 oicq）

## 免责声明

1. 功能仅限内部交流与小范围使用，请勿将 Yunzai-Bot 及 impart-pro-plugin 用于以盈利为目的的场景
2. 图片与其他素材均来自于网络，仅供交流学习使用，如有侵权请联系，会立即删除