进入 Yunzai 根目录，请根据网络情况选择运行下述指令之一：

使用 github

git clone --depth=1 https://github.com/ZZZure/ZZZ-Plugin.git ./plugins/ZZZ-Plugin

使用 gitee

git clone --depth=1 https://gitee.com/bietiaop/ZZZ-Plugin.git ./plugins/ZZZ-Plugin

安装后重启 Yunzai 即可使用。

刷新抽卡链接需要“逍遥插件”支持。需要刷新抽卡链接功能请安装逍遥插件。

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

自定义评分权重 请查看 此教程

自定义伤害计算 请查看 此教程

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

推荐使用的图鉴插件：

• Atlas Atlas 是一个适用于 V3 版本及以上 Yunzai-Bot 的图鉴查询插件，可通过 Yunzai-Bot 查询游戏图鉴，插件代码严格遵循 ES6 规范。
• Mora-Plugin Mora-Plugin 是一个 Yunzai-Bot 的插件 仅用于自我学习其他优秀插件

注意：未自定义角色面板图时，若穿戴角色时装，立绘会自动显示为时装立绘。自定义面板图后该功能失效

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

角色名称 可以是 米游社绳网情报站 中显示的代理人 简称 或 全称，也可以是 插件数据 PartnerId2Data 中的 name 或 full_name。四个路径依序检测，取第一个存在的路径中的面板图

若要查看或者批量删除自定义面板图，请发送指令 %帮助 进行查看如何使用相关指令。

遭遇验证码是不可避免的，这是米游社保护账号的一种方式，机器人的所有请求在米游社看来都是非法的，因此 大概率 会遭遇验证码。

如果你需要绕过验证码，请使用第三方插件。或者到交流群里询问他人使用的方法（请务必声明你 已经 阅读过 README 内容）。

发送 %设置默认设备 可修改本插件自带默认设备参数，或使用锅巴插件进行修改。

本插件会自带一个默认设备参数模拟真机进行请求，但是这个设备参数会被所有使用本插件的用户共同使用，因此 大概率 会遭遇账号异常，因此在遇到米游社抛出对应错误时，需要每个人绑定 已经登陆米游社账号的常用设备参数 进行请求。

如果需要绑定设备，请发送 %绑定设备帮助 进行查看如何绑定。第一种方法就是抓包，此种方法危害性较小，技术难度相对较高，但是 IOS 与 Android 设备通用。

使用方法二绑定设备操作方便，仅需下载一个 开源软件 复制设备信息即可，仅适用于 Android 设备，但是其他人会看到你的设备基本信息如型号、ID 标识符等，需要提醒用户慎重选择。

如果认为以上两种方法麻烦，你可以自己尝试探索出其他未发现的方法。

绑定设备 无法 100%解决 账号异常问题。

若通过默认的米游社更新面板遇见账号异常问题，可尝试 %更新展柜面板，这将调用 Enka 接口更新游戏内展示的角色的数据。如若通过此方法更新的角色数据与实际不一致，请 提出 issue

该服务可能偶尔无法使用，如更新展柜面板一直请求失败，可通过锅巴修改 自定义enkaApi地址 项来自定义请求链接，请求和返回与 Enka 格式一致皆可

由于历史代码缘故，以前在游戏资源未更新就进行资源下载的可能导致角色图片缺失，你可以到插件资源目录手动删除对应文件，或者执行命令 %删除全部资源 进行删除。删除全部资源指令目前 不会 删除自定义面板图，仅会删除下载的图片资源，再次使用时需重新下载图片（自动下载）。

如果你不需要更新推送，发送 %关闭更新推送 即可关闭更新推送，如果需要推送发送 %开启更新推送 即可开启更新推送。

此功能目前为默认关闭状态，如果你更新插件过早，可能会默认为开启状态，此时需要你发送指令进行关闭。

此功能仅针对不及时更新插件并且到群里询问已解决的 bug 的用户。

请先 fork 或切换至 本仓库 dev 分支，修改 dev 分支 并测试完成后提交 PR。

请注意：

• 提交前请确保本地已运行 pnpm check，能够成功通过且无报错

• 代码风格请参考 eslint.config.mjs

  • 代码自检：pnpm lint
  • 自动修复：pnpm lint:fix

• 在宿主环境下（如将插件安装于 Miao-Yunzai 中进行开发），可使用 tsconfig.json 作为 ts 环境配置

  • 全部编译：pnpm build
  • 监听编译：pnpm watch

• 在脱离宿主环境下（如独立开发或在 github actions 中编译），可使用 tsconfig.src.json 作为 ts 环境配置

  • 全部编译：pnpm build:src
  • 监听编译：pnpm watch:src

• 本项目的样式使用 scss 编写

• 项目的 scss 文件集中在 resources 的子目录，开发时请编写/修改 scss，请勿提交 css

  • 全部编译：pnpm build:css
  • 监听编译：pnpm watch:css

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

• 本项目仅供学习使用，请勿用于商业用途
• GPL-3.0 License