原创 工具 AuroraContainerLog - 箱子物品流向追踪日志插件 1.1.5

[MD] # AuroraContainerLog > 箱子容器物品流向记录插件 AuroraContainerLog 是一款面向 Spigot 1.12.2 的箱子日志插件。 主要用于地皮服、生存服、RPG 服排查： - 玩家从箱子里拿走了什么 - 玩家往箱子里放入了什么 - 哪个玩家在什么时间操作了哪个箱子 - 大箱子、普通箱子、陷阱箱的物品变化记录 --- # 核心功能 - 只监听配置中指定世界 - 只记录箱子类容器变化 - 不记录玩家背包内部整理 - 支持普通箱子、陷阱箱、大箱子 - 支持记录玩家名称和 UUID - 支持记录容器坐标 `world/x/y/z` - 支持记录动作 `TAKE / PUT` - 支持记录物品完整信息 - 支持 SQLite 存储 - 支持历史数据自动清理 - 支持分页查询 --- # 记录内容 每条记录会保存： - 操作时间 - 世界名 - 箱子坐标 - 玩家名称 - 玩家 UUID - 操作类型：取出 / 放入 - 物品类型 - 物品数量 - 物品显示名 - 物品 lore - 物品附魔 - 完整 ItemStack Base64 --- # 查询命令 ```text /acl chest ``` 管理员看着箱子执行，查询该箱子最近记录。 ```text /acl player <玩家名> <天数> ``` 查询指定玩家最近多少天的箱子操作记录。 ```text /acl near <半径> <天数> ``` 查询附近指定半径内的箱子记录。 ```text /acl reload ``` 重载配置文件。 --- # 权限 ```text auroracontainerlog.admin ``` 默认 OP 拥有权限。 --- # 配置示例 ```yaml listen-worlds: - world query: page-size: 8 chest-recent-days: 30 max-near-radius: 50 default-page: 1 database: file: containerlog.db cleanup: enabled: true retention-days: 60 interval-hours: 24 ``` 说明： - `listen-worlds`：需要监听箱子的世界列表 - `page-size`：每页显示记录数量 - `chest-recent-days`：箱子查询默认显示最近多少天 - `max-near-radius`：附近查询最大半径 - `retention-days`：超过多少天的记录自动清理 --- # 数据库 当前版本使用 SQLite。 数据库写入和查询均通过异步队列执行，避免直接阻塞主线程。 SQLite 使用单连接池： ```text maximumPoolSize: 1 minimumIdle: 1 ``` 这样可以减少 SQLite 多连接写入导致的数据库锁问题。 --- # 插件特点 专为地皮服查偷东西设计 只记录箱子库存最终变化 避免误记玩家背包整理 支持大箱子查询 支持玩家记录查询 支持附近范围查询 支持自动清理过期数据 轻量化插件包 --- Aurora 系列插件持续开发中。 [/MD]