MortikLibrary

插件

· 作者 ytmortik

可配置的事件日志记录器,支持可搜索的玩家历史记录、死亡追踪、TPS 监控和多语言支持。

0 本站下载 0 关注 更新于 2 周前

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

Mortik Library 是一款面向运行 Paper 1.21.11 的服务器的可配置事件记录插件。它帮助服务器工作人员回顾玩家活动、调查死亡与 PvP 遭遇,并通过可搜索的游戏内历史记录检查近期的服务器性能。

事件记录

Mortik Library 支持 64 种事件类型,同时记录插件启动、关闭以及低 TPS(每秒刻数)情况。

可用的类别包括:

  • 玩家活动: 加入、断开连接、重生、传送、世界变更、进度达成、游戏模式更改等。
  • 战斗: 玩家死亡、击杀者归属、PvP 伤害、复活以及药水效果变化。
  • 方块: 放置、破坏、点燃、燃烧、爆炸和施肥。
  • 容器与物品: 打开/关闭物品栏、物品掉落、拾取、合成、附魔以及熔炉提取。
  • 世界事件: 天气变化、闪电、爆炸、传送门以及世界加载或保存。
  • 实体: 生成、死亡、驯服、繁殖、形态变换以及载具相关事件。
  • 服务器活动: 插件启用与禁用事件、服务器加载以及低 TPS 记录。
  • 可选的聊天与命令日志: 命令日志仅存储命令名称而不包含其参数。

记录可按类别进行配置,也可针对单个事件类型进行覆盖。高频率类别(如方块、物品栏活动和实体事件)默认处于禁用状态。

可搜索的历史记录

按事件类型、玩家名称、UUID 和时间窗口搜索记录的事件。结果采用分页显示,并附带 UTC 时间戳。

死亡记录包括受害者、击杀者名称及 UUID(如有)、最后一次伤害来源、死亡消息以及位置。击杀者归属遵循 Bukkit 的玩家击杀追踪机制。

历史记录以异步方式保存至每日日志文件。默认配置保留七天的日志,并保留最近 20,000 条记录供游戏内搜索使用。CSV 导出基于此可搜索的历史记录。

近期服务器性能

检查过去十分钟内收集的性能样本,包括:

  • 平均采样 TPS 与最小采样 TPS。
  • 最大采样 MSPT(每刻毫秒数)。
  • 逐分钟摘要。
  • 在线玩家数量。
  • 低 TPS 事件记录。

TPS 值使用 Paper 的一分钟滚动估算值。性能样本在启动后开始累积,并在插件重启时重置。此功能提供近期的性能背景信息;它不用于识别卡顿的原因。

命令

主命令为 /mortik,/ml 和 /mortiklibrary 为其别名。Tab 补全建议命令、事件类型、已知玩家、语言以及常见参数值。

命令 描述
/mortik help 显示命令帮助。
/mortik events [type] [player] [minutes] [page] 搜索记录的事件。
/mortik deaths <player> [minutes] [page] 回顾玩家死亡记录。
/mortik kills <killer> [minutes] [page] 回顾玩家击杀记录。
/mortik player <player> [minutes] [page] 回顾某玩家的记录活动。
/mortik tps [1–10] 检查近期性能样本。
/mortik status 查看记录器状态及存储队列统计信息。
/mortik types 列出已注册的事件类型及其启用状态。
/mortik info 解释记录工作原理。
/mortik language <en|cs|es|it|fr> 设置首选语言。
/mortik reload 重新加载配置和消息。
/mortik export [type] [player] [minutes] 将匹配的记录导出为 CSV。

使用 * 可匹配所有事件类型或玩家。事件搜索默认时间窗口为 60 分钟。

语言与配置

默认语言为英语。内置捷克语、西班牙语、意大利语和法语翻译。

玩家可以选择自己的语言,该偏好设置在重启后会保留。消息模板、命令帮助以及消息前缀可在语言文件中编辑。技术性的事件标识符和记录的事件数据保持为英文。

配置选项包括记录类别、单个事件覆盖、历史记录限制、日志保留期限、采样间隔以及低 TPS 阈值。

权限

权限 访问范围
mortik.view 历史、性能和信息相关命令。
mortik.admin 配置重载和 CSV 导出。
mortik.language 个人语言选择。

历史和管理权限默认赋予服务器操作员。语言选择功能默认对所有玩家开放。

开发者 API

Mortik Library 提供不可变的历史快照、近期性能样本、自定义记录创建,以及用于与其他插件集成的同步 MortikRecordEvent 通知。

安装

  1. 使用运行 Java 21 的 Paper 1.21.11 服务器。
  2. 将插件 JAR 文件放入服务器的 plugins 目录。
  3. 启动服务器以生成配置文件和语言文件。
  4. 调整记录设置并运行 /mortik reload。
  5. 使用 /mortik help 开始使用。

范围与限制

Mortik Library 是一个活动记录器,而非回滚系统或完整的物品交易审计工具。容器事件仅记录打开和关闭操作,而非每一次物品转移。

搜索结果仅限于保留在内存中的记录缓冲区。队列过载、磁盘写入失败或配置的每日文件限制可能导致记录无法持久化;可通过 /mortik status 查看未保存的记录计数器。

专为 Paper 1.21.11(Purpur)设计。不支持 Folia、Fabric 和 Forge。当前版本已通过编译和自动化检查;在真实服务器上的玩家测试仍在进行中。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源