FiveM 事件记录器 & 调试工具

生成事件监听器,验证命名规则,检查安全问题,使用现成事件模板。

此工具的用途

事件是FiveM中客户端和服务器通信的方式,也是服务器被攻击的最常见途径。信任客户端发送内容的服务器事件可以被任何注入器调用。此生成器为双方写出正确的监听器,并根据命名和安全规则检查事件名。

如何使用

  1. 步骤 1:

    输入事件名,最好加上资源名前缀,避免与其他脚本冲突。

  2. 步骤 2:

    选择事件所属端。服务器事件需要RegisterNetEvent,纯本地事件不需要。

  3. 步骤 3:

    生成代码并阅读安全说明。它们指出必须在服务器端检查的值。

  4. 步骤 4:

    将监听器复制到您的资源中,并用您自己的逻辑替换占位符主体。

常见问题

RegisterNetEvent 和 AddEventHandler 有什么区别?

AddEventHandler 注册一个处理程序。RegisterNetEvent 额外允许事件从网络另一端触发。没有它,远程触发会被忽略,有了它,网络上的任何人都可以调用它,所以它只应属于真正需要的事件。

为什么我绝不能信任客户端?

客户端发送的所有内容都可以伪造:数量、物品、价格、玩家ID。服务器端用 source 读取来源,并自己在数据库中查找实际值。接受客户端数量的服务器事件就是一个开放的收银台。

我应该如何命名我的事件?

始终使用 resource:action,例如 agency-phone:sendMessage。没有前缀,两个脚本可能注册相同名称,导致错误的处理程序运行。冒号是约定,不是下划线。

我如何知道我的服务器触发了哪些事件?

在通配符端添加处理程序并打印到控制台可以显示流量。要有针对性地查看,在监听器开始处添加日志行。上线后请移除,因为每条日志都会影响繁忙服务器的性能。