koishi-plugin-genshin

Koishi 原神大礼包（Genshin Impact for Koishi.js）是一个为koishi设计的查询展示原神国服玩家数据以及抽卡模拟的插件。

特色功能

喜欢玩《原神》？懒得下载米游社？想和沙雕群友一起凹数据？那么本插件将会是您的不二之选！来给您的群聊安排一只能查询原神数据的 koishi 机械姬吧~

为您的机械姬安装本插件，玩家们无需打开米游社，向 koishi bot 发送指令，一键炫耀您的五星角色、五星武器和深渊数据！

想看看自己是不是非酋？想要成为下一个天选之人？向 koishi bot 发送指令，进行模拟抽卡吧！

截图展示

玩家资料卡 (genshin.profile)

角色展示卡 (genshin.character)

安装方法

# Via yarn
yarn add koishi-plugin-genshin
# Or via npm
npm install koishi-plugin-genshin

使用指南

具体用法请使用help genshin查看（作者只是懒得写文档）

系统需求

需要配合最新版 koishi v3。需要配置数据库，暂时只保证兼容 MongoDB。

若要使用完整的“卡片”功能，需要配置并安装 koishi-plugin-puppeteer。

配置项目

插件目前需要使用您的网页版米游社的 cookie 来获取玩家信息。

使用网页版米游社登录 https://bbs.mihoyo.com/ys/，然后在控制台输入 document.cookie，返回的结果就是 cookie，一般来说只要没有进行修改密码、换绑手机或点击退出按钮等操作，当前 cookie 便能长久使用，如果失效了就重新登录获取一遍。

⚠️ 注意 ⚠️：请妥善保存您的 cookies。
绝对不要把你的 cookies 交给任何人！
绝对绝对不要把你的 cookies 交给任何人！！
绝对绝对绝对不要把你的 cookies 交给任何人！！！

安装插件，详见 官方指南。

配置示例

// koishi.config.js
module.exports = {
  plugins: {
    // ...
    genshin: {
      // 本插件的配置项
    }
    // ...
  }
}
// 当然如果您是 index.js 玩家也可以这样
App.plugin(require('koishi-plugin-genshin'), {
  // 本插件的配置项
})

自定义输出排版，可以使用 koishi 的 template 语法，由于字符串太多，《请您读源码.jpg》。

可用配置项

• cookie {string} 您的米游社小饼干
• wish {object}
  • wish.enable {boolean} 是否开启抽卡模拟器
  • wish.customPools {AppGachaPool[]} 自定义卡池（格式详见genshin-gacha-kit）

注意事项

一个米游社账号一天内只能查询 30 个玩家数据，目前还没有考虑负载均衡的设计，请自行处理频率控制！

【广告】如果你喜欢本插件，欢迎给作者打钱或者捐赠米游社账号。

---

For communication and learning only.

All game data & pictures from query, Genshin Impact font: ©miHoYo

Copyright 2021 koishijs/机智的小鱼君

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0