Koishi 插件：unbanself

📖 简介

本插件用于 Minecraft 服务器的自动账号解封功能，玩家可以通过指令 /unbanself <ID> 自助解除 LiteBans 封禁，仅限每日一定次数，支持控制封禁来源（如仅解封被 CONSOLE 封禁的账号）。

🛠 功能概览

• ✅ 支持 /unbanself <ID> 指令解封 LiteBans 数据库中的账号
• ✅ 支持 /uuid <ID> 查询离线 UUID
• ✅ 支持 /unbanselfstatus [ID] 查看今日已使用的解封次数
• ✅ 支持按发送用户与玩家账号双重限制每日次数
• ✅ 支持判断封禁是否由 CONSOLE 执行
• ✅ 所有日志输出为中文，详细记录每步流程
• ✅ 使用原生 mysql 库，非连接池方式，兼容性更好

⚙️ 插件配置项

| 配置项 | 类型 | 默认值 | 说明 | |--------|------|--------|------| | mysql.host | string | 无 | 数据库 IP 地址 | | mysql.port | number | 3306 | 数据库端口 | | mysql.user | string | 无 | 数据库用户名 | | mysql.password | string | 无 | 数据库密码 | | mysql.database | string | 无 | 使用的数据库名称 | | dailyLimit | number | 1 | 每个用户和每个 Minecraft 账户每日解封次数 | | onlyConsoleBans | boolean | true | 是否仅允许被 CONSOLE 封禁的玩家解封 |

🧾 指令列表

• /unbanself <ID>
  解封指定 Minecraft 账户，如果当日次数用尽或账号未被封禁，将返回提示。

• /uuid <ID>
  获取指定 ID 的离线 UUID，供管理员调试使用。

• /unbanselfstatus [ID]
  查看今日解封使用次数，如指定 ID 会额外显示该 Minecraft 账户的解封次数。

📝 数据表说明

插件自动在 Koishi 的 SQLite 中创建两个表用于次数统计：

• unbanself_record: 用户 ID + 日期为主键，记录每个用户每日次数
• unbanself_mcid: 账号 ID + 日期为主键，记录每个 Minecraft 账户每日次数

🧩 使用建议

• 保证数据库账号有权限访问 litebans_bans 表
• 若为分布式环境，请确保 UUID 计算一致性（采用离线模式 UUID）

📦 安装

pnpm add koishi-plugin-unbanself
# 或手动引入插件源码至项目中

💡 示例

/unbanself Airio_
/uuid Airio_
/unbanselfstatus Airio_