KrepAPI (Plugin)

IMPORTANT: Changes to the config file will not take effect until the server is restarted

Added

• Config-driven key bindings — define GLFW keys, display names, categories, optional vanilla override, and server commands under bindings.<id> in config.yml.
• Automatic KrepAPI handshake — sends s2c_hello, validates c2s_client_info, protocol version, and mod build requirements.
• Optional enforcement — require-krepapi and handshake-timeout-ticks to kick players without a timely, valid client response.
• Binding sync — pushes s2c_bindings from configuration after a successful handshake (and a delayed path when require-krepapi is disabled).
• Command execution on key press — c2s_key_action triggers configured commands as the player on PHASE_PRESS only; leading / stripped; execution scheduled on the main thread.
• Per-player cooldown — wall-clock based (~250 ms) to reduce command spam from repeated packets (avoids tick APIs for broader compatibility).
• versionGate(Plugin) API — KrepAPIVersionGate for other plugins to register extra minimum client build constraints (Bukkit plugin name: KrepAPI).
• Auxiliary protocol hooks — sendRawCaptureConfig, sendInterceptKeys, sendMouseCaptureConfig, and getClientCapabilities for advanced integrations (same layout as the KrepAPI reference implementation).
• Single distributable JAR — embeds the net.shik.krepapi.protocol classes alongside the plugin (no separate protocol JAR on the server).
• Gradle composite build — resolves net.shik:protocol from a sibling KrepAPI checkout (../KrepAPI by default).
• Developer-oriented source — short comments on handshake, config → bindings, and key → command flow for use as a template.

Supported environments (intended)

• Paper (not Spigot-only or Sponge); Purpur and similar Paper forks are expected to work but are not separately certified.
• Minecraft / Paper game versions: 1.21.4–1.21.11 and 26.1–26.1.1 (one JAR, compiled against Paper API 1.21.4; api-version 1.21.4 in plugin.yml).
• Java 21 for building; run the server with the Java version required by your Paper build.

Build / tooling

• Gradle wrapper 9.4.x — required so composite inclusion of the KrepAPI monorepo (Fabric Loom subprojects) configures correctly (Gradle 8.8 is insufficient).
• run-paper task for local smoke tests (default minecraftVersion 1.21.4).

Notes

• The net.shik:protocol dependency version in build.gradle must stay aligned with mod_version in the sibling KrepAPI repo’s gradle.properties.
• Players still need the KrepAPI Fabric mod build that matches their Minecraft client version; the plugin only handles the server side.