# LKroBot - 智能假人管理插件
## 插件简介LKroBot 是一个功能强大的 Minecraft 假人管理插件。该插件提供了完整的假人创建、管理和计费系统，支持多种假人操作模式，并具备智能计费功能。
## 主要特性
### 
假人管理
- **智能创建**: 支持自定义假人名称、无敌状态、防击退属性- **多功能操作**: 攻击、破坏方块、交互、跳跃、使用物品等
- **状态监控**: 实时显示假人在线状态、生命值等信息
- **物品管理**: 查看和管理假人物品栏
- **传送功能**: 假人与玩家之间的双向传送
### 
智能计费系统
- **按时计费**: 基于时间的使用计费，支持分钟级精确计费- **智能暂停**: 无假人在线时自动暂停计费，节省费用
- **实时显示**: 主菜单实时显示剩余时间和计费状态
- **自动清理**: 时间用完后自动清理所有数据
- **数据安全**: 定时保存，防止数据丢失
- **配额购买**: 支持在计费模式下购买额外的假人配额
### 
权限管理
- **白名单系统**: 支持基于玩家的白名单控制- **黑名单系统**: 支持黑名单禁用功能
- **OP特权**: 管理员拥有完整管理权限
- **配额限制**: 可设置每个玩家的假人数量上限
### 
经济系统
- **多种支付方式**: 支持 LLMoney 和计分板两种经济系统- **灵活定价**: 可自定义配额购买价格和计费费率
- **购买时间**: 支持自定义时间购买
## 安装要求
- **服务器**: LeviLamina- **依赖**: legacy-script-engine-quickjs
- **经济插件**: LLMoney（可选，如使用货币系统）
## 安装方法
1. 将 `LKroBot` 文件夹放入服务器的 `plugins` 目录2. 重启服务器或使用 `ll reload` 命令重载插件
3. 根据需要修改 `Config.json` 配置文件
## 配置说明
建议在服务器配置文件server.properties添加如下语言配置
JSON：
language=zh_CN
# 后台指令语言，默认英文，已修改为中文
# 有效值：\resource_packs\vanilla\texts 中的文件名路径："BDS根目录\plugins\LKroBot\Config\Config.json"
JSON：
"EconomyType": 1, // 经济类型：0=计分板，1=LLMoney
"scoreboard": "money", // 计分板名称（当EconomyType=0时使用）
"quotaMoney": 1000, // 配额购买价格
"rateMin": 20, // 计费费率：每分钟扣除的经济值
"default_quantity": 1, // 默认配额数量
"max_quantity": 5, // 个人配额数量上限
"whitelist": false, // 是否开启白名单
"blacklist": false, // 是否开启黑名单
"billingEnabled": true, // 是否启用计费功能
"saveInterval": 60000 // 保存间隔(毫秒)，默认1分钟
"cleanupExpiredPlayerDataEnabled": 1, // 是否启用清除长时间不使用的玩家数据(新增假人和上线假人更新操作时间)
"cleanupExpiredPlayerDataInterval": 10 // 清理长时间不实用玩家数据时间间隔(天)### 权限配置
- **白名单**: 编辑 `Whitelist.json` 添加允许使用的玩家- **黑名单**: 编辑 `Blacklist.json` 添加禁止使用的玩家
## 使用方法
### 玩家操作
#### 基础命令
```
/lkbot - 打开假人管理主菜单
```
#### 主要功能
1. **新增假人**: 创建新的假人，可设置无敌和防击退属性2. **管理假人**: 查看和管理已创建的假人
3. **查询信息**: 查看假人详细信息和状态
4. **购买时间**: 购买假人使用时间（如启用计费）
5. **购买配额**: 购买额外的假人配额（在计费模式下可用）
#### 假人操作
- **攻击模式**: 让假人自动攻击视线内的实体- **破坏方块**: 让假人持续破坏视线内的方块
- **交互模式**: 让假人与方块或实体进行交互
- **跳跃模式**: 让假人持续跳跃
- **使用物品**: 让假人使用指定物品
- **状态切换**: 切换假人的无敌和防击退状态
### 管理员操作
管理员（OP）可以使用以下功能：- **查看所有假人**: 查看服务器上所有玩家的假人
- **计费管理**: 管理玩家的计费状态和剩余时间
- **添加时间**: 为指定玩家添加使用时间
- **删除数据**: 完全删除玩家的所有数据
- **系统设置**: 调整插件配置参数
## 计费系统详解
### 计费逻辑
1. **开始计费**: 当玩家有假人上线时自动开始计费2. **暂停计费**: 当所有假人下线时自动暂停计费
3. **恢复计费**: 当假人重新上线时自动恢复计费
4. **时间警告**: 剩余时间少于10分钟时发送警告
5. **自动清理**: 时间用完后自动清理所有数据
### 数据保护
- **定时保存**: 每分钟自动保存计费数据- **崩溃恢复**: 服务器重启后自动恢复计费状态
- **数据持久化**: 所有数据保存在 JSON 文件中
## 许可证
本插件遵循开源许可证，允许自由使用和修改，但请保留原作者信息。
---
