KrepAPI 是一款 Fabric 模组,允许多人服务器(通过 Paper/Spigot 插件消息或具有相同协议的 Fabric 服务器)在客户端定义额外的按键绑定,并在获准时响应原始按键输入,同时可选地要求玩家安装此模组。
仅当你游玩的服务器使用它时才需要 KrepAPI。除非你自己运行匹配的服务器端代码,否则它在单人游戏中不会产生任何实际作用。
功能
- 服务器按键绑定 — 服务器发送操作列表(ID、标签、默认 GLFW 键、分类)。它们会显示在一个专用的控制类别下(例如“KrepAPI (本服务器)”)。按下已绑定的键时会通知服务器。
- 握手验证 — 服务器可验证协议版本和模组版本;配置错误或未安装模组的客户端可以被断开连接(依据服务器策略)。
- 原始按键管线(面向开发者) — 配套模组可以注册监听器以早期观察按键,并在设计允许的情况下(例如服务器批准的覆盖机制)阻止原版对该事件的处理。
- Fabric 专用服务器 — 相同的模组 jar 包可以在 Fabric 服务器上加载,以便在没有 Paper 的情况下处理协议。
要求
- Minecraft — 需与 KrepAPI 构建所针对的版本匹配。
- Fabric Loader
- Fabric API
面向服务器管理员与开发者
服务器集成使用一种小型二进制协议(插件频道 / 自定义负载)。参考实现和文档位于项目仓库中(协议布局、Paper 示例插件、客户端 API)。
许可证
请参阅分发的模组元数据和项目许可证。除非 Modrinth “License” 字段中有其他说明,否则保留所有权利。
KrepAPI is a Fabric mod that lets multiplayer servers (via Paper/Spigot plugin messages or a Fabric server with the same protocol) define extra key bindings on your client, react to raw key input when allowed, and optionally require that you have this mod installed.
You only need KrepAPI if the server you play on uses it. It does nothing useful in single-player unless you run matching server-side code yourself.
Features
- Server key bindings — The server sends a list of actions (ids, labels, default GLFW keys, categories). They show up under a dedicated controls category (e.g. “KrepAPI (this server)”). Pressing a bound key notifies the server.
- Handshake — Server can verify protocol version and mod version; misconfigured or missing clients can be disconnected (server policy).
- Raw key pipeline (for developers) — Companion mods can register listeners to observe keys early and optionally block vanilla handling for that event when the design allows (e.g. server-approved overrides).
- Fabric dedicated server — The same mod jar can load on a Fabric server to handle the protocol without Paper.
Requirements
- Minecraft — Match the version your KrepAPI build targets.
- Fabric Loader
- Fabric API
For server owners & developers
Server integration uses a small binary protocol (plugin channels / custom payloads). Reference implementations and docs live in the project repository (protocol layout, Paper sample plugin, client API).
License
See the distributed mod metadata and project license. All rights reserved unless otherwise stated in the Modrinth “License” field.
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KrepAPI (Mod)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
客户端更新检查、下载流程及游戏内更新界面
UpdateChecker(适用于fabric-1-21和fabric-26-1):在客户端启动时,异步从 GitHub 获取.system/mod/versions.json,解析出与当前运行的 Minecraft 版本对应的 最新 模组版本及 JAR 文件名,使用KrepapiBuildVersion(:protocol) 将 semver 与已安装的模组进行对比,并将.system/mod/changelog/{version-with-dashes}.md中列出的每个版本的更新日志 Markdown 加载到versionList+allChangelogs中供菜单使用。UpdateDownloader:仅在用户明确操作时,通过 HTTP 将更新 JAR 下载到mods/KrepAPI-update-{latestVersion}.jar,并带有 易失性进度 字段;防止重复下载;展示错误信息而不导致客户端崩溃。/krepapi menu:随时打开更新/更新日志界面的客户端命令。KrepapiUpdateToast:当有可用更新时显示一次性提示框;打开菜单(提示框本身不提供直接下载功能)。KrepapiUpdateHud:当有可用更新时显示可选的[KrepAPI ↑]指示器;点击打开菜单(HUD 本身不提供直接下载功能)。
Fabric 1.21.x — MoulConfig 更新菜单
- MoulConfig (
modern-1.21.11):通过 GradleUp Shadow 捆绑打包:依赖项被 重定位 至net.shik.krepapi.deps.moulconfig,包含kotlin-stdlib以支持 MoulConfig 的 Kotlin 内部实现,并手动创建了指向重定位后平台类的META-INF/services/...IMinecraft条目(Shadow 默认不会重写服务文件)。 - 访问宽限器 (
krepapi.accesswidener):合并了在 Minecraft 1.21.11 上与官方 Mojang 映射兼容的 MoulConfig 宽限器条目子集,以便着色后的 UI 能够渲染而不会引发IllegalAccessError。 - 屏幕界面:
KrepapiMenuScreen构建了一个 MoulConfigGuiComponent树(外层为 VANILLA 面板,浅色 标题栏,全宽分隔线,两个DARK_RECT列)。左侧:“Changelogs” 标题,紫红色下划线,虚线分隔符,可点击的版本行(选中时为青色 + 下划线)。右侧:灰色副标题,缩放的大标题 “Changelog entries for v…”,以及格式化的正文 Markdown(黄色#,紫红色##,绿色###,灰色项目符号;##部分后的第一个顶级项目符号高亮为白色以匹配参考布局)。 - 标题缩放:动态采用
min(2×, 自适应宽度),确保长标题在滚动视口内 不被截断(修复了v1.风格标题被截断的问题)。 - ModMenu:
modImplementationModMenu 17.0.0-beta.2,专用KrepapiModMenuEntry→KrepapiModMenuIntegration配置屏幕工厂;fabric.mod.json扩展了custom.modmenu(主页、问题反馈、GitHub 链接、update_checker)。 - 辅助 UI 类型位于
net.shik.krepapi.client.ui.KrepapiMenuComponents:FullWidthRuleComponent、VersionNavRow、ChangelogHeadlineComponent、StatusBadgeComponent。
Fabric 26.1.x — 原版更新菜单
KrepapiMenuScreen26:使用 原版Screen组件实现相同的更新语义和 Markdown 展示(此加载器不使用 MoulConfig / Shadow)。
结构化调试日志(可选)
- Paper (
KrepapiPaperPlugin) 和 Fabric 服务器网络:当启用debug-logging、JVM 标志或标记文件时,将握手、断开连接、版本踢出以及鼠标/键盘事件的 NDJSON 风格 行追加到服务器 KrepAPI 数据文件夹下的时间戳文件中。
修复
- 菜单状态:仅当远程
versionList中缺少selectedVersion(或未初始设置)时才重置它,因此重新打开菜单时会保留用户选择的更新日志版本。 - 更新日志标题:避免了因固定 2× 缩放超出滚动裁剪区域而导致截断版本号后缀的问题;标题现在根据可用宽度进行缩放(最大 2×)。
- 布局:标题栏宽度考虑了 面板边距,以确保顶栏、分隔线和主体列在设计好的内部宽度处保持 对齐。
更改
fabric-1-21/build.gradle:应用 GradleUp Shadow 插件,配置shadowModImpl/shadowImpl,remapJar输入来自shadowJar;使用 Maven Central 作为 Kotlin 源;使用构建时使用的 ModMenu 和 MoulConfig 坐标。fabric.mod.json(1.21):通过KrepapiModMenuEntry添加contact、custom.modmenu、entrypoints.modmenu;调整了 mixin / 客户端资源布局(例如整合了krepapi.mixins.json,移除了冗余的客户端 mixin 描述符)。fabric-26-1:使fabric.mod.json、mixin 配置和 访问宽限器 与用于更新 UI 的分离客户端/主程序设置保持一致。gradle.properties:将此发布线的mod_version设置为 1.3.0。- Paper:对默认最低模组构建与已发布模组对齐进行了轻微的
config.yml/KrepapiPaperVersionGate/KrepapiPaperPlugin调整。 :protocol测试:更新了KrepapiBuildVersionTest、KrepapiVersionPolicyTest、KrepapiVersionRequirementTest以适应当前的版本策略行为。- 仓库规范:添加了
.gitignore条目以忽略编辑器生成的*Edit conflict*/*Name clash*重复源文件。
文档
- 远程
versions.json和 更新日志 路径继续在仓库内的.system/mod/下记录,供客户端使用的更新检查器 URL 引用。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器

评论 0
登录后参与评分
还没有评论,来抢沙发吧