FailureToLog

插件

· 作者 kooyoseb

FailureToLog 是一个 Paper 服务器插件,用于在服务器聊天中报告失败的登录、错误断开连接以及兼容的 Fabric 客户端断开连接报告。

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

最新 1.0-SNAPSHOT · 26.2 · Bukkit / Paper

一键开服(送7天)

FailureToLog Paper 插件

FailureToLog 是一款 Paper 服务器插件,可在服务器聊天中报告登录失败、错误断开连接以及兼容的 Fabric 客户端断开连接报告。

它帮助服务器管理人员了解玩家为何无法连接或已被断开连接,并通过游戏内命令检查存储在服务器端的错误报告。

功能说明

  • 检测玩家登录尝试失败的情况。
  • 检测服务器端踢出(kick)和错误断开连接。
  • 将错误断开连接的提示消息替换为更清晰的 FailureToLog 消息。
  • 保持正常的加入和退出行为不变。
  • 存储最近的错误日志以便检查。
  • 添加可点击的聊天按钮以查看错误详情。
  • 接收来自可选的 FailureToLog API Fabric 模组的客户端侧断开屏幕报告。
  • 提供用于启用/禁用插件、切换日志保存、查看错误代码以及打开存储日志的命令。

要求

  • Paper 26.1.2
  • Java 25 或更高版本

可选的客户端配套组件:

  • Minecraft 26.1.2 的 FailureToLog API Fabric 模组

安装方法

  1. 停止服务器。
  2. 将插件 jar 文件放入服务器的 plugins 文件夹中。
  3. 启动服务器。
  4. 插件将自动创建其配置文件和日志文件。

插件 jar 包:

FailureToLog-Paper-1.0-SNAPSHOT.jar

典型的服务器文件夹结构:

plugins/FailureToLog

配置

配置文件:

plugins/FailureToLog/config.yml

默认配置:

enabled: true
save-logs: true

enabled

开启或关闭 FailureToLog 的行为。

enabled: true

save-logs

控制是否将错误日志保存到磁盘。

save-logs: true

启用后,日志将保存至:

plugins/FailureToLog/logs.yml

命令

主命令:

/failuretolog

别名:

/ftl

切换插件状态

/failuretolog toggle

开启或关闭 FailureToLog。

所需权限:

failuretolog.admin

切换日志保存

/failuretolog savelogs <on|off>

示例:

/failuretolog savelogs on
/failuretolog savelogs off

所需权限:

failuretolog.admin

查看错误代码

/failuretolog codes

显示完整的 FailureToLog 错误代码列表。

查看错误日志

/failuretolog log <id>

显示已存储的错误报告。

当检测到错误时,FailureToLog 会发布一条带有可点击 [View error] 按钮的聊天消息。点击该按钮会自动执行此命令。

权限

failuretolog.admin

默认授予对象:

op (管理员)

允许使用以下命令更改 FailureToLog 设置:

/failuretolog toggle
/failuretolog savelogs <on|off>

聊天消息格式

示例:

Due to an error, PlayerName failed to connect. Error code: 600 (Bad client data) [View error]

针对服务器端踢出的情况:

Due to an error, PlayerName lost connection. Error code: 500 (Server-side problem) [View error]

针对 Fabric 客户端报告的情况:

Due to an error, PlayerName reported a client-side disconnect. Error code: 1 (Unknown crash) [View error]

正常的加入和退出操作保持服务器的默认行为。

错误代码

FailureToLog 包含以下代码:

1: Unknown crash
6: Not whitelisted
7: Banned
9: Blacklisted
105: World chunk load failure
200: Server memory shortage
201: Client memory shortage
401: Authentication/session failure
408: Connection timeout
429: Connection throttled
500: Server-side problem
503: Server full
600: Bad client data
601: Unsupported client version
602: Resource pack failure
790: Mod or socket conflict

插件根据登录结果、踢出原因、服务器消息以及可选的 Fabric 客户端报告对错误进行分类。如果无法分类某个错误,则使用:

1: Unknown crash

Fabric 客户端集成

FailureToLog 可以接收来自可选的 FailureToLog API Fabric 模组的额外客户端侧断开信息。

插件使用以下 Minecraft 自定义负载通道(Custom Payload Channels):

failuretolog:hello
failuretolog:client_log

流程:

  1. 玩家加入服务器。
  2. 服务器发送 failuretolog:hello。
  3. 兼容的 Fabric 客户端检测到 FailureToLog 服务器。
  4. 如果客户端看到断开连接屏幕,Fabric 模组会存储该屏幕的标题和原因。
  5. 根据客户端的设置,模组会立即或在下次连接时将报告发送给服务器。
  6. 服务器存储该报告并发布一条可点击的聊天消息。

重要限制

服务器插件无法直接读取玩家的本地客户端日志或崩溃报告。

在没有 Fabric 客户端配套模组的情况下,FailureToLog 只能使用服务器可见的信息,例如:

  • 登录拒绝原因
  • 踢出原因
  • 可用的服务器端异常描述
  • 玩家名称
  • UUID(如可用)
  • 地址(如可用)

安装了 Fabric 模组后,FailureToLog 还可以接收客户端的断开连接屏幕标题和原因。

隐私说明

FailureToLog 存储服务器端的连接/错误详细信息。

Fabric 客户端报告可能包括:

  • 断开连接屏幕标题
  • 断开原因
  • Minecraft 版本
  • 玩家名称
  • 服务器地址
  • 时间戳
  • FailureToLog 协议/插件版本

该系统不会有意收集完整的本地游戏日志或完整的崩溃报告。

推荐的平台描述

简短描述:

Paper 插件,用于在聊天中报告登录失败、错误断开连接以及可选的 Fabric 客户端断开连接报告。

详细描述:

FailureToLog 是一款 Paper 服务器插件,帮助服务器管理人员了解玩家为何无法连接或已被断开连接。

它检测失败的登录尝试和错误断开连接,分配错误代码,存储简短的服务器端报告,并发布一条可点击的聊天消息,使管理人员可以通过一个命令打开详细信息。

当与可选的 FailureToLog API Fabric 客户端模组搭配使用时,该插件还能接收客户端断开连接时的详细信息,为工作人员提供比服务器通常能自行看到的更多上下文。

建议标签

  • Paper
  • Server plugin
  • Admin tools
  • Logging
  • Error reports
  • Connection diagnostics
  • Fabric integration
  • Moderation tools
  • Utility

构建输出

集成分发构建文件已复制到:

C:\Users\musek\IdeaProjects\dist

Paper 插件 jar 包:

FailureToLog-Paper-1.0-SNAPSHOT.jar

Fabric 客户端配套 jar 包:

FailureToLog-API-Fabric-1.0.0.jar

运行集成构建脚本:

C:\Users\musek\IdeaProjects\build-all-failure-to-log.bat

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源