koishi-plugin-genshin-legacy

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #go #machine-learning #rust #nodejs #java #kubernetes #mcp #ios #open-source

koishi-plugin-genshin-legacy

(★ 15)

Koishi 原神大礼包（koishi-plugin-genshin）是一个为koishi设计的查询原神国服玩家数据的插件。

koishi-plugin-genshin-legacy Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# koishi-plugin-genshin

**Koishi 原神大礼包**（_Genshin Impact for Koishi.js_）是一个为[koishi](https://github.com/koishijs/koishi)设计的查询展示原神国服玩家数据以及抽卡模拟的插件。

## 特色功能

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

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

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

**截图展示**

<details>
<summary>玩家资料卡 (genshin.profile)</summary>

![genshin-profile.jpg](https://i.loli.net/2021/09/10/9Q1MzJfqmUhj46y.jpg)

</details>

<details>
<summary>角色展示卡 (genshin.character)</summary>

![genshin-character.jpg](https://i.loli.net/2021/09/10/oq1AYMeQNjlX8Zf.jpg)

</details>

## 安装方法

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

## 使用指南

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

## 系统需求

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

若要使用完整的“卡片”功能，需要配置并安装 [koishi-plugin-puppeteer](https://npmjs.com/package/koishi-plugin-puppeteer)。

## 配置项目

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

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

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

安装插件，详见 [官方指南](https://koishi.js.org/guide/context.html)。

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

</details>

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

**可用配置项**

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

## 注意事项

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

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

---

_For communication and learning only._

> 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

koishi-plugin-genshin-legacy

koishi-plugin-genshin-legacy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

koishi-plugin-genshin-legacy

koishi-plugin-genshin-legacy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README