ATHENA

插件

· 作者 Thatsmusic99

Paper 的广泛且强大的事件调试器

0 本站下载 0 关注 更新于 4 年前

最新 1.1.0-BETA-1 · 1.19.2 · Paper / Purpur

一键开服(送7天)

概览

ATHENA 是一款易于使用且信息丰富的服务端事件调试工具,面向服务器管理员和插件开发者,旨在兼顾终端用户的友好性与稳健性。

要求

  • Java 16
  • Minecraft 1.17 或更高版本
  • Paper,或其任何分支版本。

命令

  • /athena listen <Event Name> - 开始监听特定事件。如果失败,请包含完整的包名。
  • /athena listeners <Event Name|Plugin> - 列出监听给定事件的所有插件,或列出给定插件中所有活跃的监听器。
  • /athena stop [Event Name] - 停止监听特定事件;如果不指定名称,则停止监听所有事件。
  • /athena lookup <Command> - 查找命令的来源及其运行权限。

权限

  • athena.command.stop - 访问 /athena stop 的权限。
  • athena.command.lookup - 访问 /athena lookup 的权限。
  • athena.command.listen - 访问 /athena listen 的权限。
  • athena.command.listeners - 访问 /athena listeners 的权限。

重要说明与免责声明

ATHENA 在设计时充分考虑了可用性、稳定性和细节。然而,性能并非该插件的首要优先级。尽管我已运用大部分专业知识尽可能优化插件,但不建议在非必要时运行 ATHENA。该插件大量使用反射机制来运作并从事件中收集数据,这本身可能会对性能造成一定影响。此外,虽然 ATHENA 不会(或至少尝试不)干扰各个插件的监听器,但它可能会影响这些监听器在 Paper 的 Timings 中显示的优化程度。如果你正在使用 Timings 和 ATHENA 测量事件性能,建议分别进行测量(例如:先执行 /timings paste,然后使用 ATHENA 查看某次运行的完成时间)。

如果你是正在测量监听器耗时的服务器管理员,仅当单个监听器的完成时间超过 40ms 时才需关注性能问题。Minecraft 中单个刻(tick)耗时 50ms,因此 20 TPS 是服务器应追求的重要指标。请勿仅仅因为某个插件的监听器耗时最长而频繁催促插件开发者;有些插件需要执行的任务确实比其他插件更多。此外,spark 分析/性能分析报告以及 Timings 数据可能比 ATHENA 提供的单一片段更有参考价值。

如果 ATHENA 无法监听特定事件或在尝试监听时崩溃,请在提交 Issue 时附带该事件的相关信息。如果该事件来自某个插件,请尽量提供该事件的类名。

如果 ATHENA 出现错误,它仍应允许其控制的监听器正常运行,因此不应影响其他插件的功能。

异步执行的事件可能无法获取插件来源信息。

欢迎提交 PR 和建议以改进插件——包括其性能。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源