<div align="center"> <h1>InputEngine</h1> <strong>A seamless cross-platform bridge capturing custom keystrokes from the Minecraft client to the server!</strong> <br /> <img src="https://img.shields.io/badge/1.21.x-grey?style=for-the-badge&logo=minecraft"> <img src="https://img.shields.io/badge/Minecraft-NeoForge-C14408?style=for-the-badge&logo=neoforge&logoColor=white"> <img src="https://img.shields.io/badge/Minecraft-Fabric-C14408?style=for-the-badge&logo=fabricmc&logoColor=white"> <img src="https://img.shields.io/badge/Server-Spigot-FF8F00?style=for-the-badge&logo=spigotmc&logoColor=white"> <img src="https://img.shields.io/badge/license-MIT-blue.svg"> </div> ## 📖 Overview **InputEngine** is a powerful utility mod/plugin designed to capture custom keystrokes from the Minecraft client and transmit them instantly to the server. It allows server-side plugins to react seamlessly to custom client-side keybinds (e.g., Skill 1, Dodge, Open Custom Menu). This project acts as a two-part bridge: a **Client Mod** (Fabric/NeoForge) and a **Server Plugin** (Spigot/Paper). ## ✨ Features * 🎮 **Client-Side Keybinding**: Registers custom keybinds on the client. Fully supports both **Fabric** and **NeoForge**. * ⚡ **Network Bridge**: Sends efficient, lightweight payloads to the server whenever a bound key is pressed or released. * 🌍 **Vanilla Server Compatible**: The networking channel is optional on the client. You can safely keep the mod installed while joining vanilla servers without being disconnected! * 🛠️ **Server-Side API**: Exposes a custom Spigot Event (`PlayerKeyPressEvent`) for developers so your server-side plugins can easily listen and react to player inputs. ## 📥 Installation InputEngine requires both a server-side plugin and a client-side mod to function correctly. ### For Players (Client) 1. Download the correct version for your mod loader (**Fabric** or **NeoForge**). 2. Place the downloaded `.jar` file into your Minecraft client's `mods/` folder. 3. *Fabric Users:* Ensure you have the (https://modrinth.com/mod/fabric-api) installed. ### For Server Owners (Plugin) 1. Download the **Spigot** release file. 2. Place it in your Spigot/Paper server's `plugins/` folder. 3. Restart your server. ## 💻 For Developers (API Usage) If you are developing a Bukkit/Spigot plugin and want to react to a player's key press, you can easily use the API! Listen to the `PlayerKeyPressEvent`: ```java import dev.darkblade.mod.input_engine.server.api.PlayerKeyPressEvent; import org.bukkit.event.EventHandler; import org.bukkit.event.Listener; public class MyPluginListener implements Listener { @EventHandler public void onPlayerKeyPress(PlayerKeyPressEvent event) { if (event.isPressed()) { event.getPlayer().sendMessage("You pressed: " + event.getAction().name()); } else { event.getPlayer().sendMessage("You released: " + event.getAction().name()); } } } ``` > Full example are in the (https://github.com/DarkBladeDev/InputEngine/tree/main/example-plugin) and (https://github.com/DarkBladeDev/InputEngine/tree/main/docs/server/api#readme) ## 📜 License This project is open-source and available under the **MIT License**.