BT-Gamepad UI System: Intelligent Virtual Cursor & Keyboard Framework

Transform Your Game's UI with AAA-Level Gamepad Navigation Harness the same intuitive and seamless virtual cursor systems used in AAA blockbusters like Destiny, Assassin's Creed, and modern console titles. BT-Gamepad UI System delivers a professional-grade, highly optimized framework designed to bridge the gap between mouse and controller seamlessly.

🎯 Core UI Systems

Intelligent Virtual Cursor - Zero GC Allocation

• Auto Input Switching: Seamlessly detects and transitions between Mouse and Gamepad inputs automatically based on player activity.
• Magnetic Hover Feel: Dynamic speed multipliers and visual scaling when hovering over interactable UI elements for that premium console feel.
• GC-Free Architecture: Built from the ground up to eliminate per-frame allocations. Uses cached raycast lists and optimized struct-based Gizmo data to ensure 0 bytes of garbage collection overhead.
• Smart Canvas Resolution: Automatically finds and migrates to the highest-priority active canvas, supporting multi-canvas setups and runtime-spawned overlays.

Integrated Virtual Keyboard - Plug & Play

• Universal Support: Out-of-the-box integration for both TextMeshPro (TMP) and Legacy Input Fields.
• Draggable Interface: Fully interactive and draggable keyboard panel using the right thumbstick.
• Smart Layout: Includes Shift/Caps logic, special character sets, and live text preview.
• Auto-Trigger System: Simply add the VirtualKeyboardTrigger to any field, and the system handles the lock/unlock states of the cursor automatically.

UI Aim Assist & Magnetic Friction

• Dynamic Deceleration: The cursor automatically detects interactable UI elements (buttons, sliders, toggles) and applies a customizable speed reduction (friction). This prevents thumbstick overshooting and makes selecting small elements incredibly easy and forgiving.
• Forgiving Hit Detection: Designed to mimic standard console "stickiness," helping players naturally land on and click targets even if their joystick aim isn't pixel-perfect.
• Adaptive Visual Feedback: The cursor isn't just a static image. It dynamically scales up and smoothly transitions colors when entering a valid hit zone, giving the player satisfying, instant confirmation before they even press a button.

Context & Confinement Engine - Modal Control

• Contextual Activation: The cursor only appears when needed. Add VirtualCursorActivator to your pause menus or inventory screens, and the framework suspends itself during actual gameplay.
• Modal Confinement: Clamp the cursor inside specific RectTransform bounds (perfect for popups and modal dialogs) using a robust push/pop stack system.
• Panel Back Handler: Built-in stack-based navigation for closing panels or going back to previous menus using the gamepad's "East/B" button or "Escape".

Haptic Engine - Tactile Feedback

• Smart Rumble: Vibrate the gamepad when the cursor enters a selectable element.
• Dual-Motor Control: Independent sliders for low-frequency and high-frequency motor intensity.
• XInput & DualSense Support: Robust gamepad index tracking ensures the correct physical controller vibrates.

🚀 Production-Ready Features

Comprehensive Editor Tools

• UI Raycast Debugger: Press F8 (customizable) in-editor to visualize UI raycast hits, detect overlapping interactables, and debug confinement blocking in real-time.
• One-Click Demo Scene: Automatically generate a fully wired, ready-to-test canvas with settings panels, input fields, and the virtual keyboard to learn the framework instantly.

Workflow & Architecture

• Cursor Profiles: Use ScriptableObjects to define global cursor speeds, colors, and haptics, allowing you to swap themes or accessibility settings at runtime.
• Persistency: Built-in DontDestroyOnLoad support to keep your cursor manager alive across scene changes.

📊 Proven Performance & Design

• Zero Per-Frame GC: Sustains maximum FPS without stuttering during UI navigation.
• Input System Native: Built exclusively on Unity's modern Input System for maximum compatibility.
• Scalable Architecture: Easily handles nested canvases, Screen Space - Overlay, and Camera-space UI.

🎮 Platform Optimized

• Desktop & Steam Deck Ready: Perfect for PC games that require seamless controller-to-mouse transitions.
• Console Ready: Designed with Xbox and PlayStation controller paradigms in mind (includes native Action mappings).

🛡️ Enterprise QualityBuilt with AAA development standards:

• Extensive, clean, and well-commented C# code.
• Professional support and regular updates.
• Battle-tested architecture focused on high performance.

What You Get

• Complete source code with detailed XML comments.
• VirtualCursorController, VirtualKeyboard, UIRaycastDebugger, and UIPanelBackHandler systems.
• ScriptableObject Profile templates.
• Automated setup tools and example scenes.