TRPGdice-Complete

为 Astrbot 设计的 TRPG 骰子插件（参考 Dice! 与海豹的实现），提供掷骰、技能判定、人物卡管理与日志导出等常用功能，便于在群聊中进行跑团玩法支持。

为所有使用astrbot平台但想要有与其他骰娘相同体验的骰主设计。

安装

克隆仓库到本地：

git clone https://github.com/WhiteEurya/Astrbot_plugin_TRPGdice-Complete.git

将插件文件/目录放入 Astrbot 的插件目录（plugin folder）。
启动或重启 Astrbot，确认控制台输出已加载本插件。

如果 Astrbot 有插件管理命令或配置文件，请根据 Astrbot 的文档把本插件添加到插件列表中。

功能

基础掷骰
- 支持常见的 DnD / CoC / 跑团检定
- 支持算式，例如 1d100+5
- 支持小众规则的掷骰 (目前已支持吸血鬼规则)
角色卡与检定
- 支持角色属性绑定
- 一键进行 技能检定、对抗检定
自定义别名
- 角色名、技能名可自定义
- 方便团队内的快速调用
日志与记录
- 自动保存跑团对话日志
- 支持导出记录，便于存档和复盘
预览与染色
- 对日志进行高亮显示
- 支持过滤表情、时间戳、账号等冗余信息
自定义风格回复
- 将所有回复集成到 config.yaml 中，方便自由修改
更多方便的功能
- 生成名字、抽取恐慌症状等...

快速使用示例

插件加载后，可在群聊或私聊中使用下列示例指令进行测试

基本掷骰（示例）：
```
.r
```
技能判定（示例）：
```
.ra侦查50
```

人物卡管理（示例）：
本插件接收 COC7版规则卡 的 .st 输入

.pc create <名字>
.pc change <名字>
.pc update 幸运+1
.st 属性值

日志 / 会话（示例）：

.log new <日志名>
.log off
.log on
.log end

如需完整指令说明，请运行插件内置的帮助命令 .dicehelp 或查看源码中的命令实现部分。

仓库

项目地址：
https://github.com/WhiteEurya/Astrbot_plugin_TRPGdice-Complete

染色器搭建

本插件提供了类似海豹LOG染色器的染色功能，保存在 /log-painter下，感谢海豹LOG染色器提供的模板与思路。
如果要使用染色器，需要通过npm和fastapi在本地进行搭建。
若您不方便配置域名、没有合适的服务器，可以直接使用我的染色器网址: https://painter.atritrpg.chat/

如果您愿意搭建自己的染色器，则可以参考下列教程

后端 (FastAPI)

创建虚拟环境并激活：

# Windows
python -m venv venv
venv\Scripts\activate

# macOS/Linux
python3 -m venv venv
source venv/bin/activate

安装依赖：

pip install fastapi uvicorn[standard]

启动 FastAPI 服务：

# Windows / macOS / Linux
uvicorn main:app --reload

默认运行在 http://127.0.0.1:8000

前端 (npm)

cd frontend

安装依赖：

npm install

启动开发服务器：

npm run dev

默认运行在 http://localhost:5173（端口可能根据框架不同而变化）

构建生产环境：

npm run build

配置

进入 log-painter/backend/config.yaml 修改目标文件夹到您存放export log的位置。

进入 log-painter/frontend/vite.config.ts 中，在 allowedHosts 一项中修改您的服务器域名。

进入 component/config.yaml 中将 setting.website 一项修改为您自己的域名

注意事项

确保后端服务已经启动，否则前端无法正常请求 API。
如果遇到权限问题，请尝试使用管理员/sudo 权限。大部分npm操作可能都需要您提供管理员权限

别的想说的

在完成之前一版TRPG_Dice之后，本来已经准备摆了，但是朋友们以及其他的用户不断给我反馈以及提供idea、编码上的帮助，这给了我动力将曾经的插件进行大幅度优化，目前比起曾经那个简单的骰子和屎山代码已经有了很大优化。当然这个插件一定还有很多bug和优化的地方，因此如果大家对这个插件有任何问题、发现了任何BUG，都可以在issue中与我交流。

Contributors

感谢以下为本项目做出贡献的朋友：

许可

本项目采用 MIT 协议，欢迎自由使用与修改

插件详情

astrbot_plugin_TRPGdice_Complete

插件说明