# ZZZ-Plugin

<p align="center">
  <a href="https://github.com/ZZZure/ZZZ-Plugin"><img src="https://s2.loli.net/2024/04/19/hOEDmsoUFy6nH5d.jpg" width="480" height="270" alt="ZZZ-Plugin"></a>
</p>
<h1 align = "center">ZZZ-Plugin</h1>
<h4 align = "center">🚧Yunzai绝区零Bot插件 ｜ 交流群 973399270🚧</h4>

> [!tip]
> 说明
> 
> 插件依靠社区维护，发起者随缘更新，但是ZZZure组织成员会对PR进行合并，你可以在PR页面@协助者进行合并。

# 安装

进入Yunzai根目录运行以下命令进行安装：

```bash
git clone --depth=1 https://github.com/ZZZure/ZZZ-Plugin.git ./plugins/ZZZ-Plugin
```
> [!tip]
> 如果您的网络环境较差，建议使用代理加速
> ```
> git clone --depth=1 https://mirror.ghproxy.com/https://github.com/ZZZure/ZZZ-Plugin.git ./plugins/ZZZ-Plugin
> ```

安装后重启Yunzai即可使用。

## 注意

刷新抽卡链接需要“[逍遥插件](https://github.com/ctrlcvs/xiaoyao-cvs-plugin)”支持。需要刷新抽卡链接功能请安装逍遥插件。

# 功能

以下所有功能前缀为：`#zzz`、`%`、`#ZZZ`、`#绝区零` 任选其一

![功能图片](https://s2.loli.net/2024/07/31/BJrDm6OLh2AIj1N.jpg)

## 攻略、图鉴

**攻略、图鉴建议使用第三方插件**，本插件的攻略功能是在没有专业插件的情况下的保底功能。

推荐使用的图鉴插件：

* [Atlas](https://github.com/Nwflower/Atlas)
  Atlas是一个适用于V3版本及以上Yunzai-Bot的图鉴查询插件，可通过Yunzai-Bot查询游戏图鉴，插件代码严格遵循ES6规范。
* [Mora-Plugin](https://gitee.com/Rrrrrrray/mora-plugin)
  Mora-Plugin是一个Yunzai-Bot的插件 仅用于自我学习其他优秀插件

## 自定义面板图

将你下载的面板图放在`zzz插件目录/resources/images/panel/[角色名简称]/`文件夹下。若文件夹不存在请自行创建。

**角色名简称**请参考官方wiki中代理人名称：[米游社·绝区零 绳网情报站](https://baike.mihoyo.com/zzz/wiki/channel/map/2/43)

**请注意**：

执行`%删除全部资源`也会删除自定义面板图，该指令用于将插件回归原始状态（数据除外）。

# 贡献

请先 `fork` 本仓库，修改并测试完成后提交PR。

**请注意：**

* 你的 CSS 必须是 `scss` 编写

# 鸣谢

* 特别鸣谢 **[Wuyi无疑](https://github.com/KimigaiiWuyi)** 为 `ZZZeroUID` 和 `ZZZ-Plugin` 作出的巨大贡献！本插件的功能按照 **Wuyi无疑** 的设计进行编写。欢迎给本仓库以及 [`ZZZeroUID`](https://github.com/ZZZure/ZZZeroUID) 点个 Star！
* 特别鸣谢以下攻略作者：
  * 新艾利都快讯
  * 清茶沐沐Kiyotya
  * 小橙子阿
  * 猫冬
  * 月光中心

## 仓库贡献者

<a href="https://github.com/ZZZure/ZZZ-Plugin/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=ZZZure/ZZZ-Plugin" />
</a>

## Reportbeats
![Alt](https://repobeats.axiom.co/api/embed/613a1e7717c6651ca1b725ceb710f6dc03fdb937.svg "Repobeats analytics image")

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=ZZZure/ZZZ-Plugin&type=Date)](https://star-history.com/#ZZZure/ZZZ-Plugin&Date)

# 其他

* 本项目仅供学习使用，请勿用于商业用途
* [GPL-3.0 License](./LICENSE)
