Kadajah's Hotkey & HUD System - Dynamic Plugin Command Binder 

Transform standard menus and slow combat into real-time action. Bind any plugin command or battle skill directly to keyboard keys, gamepad controllers, and touch screens with a fully interactive visual HUD.

Break away from slow, menu-heavy gameplay. Kadajah's Hotkey & HUD System empowers your players by putting your game's most powerful mechanics right at their fingertips. Whether you are using action combat plugins, traditional turn-based battles, custom crafting systems, or interactive map abilities, this plugin allows you to bind any Plugin Command or Skill directly to physical inputs.

Featuring a highly customizable HUD (for both Maps and Battles), interactive visual cooldowns, an in-game player customization menu, gamepad support, and dynamic per-actor logic, your project will immediately feel faster, more responsive, and play like a modern Action-RPG or a highly optimized JRPG.

• v1.0 Release: Initial release featuring dynamic plugin command binding and auto-layout HUD display.
• v1.1 Update: Added "Toggle" functionality to switch between ON and OFF commands with a single keypress, plus custom per-icon X/Y positioning.
• v1.2 Update: Added Plugin Commands to dynamically Hide/Show the HUD, Block/Unblock specific keys during gameplay, and a glowing visual flash effect when cooldowns complete.
• v1.3 Update (NEW): Massive expansion adding Turn-Based Battle integration, an In-Game Customization Menu, Per-Actor dynamic skill mapping, native Gamepad/Controller support, and Full Touch/Click interactions for the HUD!

Key Features

• Turn-Based Battle Integration (NEW): Bring the speed of MMOs to your turn-based combat! The HUD dynamically updates on the fly based on which Actor's turn it currently is, allowing players to cast spells and execute actions with a single keystroke or button press.
• In-Game Customization Menu (NEW): Let your players decide their loadout! Includes a beautifully integrated custom menu scene where players can assign their character's learned skills directly to your predefined hotkeys.
• Gamepad & Touch UI Support (NEW): Fully compatible with Xbox/PlayStation controllers (natively mapping to PAD0-PAD15). Additionally, the HUD is fully touch-sensitive, mobile and mouse players can simply tap the on-screen icons to trigger the mapped action!
• Universal Command Binding: Trigger any command from VisuStella, MogHunter, or your own custom scripts directly from the map screen without ever opening a menu.
• Interactive Visual HUD: Displays your registered hotkeys cleanly on the map and in battle. Customize layout direction (Horizontal or Vertical), icon spacing, and precise screen X/Y coordinates.
• MMO-Style Cooldowns: Set cooldowns in frames (60 frames = 1 second). When activated, icons turn grayscale, display a live numerical countdown timer, smoothly regain their color as they charge, and trigger a bright visual flash when ready for use!
• Smart Toggle Mechanics: Set a hotkey to "Toggle" mode. Pressing the key once executes Command A (e.g., Turn on Flashlight), and pressing it a second time executes Command B (e.g., Turn off Flashlight).
• Conditional Access & Locking:
  • Switch Requirements: Bind a key to require a specific RPG Maker Switch ID. If the switch is OFF, the key cannot be pressed and appears faded.
  • Dynamic Blocking: Use built-in plugin commands to temporarily disable specific keys during story events, dialogue, or puzzles.
• Custom Positioning: Override the automatic grid layout on a per-key basis, allowing you to place specific ability buttons anywhere on the screen.

The Auxiliary Tool: Kadajah Hotkey Editor

Stop guessing syntax and writing complex JSON manually. Design visually.

Included with the plugin is the Kadajah Hotkey Editor, a powerful, offline HTML5 visual design tool. Configuring complex JSON arguments and memorizing plugin syntax can be tedious—this editor automates the entire setup process.

• Automatic Plugin Reading: Simply load your project folder! The editor scans your js/plugins directory, automatically reading all @command, @arg, and @option annotations from every other plugin you have installed.
• Dynamic Argument Forms: Once you select a target plugin and command from the dropdown lists, the tool automatically generates text fields, number inputs, and select boxes for its exact arguments. No coding required!
• Controller Button Selector (NEW): Easily swap between assigning a Keyboard Key or selecting a Gamepad Button directly from an intuitive dropdown list.
• Visual Icon Picker: The editor automatically loads your project's IconSet.png. Simply click the icon preview to open an interactive grid and visually point-and-click the icon you want for your HUD.
• Instant Copy-Paste Code: Once your keys, cooldowns, and toggles are configured, click "Copy to Clipboard" and paste the generated code directly into the Text tab of your RPG Maker MZ parameter list. You are done!

Creative Gameplay Mechanics

• Speed Up Turn-Based Combat: Assign 'Attack' to the 'A' button, 'Guard' to 'B', and let players map their favorite Magic Spells to the triggers. Say goodbye to scrolling through endless lists in battle!
• Real-Time Action Skills: Bind a fireball, dodge roll, or shield spell from an Action-RPG plugin directly to keys like 'Q', 'E', or 'SPACE', complete with visual cooldown timers.
• Quick-Access Quality of Life: Assign your Journal, Quest Log, Fast Travel Map, or Bestiary to keys like 'J' or 'M' for instant, modern menu navigation.
• Interactive Tool Toggles: Create survival mechanics like a "Flashlight" or "Stealth Camo" using the Toggle system. Press 'F' to turn on the light, press 'F' again to turn it off.
• Metroidvania Ability Gating: Start the game with abilities locked. As the player defeats bosses or finds relics, turn on the corresponding Switch ID to permanently illuminate and enable new field abilities on their HUD.

Perfect Game Examples

• Classic Turn-Based JRPGs: Massively speed up the pace of combat by giving players shortcut access to their most-used spells and abilities.
• Action-RPGs & MMOs: Essential for games requiring quick-slot ability bars, real-time combat triggers, and visual cooldown management.
• Survival & Horror Games: Great for managing flashlights, checking radios, or consuming quick-heal items without pausing the tension to navigate a menu.
• Farming & Sim Games: Allow players to instantly switch farm tools, plant seeds, or whistle for their horse with a single button press or screen tap.

Compatibility & Requirements

• Engine: RPG Maker MZ.
• Platforms: Windows, macOS, Linux, Web Browsers, and Mobile.
• Inputs: Fully supports Keyboard, Gamepads (Xbox/PlayStation), and Mouse/Touch Screen tapping.

Technical Specs & Plugin Compatibility

Built for stability. Designed to play nice.

The Kadajah Hotkey System uses clean Method Aliasing for its core engine modifications. It safely extends standard RPG Maker code without overwriting essential functions, ensuring seamless operation alongside your favorite plugin suites.

Modified Classes: The plugin safely extends:

• Game_System: Stores cooldown timers, toggle states, blocked key states, and dynamic per-actor battle mappings.
• Scene_Map & Scene_Battle: Handles real-time input/touch triggers, cooldown updates, and HUD rendering in both maps and combat.
• Scene_Menu & Window_MenuCommand: Injects the custom Hotkey setup scene natively into the engine's main pause menu.
• Input.keyMapper & Input.gamepadMapper: Safely registers custom alphanumeric keys (F1-F12, Space, Shift, etc.) and controller buttons without overwriting default movement mechanics.

Plugin Suite Compatibility:

• Universal Command Reader: Compatible with virtually any MZ plugin that utilizes the standard RPG Maker MZ @command structure (including VisuStella, Galv, MogHunter, etc.).
• HUD & Weather Plugins: Designed to sit cleanly on the screen without interfering with lighting layers, fog, or custom weather overlays.
• Save File Integrity: Cooldowns, toggle states, blocked key statuses, and custom player skill mappings are stored safely within Game_System, meaning all hotkey states persist seamlessly across save and load files.

Terms of Use

• Commercial and non-commercial projects: Allowed.
• Redistribution: You are NOT permitted to resell or redistribute this plugin (.js file) or the editor (.html file), either on its own or as part of a bundle.
• Editing: You ARE permitted to edit the plugin's code for your own project's use. However, you are NOT permitted to redistribute the edited version of the plugin.