diff options
| author | 2023-12-09 21:48:48 +0800 | |
|---|---|---|
| committer | 2023-12-09 22:37:38 +0800 | |
| commit | 8e92c375fc5ce1605c268cf8f7fae57cf5574e6b (patch) | |
| tree | cb7a6ecb86366874e7d7b0e0cbc02d6215b8fa7f /README.md | |
| parent | c6a15e6f8fc96ae9fe61bbadcaca8e14af593320 (diff) | |
| download | infini-8e92c375fc5ce1605c268cf8f7fae57cf5574e6b.tar.gz infini-8e92c375fc5ce1605c268cf8f7fae57cf5574e6b.zip | |
:memo: 更新文档
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 93 |
1 files changed, 54 insertions, 39 deletions
@@ -1,63 +1,78 @@ <h1 align="right">HydroRollCore'水系核心</h1> <p align="right"> - <a aria-label="Join the community on GitHub" href="https://github.com/HydroRoll-Team/hydroroll/discussions" target="blank"> - <img alt="" src="https://img.shields.io/badge/Join%20the%20community-blueviolet.svg?logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8CAgL/CgoK/woKCv8GBgb/BgYG/woKCv8KCgr/AgIC/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/BgYG/0ZGRv9MTEz/JiYm/ygoKP9MTEz/RkZG/wYGBv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9ycnL/Li4u/1xcXP9eXl7/Li4u/3Jycv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP88PDz/cnJy/05OTv9OTk7/UFBQ/05OTv9wcHD/Pj4+/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/Kioq/3Jycv9cXFz/TExM/05OTv9aWlr/cHBw/yoqKv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/Pj4+/zg4OP+AgID/Pj4+/2ZmZv9oaGj/PDw8/4CAgP86Ojr/Pj4+/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/ywsLP9iYmL/enp6/zIyMv90dHT/dHR0/zAwMP98fHz/YmJi/ywsLP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9SUlL/PDw8/3Jycv9CQkL/UlJS/1RUVP9CQkL/cnJy/zw8PP9SUlL/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/VFRU/yIiIv9aWlr/PDw8/zw8PP8+Pj7/PDw8/1hYWP8iIiL/VFRU/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/zQ0NP9CQkL/ZmZm/yIiIv9WVlb/WFhY/yIiIv9mZmb/QkJC/zY2Nv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9QUFD/BgYG/0RERP9KSkr/JCQk/yYmJv9KSkr/RERE/wgICP9QUFD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/CgoK/wICAv8KCgr/CgoK/wYGBv8GBgb/CgoK/woKCv8CAgL/CgoK/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==&labelColor=000000&logoWidth=20&logoColor=white"> - </a> - <a href="https://pypi.org/project/HydroRollCore"> - <img src="https://img.shields.io/pypi/v/hydrorollcore?labelColor=000000"> - </a> - <a href="https://github.com/HydroRoll-Team/HydroRollCore/blob/master/LICENSE"> - <img alt="" src="https://img.shields.io/pypi/l/hydrorollcore.svg?labelColor=000000&color="> - </a> - - [](https://github.com/HydroRoll-Team/HydroRollCore/actions/workflows/python-publish.yml) - [](https://github.com/HydroRoll-Team/HydroRollCore/actions/workflows/codeql.yml) - [](https://app.netlify.com/sites/grps-v1/deploys) + <a aria-label="Join the community on GitHub" href="https://github.com/HydroRoll-Team/hydroroll/discussions" target="blank"> + <img alt="" src="https://img.shields.io/badge/Join%20the%20community-blueviolet.svg?logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8CAgL/CgoK/woKCv8GBgb/BgYG/woKCv8KCgr/AgIC/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/BgYG/0ZGRv9MTEz/JiYm/ygoKP9MTEz/RkZG/wYGBv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9ycnL/Li4u/1xcXP9eXl7/Li4u/3Jycv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP88PDz/cnJy/05OTv9OTk7/UFBQ/05OTv9wcHD/Pj4+/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/Kioq/3Jycv9cXFz/TExM/05OTv9aWlr/cHBw/yoqKv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/Pj4+/zg4OP+AgID/Pj4+/2ZmZv9oaGj/PDw8/4CAgP86Ojr/Pj4+/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/ywsLP9iYmL/enp6/zIyMv90dHT/dHR0/zAwMP98fHz/YmJi/ywsLP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9SUlL/PDw8/3Jycv9CQkL/UlJS/1RUVP9CQkL/cnJy/zw8PP9SUlL/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/VFRU/yIiIv9aWlr/PDw8/zw8PP8+Pj7/PDw8/1hYWP8iIiL/VFRU/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/zQ0NP9CQkL/ZmZm/yIiIv9WVlb/WFhY/yIiIv9mZmb/QkJC/zY2Nv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9QUFD/BgYG/0RERP9KSkr/JCQk/yYmJv9KSkr/RERE/wgICP9QUFD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/CgoK/wICAv8KCgr/CgoK/wYGBv8GBgb/CgoK/woKCv8CAgL/CgoK/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==&labelColor=000000&logoWidth=20&logoColor=white"> + </a> + <a href="https://pypi.org/project/HydroRollCore"> + <img alt="pypi" src="https://img.shields.io/pypi/v/hydrorollcore?labelColor=000000"> + </a> + <a href="https://github.com/HydroRoll-Team/HydroRollCore/blob/master/LICENSE"> + <img alt="hydro" src="https://img.shields.io/pypi/l/hydrorollcore.svg?labelColor=000000&color="> + </a> + +[](https://github.com/HydroRoll-Team/HydroRollCore/actions/workflows/python-publish.yml) +[](https://github.com/HydroRoll-Team/HydroRollCore/actions/workflows/codeql.yml) +[](https://app.netlify.com/sites/grps-v1/deploys) </p> -## 🎁 Getting <img align="right" src="https://mirror.ghproxy.com/https://raw.githubusercontent.com/HydroRoll-Team/HydroRoll/main/site/src/assets/image/logo.png" height="120"> +## 🎁 Getting <img align="right" alt="hydro" src="https://mirror.ghproxy.com/https://raw.githubusercontent.com/HydroRoll-Team/HydroRoll/main/site/src/assets/image/logo.png" height="120"> 1. 安装库 -> [!IMPORTANT] -> -> 强烈推荐使用`pdm`管理你的`Bot`项目。 + > [!IMPORTANT] + > + > 强烈推荐使用`pdm`管理你的`Bot`项目。 -在命令行输入。 + 在终端中执行: -``` shell -git clone https://github.com/HydroRoll-Team/HydroRollCore.git -cd HydroRollCore -pdm install -# 或者使用pip -# pip install HydroRollCore -``` + ```bash + git clone https://github.com/HydroRoll-Team/HydroRollCore.git + cd HydroRollCore + pdm install + ``` + + 你可以使用`pip`进行安装: + + ```bash + pip install HydroRollCore + ``` 2. 创建规则包实例 -``` shell -mkdir myrules && cd myrules && mkdir rule1 -echo.> config.toml -echo.> __init__.py -``` + ``` shell + mkdir myrules && cd myrules && mkdir rule1 + echo.> config.toml + echo.> __init__.py + ``` + + 在 `__init__.py` 创建一个 `rule` 实例并继承 `Rule` 基类, 通过编写合适的相关方法与类注册规则包实现规则的自定义。 -在 `__init__.py` 创建一个 `rule` 实例并继承 `Rule` 基类, 通过编写合适的相关方法与类注册规则包实现规则的自定义。 + ``` python + from HydroRollCore import Rule, Result, Dice -``` python -from HydroRollCore import Rule + class MyRule(Rule): + """自设规则包""" -class Myrule(Rule): - """自设规则包,继承 Rules 基类""" -``` + name = "MyRule" + priority: int = 0 + + def __init__(self) -> None: + """初始化你的规则包""" + + def check(self, dice: Dice) -> Result: + """声明规则包检定方式""" + return Result("myevent.event1", True) + ``` 3. 合理修改你的 `config.toml` 配置文件,完成注册! ### 🎍Sites -https://grps.hydroroll.team _(recommend)_ -https://grps-v1.netlify.app -~~https://hydroroll-team.github.io/HydroRollCore/~~ + +<https://grps.hydroroll.team> _(recommend)_ +<https://grps-v1.netlify.app> +~~<https://hydroroll-team.github.io/HydroRollCore/>~~ ## 📄 License |
