koishi-plugin-xiaohua-monetary


小划 bot 自用货币系统插件。

> 本插件基于 koishi-plugin-nailong-monetary（作者：ziyi233）修改而来，感谢原作者的开源贡献。

主要改进

- 统一 userId 生成规则：所有用户 ID 统一使用不带平台前缀的格式存储
- 管理员余额修改：新增 monetary.set 指令，允许管理员修改用户余额
- 数据导入导出：支持将货币数据导出为 JSON 文件，便于数据迁移和备份

指令列表

$3

| 指令 | 别名 | 说明 |
|------|------|------|
| monetary.balance [target] | 余额 | 查询点数余额（管理员可查询他人） |
| monetary.transfer [target] [amount] | 转账 | 转账点数给其他用户 |

$3

| 指令 | 别名 | 说明 |
|------|------|------|
| monetary.set | 设置余额 | 修改用户余额 |
| monetary.fix-uid | 修复uid | 批量补充缺失的 uid |
| monetary.export | 导出数据 | 导出货币数据到 JSON 文件 |
| monetary.import | 导入数据 | 从 JSON 文件导入货币数据 |

指令详解

$3

``
monetary.set @用户 <金额>
`

金额格式：
- 100：增加 100
- -50：减少 50
- =1000：设置为 1000

选项：
- -c ：指定货币类型（默认 default）

$3

`
monetary.export [-c ]
`

将货币数据导出到配置的目录，生成带时间戳的 JSON 文件。

$3

`
monetary.import [-o|-m]
`

从配置的 JSON 文件导入数据。

选项：
- -o：强制覆盖模式（直接设置为导入值）
- -m：强制合并模式（累加到现有值）

配置项

$3

| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| msgCostSuccess | string | 💰 已扣除 {cost} {currency}，当前余额：{balance} | 扣费成功消息 |
| msgInsufficientBalance | string | ❌ 余额不足！需要 {cost} {currency}，当前余额：{balance} | 余额不足消息 |
| showBalance | boolean | true | 扣费后是否显示余额 |

$3

| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| exportDir | string | ./data/monetary-backup | 数据导出目录 |
| importFile | string | ./data/monetary-backup/import.json | 导入文件路径 |
| importMode | overwrite \| merge | merge | 导入模式 |

导出文件格式

`json
[
{ "userId": "123456789", "currency": "default", "value": 1000 },
{ "userId": "987654321", "currency": "default", "value": 500 }
]
`

> 导出文件只包含 userId、currency、value，不包含 uid（跨实例迁移时 uid 不通用）。导入后可使用 修复uid 指令补充。

依赖服务

- 必需：database
- 可选：profile`（用于在用户资料中显示余额）

许可证

MIT