Skip to content

About

Web app to import, manage and export controller XML mapping files

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

Star Citizen Keybinding Architect

Continuous Integration Star Citizen Compatibility License: AGPL v3 Fuel the Server

A high-performance visual keybinding management suite, conflict diagnostics engine, and device re-indexer engineered specifically for Star Citizen's CryEngine-derived XML input architecture.

🚀 Live Web Application: https://scbind.com

Star Citizen Keybinding Architect Dashboard

Warning

XML Profile Backup Notice: Always retain offline backup copies of your original and working Star Citizen keybinding XML files (LIVE/USER/Client/0/Controls/Mappings/) before editing, re-indexing, or importing profiles. This suite is provided as-is under the AGPL-3.0 license without warranty; maintainers assume no responsibility or liability for any lost, altered, or overwritten mapping files. If you encounter an issue or want to suggest an improvement, please open a GitHub Issue.


Why Pilots Need This Suite

Configuring complex HOTAS, HOSAS, pedals, and button boxes in Star Citizen's native interface has long suffered from critical engine limitations:

  • Bypasses the In-Game 4-Device Limitation: Star Citizen's console command pp_resortdevices breaks whenever more than 4 input devices are connected. When Windows re-orders your USB controller IDs on reboot, your bindings break. Keybinding Architect allows you to drag-and-drop controller cards to re-order devices and rewrites jsX_ prefixes across the entire XML AST in seconds.
  • Intelligent 4-Tier Conflict Diagnostics: Differentiates harmless overlaps in mutually exclusive flight/ground modes from lethal collisions. Analyzes temporal mechanics (multiTap, press, hold, Master Modes SCM/NAV) and warns you before accidental inputs trigger fatal actions like Self-Destruct, Eject, or Jettison Cargo.
  • Live Hardware Listening Mode: Powered by the HTML5 Gamepad API. Press any physical button or deflect any analog stick or pedal on your desk, and the UI immediately detects the input and filters to the corresponding binding.
  • Lossless CryEngine XML Round-Tripping: Never discards device <options> blocks (axis inversions, sensitivity curves, product GUIDs) and preserves concurrent secondary <addbind> inputs alongside primary <rebind> overrides.
  • WebMCP Browser AI Agent Ready (document.modelContext): Exposes 9 structured client-side tools (get_profile_summary, audit_conflicts, search_bindings_and_catalog, find_unused_joystick_inputs, set_action_binding, auto_fix_obsolete_conflicts, remap_joystick_instances, configure_joystick_options, and workspace_control) so W3C WebMCP-compatible browser AI assistants can audit, search, and configure flight profiles deterministically in memory.

Feature Showcase

1. Visual Hardware Device Rack & Re-Indexing

Re-order your physical flight sticks with intuitive drag-and-drop. Easily swap Joystick 1 and Joystick 2 or assign secondary throttles and pedals without losing custom axis calibrations or curves.

Visual Hardware Device Rack

2. Intelligent Conflict Diagnostics Engine

Filter and audit bindings across four severity tiers:

  • Fatal Collisions (Red): Direct execution collisions or lethal hold-vs-press overlaps (e.g. v_eject vs. v_lights_toggle).
  • Input Warnings (Amber): Latency buffer penalties (~250ms tap buffer delay caused by pairing double-tap with single-tap).
  • Subsumed Redundancies (Purple): Actions where one command functionally encompasses the other (e.g. v_flightready + v_power_set_on).
  • Obsolete / Deprecated: Bindings for systems removed or superseded in modern Star Citizen builds.

Conflict Diagnostics Engine

3. Hardware Device Inspector & Live Controller HUD

DirectInput telemetry interface featuring a 32-button matrix and analog axis deflection meters for physical throttle, stick, rudder, and slider inputs. Includes an Offline Profile Simulation Mode for testing profiles when away from your gaming rig.

Hardware Device Inspector

4. Interactive Binding Editor Modal

Fine-grained control over individual commands. Assign primary <rebind> overrides or additive concurrent <addbind> inputs, configure activation modes (press, hold, double_tap, smart_toggle), adjust multiTap counts, or use the hardware capture listener.

Interactive Binding Editor


Supported Flight Hardware

Keybinding Architect supports all standard DirectInput devices, with tailored presets and telemetry templates for:

  • VKB-Sim: Gladiator NXT EVO, Gunfighter, STECS Throttle, Omni-Throttle (OTA 6-DOF)
  • VIRPIL Controls: VPC MongoosT-50 Series, Constellation Alpha / Alpha Prime, WarBRD
  • Thrustmaster: T.16000M FCS, TWCS Throttle, HOTAS Warthog, TFRP & TPR Rudder Pedals
  • WinWing, Honeycomb, Logitech/Saitek (X52/X56), and custom USB button boxes

Getting Started

1. Live Web Application (Recommended for Pilots)

Launch directly at https://scbind.com in any modern desktop browser.

  • 100% Local Browser Processing: Your XML files never leave your computer.
  • Import Your Profile: Click Import XML to load your exported Star Citizen profile from LIVE/USER/Client/0/Controls/Mappings/ (always keep a backup copy of your original XML files first), or choose one of the built-in Starter Presets (Dual VKB HOSAS, VKB Omni-Throttle OTA, or Thrustmaster T.16000M HOTAS).
  • Re-Index, Audit & Export: Drag and drop controller cards in the Device Rack to fix jsX_ ordering, check Conflict Diagnostics, and click Export XML to save your updated profile.

2. Self-Hosting with Docker / Podman

If you prefer to run a local copy offline on your own machine or home server:

docker-compose up -d --build
# Or with Podman:
podman-compose up -d --build

Open http://localhost:8080 in your browser.

3. Local Development & Contributing

For contributors building from source or extracting new Star Citizen patches with sc-daemon, see CONTRIBUTING.md for full setup, verification, and Pull Request instructions.


Fuel the Server & Community Referral Randomizer

Keybinding Architect is an open-source tool built for the Star Citizen community. If this application saved your bindings or simplified your sim-rig setup, consider contributing a coffee or quantum fuel canister to help support continued maintenance and development:

Fuel the Server on Ko-fi

🎁 Star Citizen Recruit Referral Code Randomizer

The web suite includes a built-in Star Citizen referral code hub:

  • For New Recruits: Enlisting with a referral code grants your new RSI account 5,000 free UEC ($5 USD in-game currency) + active promotional bonus rewards (such as free fly ships or armor sets) during major events.
  • For Supporters & Contributors: The creator's code (STAR-7TZ5-ZNDC) is always permanently in rotation, but anyone who fuels server hosting on Ko-fi or contributes to the project on GitHub (code, bug fixes, controller presets, or patch updates) can have their referral code added to the community randomizer pool (apps/web/src/data/referralCodes.ts)!

Documentation & Resources

  • docs/ARCHITECTURE_BLUEPRINT.md: Full 40KB technical specification, CryEngine cipher routines, and conflict decision formulas.
  • CONTRIBUTING.md: Contributor onboarding, game patch extraction workflow (sc-daemon), PR guidelines, and code standards.
  • infra/tofu/: Maintainer OpenTofu configuration for production deployment to Cloudflare Pages on scbind.com.
  • daemon/README.md: Native Go extraction daemon CLI documentation, Zip64 streaming, and HTTP service reference.
  • TODO.md: Backlog of upcoming features and optional integrations.
  • AGENTS.md: Agent pairing guidelines, non-negotiable invariants, and AI PR disclosure policy.

License

This project is licensed under the terms of the GNU Affero General Public License v3.0 (AGPL-3.0).

About

Web app to import, manage and export controller XML mapping files

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages