KrepAPI(模组)

KrepAPI(模组)

服务器端 Fabric 客户端桥接:从主机同步的自定义按键绑定、用于附加组件的可选原始按键钩子,以及一种握手机制,使 Paper/Fabric 服务器可要求安装此模组。仅安装在使用 KrepAPI 的服务器上。需要 Fabric API。

游戏机制

GITHUB

KrepAPI 是一个 Fabric 模组,它允许多人服务器(通过 Paper/Spigot 插件消息,或使用相同协议的 Fabric 服务器)在你的客户端上定义额外的按键绑定,在允许时响应原始按键输入,并可选择要求你必须安装此模组。

只有当你游玩的服务器使用 KrepAPI 时,你才需要它。除非你自己运行匹配的服务端代码,否则它在单人游戏中没有任何实际作用。

功能

  • 服务器按键绑定 —— 服务器发送一组动作(ID、标签、默认 GLFW 按键、分类)。它们会显示在一个专门的控制分类下(例如“KrepAPI (this server)”)。按下绑定的按键会通知服务器。
  • 握手 —— 服务器可以验证协议版本和模组版本;配置错误或缺失的客户端可能会被断开连接(由服务器策略决定)。
  • 原始按键管线(面向开发者) —— 配套模组可以注册监听器以尽早观察按键,并在设计允许时(例如服务器批准的覆盖)可选择阻止该事件的原版处理。
  • Fabric 专用服务器 —— 同一个模组 jar 可以加载到 Fabric 服务器上,无需 Paper 即可处理该协议。

要求

  • Minecraft —— 与你所使用的 KrepAPI 构建所针对的版本匹配。
  • Fabric Loader
  • Fabric API

面向服主与开发者

服务器集成使用一个小型二进制协议(插件通道 / 自定义负载)。参考实现和文档位于项目仓库中(协议布局、Paper 示例插件、客户端 API)。

许可证

请参阅分发的模组元数据和项目许可证。除非 Modrinth 的“License”字段另有说明,否则保留所有权利。