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 Quality
Built 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.