Skip to content

Releases: UnderarmCape/underarmcape-bar-controller-support-attempt-01

BAR Controller Support v0.5.1 — Widget + Companion Gameplay Fixes

14 Jun 07:37

Choose a tag to compare

BAR Controller Support v0.5.1 — Widget + Companion Gameplay Fixes

This release updates the Widget + Companion package with gameplay fixes on top
of v0.5.0.

This package still does not require a custom Recoil engine. It installs the
Lua controller widgets and a local Windows companion bridge that sends
controller state to BAR over localhost.

Fixes in v0.5.1

  • Fixed Tactical radial Area Mex visibility for eligible
    builders/constructors/commanders.
  • Fixed Hold X + multi-unit drag path issuing Fight instead of Move.
  • Fixed Smart X with a T2 construction bot on an existing T1 mex crashing
    gui_controller_camera_test.lua.

What the package includes

  • BAR controller Lua widgets.
  • BARControllerBridge.exe.
  • BARControllerLauncher.exe.
  • EXE installer.
  • EXE restore tool.
  • Shortcut patching so the normal BAR Desktop and Start Menu shortcuts start
    the bridge first, then launch BAR.
  • Auto-enabling of required controller widgets:
    • Controller Camera Test
    • Controller Bindings UI
  • CamSpringLockCardinalDirections = 0 enforcement to prevent 90-degree camera
    rotation snapping.
  • Restore support for patched shortcuts/widgets.
  • No BAR.exe modification.
  • No custom Recoil engine requirement.

Install

  1. Download BAR_Controller_Support_v0.5.1_Widget_Companion.zip.
  2. Extract the ZIP.
  3. Run BAR_Controller_Companion_Installer_v0.5.1.exe.
  4. Launch BAR from the normal Desktop or Start Menu shortcut.
  5. Start a match. Controller support should work without opening F11.

Restore / Uninstall

Run:

BAR_Controller_Companion_Restore_v0.5.1.exe

This restores patched BAR shortcuts and backed-up widget files where backups
exist.

Checksum

SHA256:

4ef74e85ce729d1bcd89681dedb02787b163a0f8c472fa50fa047aa848dcf3d3

Checksum file:

BAR_Controller_Support_v0.5.1_Widget_Companion.zip.sha256

Windows SmartScreen note

The included EXEs are currently unsigned, so Windows SmartScreen may show a
warning on first launch.

Notes

v0.5.1 is a gameplay-fix release based on the v0.5.0 Widget + Companion
release.

BAR Controller Support v0.5.0 — Widget + Companion Release

14 Jun 05:55

Choose a tag to compare

BAR Controller Support v0.5.0 — Widget + Companion Release

This is the first easy-install Widget + Companion release of BAR Controller Support.

This release does not require a custom Recoil engine. It installs the Lua controller widgets and a local Windows companion bridge that sends controller state to BAR over localhost.

What this release does

  • Installs the BAR controller Lua widgets.
  • Installs BARControllerBridge.exe.
  • Installs BARControllerLauncher.exe.
  • Patches the normal BAR Desktop and Start Menu shortcuts so the bridge starts first, then BAR launches normally.
  • Enables the required controller widgets automatically:
    • Controller Camera Test
    • Controller Bindings UI
  • Sets CamSpringLockCardinalDirections = 0 to prevent 90-degree camera rotation snapping.
  • Includes a Restore EXE to restore shortcuts/widgets if needed.
  • Does not modify BAR.exe.
  • Does not require a custom Recoil engine.

Install

  1. Download BAR_Controller_Support_v0.5.0_Widget_Companion.zip.
  2. Extract the ZIP.
  3. Run BAR_Controller_Companion_Installer_v0.5.0.exe.
  4. Launch BAR from the normal Desktop or Start Menu shortcut.
  5. Start a match. Controller support should work without opening F11.

Restore / Uninstall

Run:

BAR_Controller_Companion_Restore_v0.5.0.exe

This restores patched BAR shortcuts and backed-up widget files where backups exist.

Checksum

SHA256:

584f20ad10afdfbb35ccab247b69f0173c72ea6a7388ba01c3597cd0cef7213e

Checksum file:

BAR_Controller_Support_v0.5.0_Widget_Companion.zip.sha256

Windows SmartScreen note

The included EXEs are currently unsigned, so Windows SmartScreen may show a warning on first launch.

Known tracked issues

These are known controller gameplay issues and were deliberately not fixed in this release pass:

  • Tactical radial is missing Area Mex for builders/constructors/commanders.
  • With multiple units selected, hold X + drag path currently fires Fight instead of Move.
  • With a T2 construction bot selected, using Smart X on an existing built T1 mex to upgrade it to T2 can crash gui_controller_camera_test.lua.

These are planned for the next gameplay bugfix pass.

BAR Xbox Controller Support v0.4.6 - AIO Clean Installer

07 Jun 12:38

Choose a tag to compare

BAR Xbox Controller Support v0.4.6 - AIO Clean Installer

This prerelease is the full v0.4.6 AIO clean installer. It uses the proven
two-payload v0.4.5 installer structure so the controller-enabled engine and
vanilla BAR payload remain below GitHub's per-file upload limit.

Highlights

  • Full controller pregame flow: commander placement and Ready button.
  • Controller Mouse Mode with LuaUI clicks.
  • Controller Mouse Mode speed presets.
  • Mouse edge clamp behavior.
  • Pregame camera modifiers.
  • Factory insert-to-front modifier using native Alt behavior.
  • T2 metal extractor Smart X upgrades.
  • T2 geothermal Smart X upgrades.
  • Build/factory radial center information with unit description and stats.
  • Build placement spacing fixes.
  • Build placement slow pan default.
  • Dedicated air transport controls from v0.4.5.
  • Command Toast feedback.
  • Area Mex, Repair, and Reclaim radial improvements.

What Is Included

  • The working controller-enabled Recoil 2025.06.24 engine/base from the
    previous AIO. No new engine was compiled for v0.4.6.
  • The official vanilla BAR.sdd payload used by the previous clean AIO.
  • Five current v0.4.6 Lua widgets:
    • gui_controller_camera_test.lua
    • gui_pregameui.lua
    • cmd_area_mex.lua
    • gui_controller_bindings_ui.lua
    • gui_controller_smartx_mouse_audit.lua
  • A clean installer BAT that verifies and combines exactly two payload ZIPs.

Install Instructions

Download these files into the same folder:

  1. Install_BAR_Controller_Support_v0.4.6_AIO_CLEAN_INSTALL.bat
  2. README_AIO_CLEAN_INSTALL_v0.4.6.txt
  3. BAR_Controller_Support_v0.4.6_AIO_PAYLOAD_1_OF_2.zip
  4. BAR_Controller_Support_v0.4.6_AIO_PAYLOAD_2_OF_2.zip
  5. BAR_Controller_Support_v0.4.6_AIO_RELEASE_NOTES.md

Do not manually extract either payload ZIP. Run the BAT installer.

Optional validation commands:

Install_BAR_Controller_Support_v0.4.6_AIO_CLEAN_INSTALL.bat --payload-check
Install_BAR_Controller_Support_v0.4.6_AIO_CLEAN_INSTALL.bat --dry-run

Known Limitations

  • Multiplayer remains blocked or limited by the custom engine requirement
    until engine support is upstreamed and adopted.
  • Chobby/LuaMenu overlays and native engine UI are not controllable through
    in-game LuaUI click dispatch.
  • Multi-unit X freehand drawn-path movement remains disabled and reverted.
  • cmd_area_mex.lua remains included until BAR PR beyond-all-reason#7874 or an equivalent API
    is accepted upstream.
  • gui_pregameui.lua is included because v0.4.6 exposes the small
    WG.pregameui controller Ready API.

Upstream Status

BAR Area Mex Lua API PR:
beyond-all-reason#7874

Recoil controller input support remains separate.

Rollback

The installer backs up the active BAR.sdd, local Chobby override if present,
and recoil_2025.06.24 engine slot under:

data\controller-support-v046-aio-clean-backups\<timestamp>

Restore those folders manually or reinstall the previous known-good AIO.

Manual Test Checklist

  • Installer --payload-check passes.
  • Installer performs a clean install without hash or extraction errors.
  • BAR launches in Singleplayer: Beyond All Reason Dev.
  • A/X places the commander during pregame.
  • A/X activates Ready after placement.
  • Mouse Mode toggles with Back + Start.
  • Back tap cycles all Mouse Mode speed presets.
  • Mouse Mode clamps at all four screen edges without camera edge-pan.
  • Pregame LB + right stick rotates and tilts.
  • Pregame LB + LT + right stick Y zooms.
  • Build and factory radials show name, description, and stats.
  • Factory insert-to-front still uses native Alt behavior.
  • T2 metal extractor and geothermal Smart X upgrades still work.
  • Dedicated air transport controls still work.
  • No Lua errors or OpenGL stack errors occur.

Files Included

  • Install_BAR_Controller_Support_v0.4.6_AIO_CLEAN_INSTALL.bat
  • README_AIO_CLEAN_INSTALL_v0.4.6.txt
  • BAR_Controller_Support_v0.4.6_AIO_PAYLOAD_1_OF_2.zip
  • BAR_Controller_Support_v0.4.6_AIO_PAYLOAD_2_OF_2.zip
  • BAR_Controller_Support_v0.4.6_AIO_RELEASE_NOTES.md
  • BAR_Xbox_Controller_Support_AI_Continuation_Pack_v0.4.6_STREAMLINED.zip
  • PACKAGE_INVENTORY_v0.4.6_AIO.md

SHA256 Hashes

  • Install_BAR_Controller_Support_v0.4.6_AIO_CLEAN_INSTALL.bat
    C5771003ED4C1EB2290FF66700FB357959732164907D6D730D3AE27670D1A90A
  • BAR_Controller_Support_v0.4.6_AIO_PAYLOAD_1_OF_2.zip
    A4B89A6BB336AED6AFA616B67F75E189B6673C4ACD6A5AEA7AE383DB7603A481
  • BAR_Controller_Support_v0.4.6_AIO_PAYLOAD_2_OF_2.zip
    B98EB75CC714F25B31E18778A502AD3E41CFCF0AAD424A2053CB781636B9172B

The final hashes for this release-notes file and the continuation pack are
recorded in PACKAGE_INVENTORY_v0.4.6_AIO.md. A file cannot contain its own
final hash, and the continuation pack contains a copy of these release notes.

BAR Xbox Controller Support v0.4.5 - Transport and Hotkey Polish

06 Jun 04:28

Choose a tag to compare

BAR Xbox Controller Support v0.4.5 - Transport and Hotkey Polish

v0.4.5 Video Gameplay:
https://youtu.be/ga1uJImbEL4

This release now supports both a full AIO Clean Install and a Lua-only Incremental Update.


Option 1: AIO Clean Install (Recommended for New Users)

This is the recommended installer for a clean, smooth, stutter-free controller setup. It contains the stable controller-enabled engine, vanilla BAR.sdd, and the latest v0.4.5 widgets.

Installation Instructions:

  1. Download all of the following files from the release assets into the same folder:
    • Install_BAR_Controller_Support_v0.4.5_AIO_CLEAN_INSTALL.bat
    • README_AIO_CLEAN_INSTALL_v0.4.5.txt
    • BAR_Controller_Support_v0.4.5_AIO_PAYLOAD_1_OF_2.zip
    • BAR_Controller_Support_v0.4.5_AIO_PAYLOAD_2_OF_2.zip
    • BAR_Controller_Support_v0.4.5_AIO_RELEASE_NOTES.md
  2. Double-click the BAT file to run it:
    Install_BAR_Controller_Support_v0.4.5_AIO_CLEAN_INSTALL.bat
    (Do not manually extract the payload ZIPs; the BAT validates and extracts them automatically).

Option 2: Incremental Lua Update (For Existing v0.4.3/v0.4.4 Users)

If you already have a working v0.4.3/v0.4.4 controller engine installed:

  1. Download and extract BAR_Controller_Support_v0.4.5_INCREMENTAL_LUA_WIDGETS.zip.
  2. Copy the included luaui\Widgets\*.lua files and overwrite them inside:
    C:\Users\kaili\AppData\Local\Programs\Beyond-All-Reason\data\games\BAR.sdd\luaui\Widgets\

Highlights in v0.4.5

  • Dedicated air transport controls: Select air transports to activate dedicated command routing.
    • X tap over pickup-capable allied unit loads instead of guarding.
    • X tap over ground moves the transport.
    • LB + X Load Unit / LB + Hold X Load Area (auto-anchor center).
    • LB + A Unload / LB + Hold A Unload Area (auto-anchor center).
  • Command Toast feedback polish: Clean visual toasts trigger once per action without spam.
  • Builder area command auto-anchors:
    • Builder LB + A Repair Area auto-anchor.
    • Builder LB + X Reclaim Area auto-anchor.
  • Build placement updates:
    • Build placement slow/full pan toggle.
    • Removed [X] Stay from the placement UI.
  • Affordability visual tweaks:
    • Unaffordable build items remain readable.
    • Reduced affordability caching flicker.
  • Cleaned selection rendering:
    • Removed the redundant extra green selected-unit highlight circle drawn by the controller widget, preserving the native BAR outlines.

Payload Integrity (SHA256 Hashes)

  • BAR_Controller_Support_v0.4.5_AIO_PAYLOAD_1_OF_2.zip:
    EE1A5AEF034E4ED2DEBBE07CC87ED78D75659C95C3932CF5DB2CD403E4CF9EB3
  • BAR_Controller_Support_v0.4.5_AIO_PAYLOAD_2_OF_2.zip:
    18E525AABC4B36D900688D9C4CC91DA4A39AF5FDB5B5F3E5FC8E84206E1E333E
  • BAR_Xbox_Controller_Support_AI_Continuation_Pack_v0.4.5_STREAMLINED.zip:
    E62AE7CD45685B7AFF1B26117776F3CAEC019E75A230A35F1CD109E2523734E2

BAR Controller Support v0.4.3 Queue Polish - AIO Clean Install

02 Jun 12:45

Choose a tag to compare

BAR Controller Support v0.4.3 Queue Polish - AIO Clean Install

This is the current recommended installer for normal users.

This release is distributed as a small installer BAT plus PAYLOAD ZIP files because GitHub release assets must stay under the per-file upload limit.

Install

  1. Download the BAT, README, and all PAYLOAD ZIP files.
  2. Keep them in the same folder.
  3. Run Install_BAR_Controller_Support_v0.4.3_QUEUE_POLISH_AIO_CLEAN_INSTALL.bat.
  4. The BAT extracts, validates, and installs the payload automatically.

Do not manually extract the PAYLOAD ZIP files.

Why this release exists

Older full BAR.sdd packaging caused periodic RTSS frametime stutter. Testing confirmed that a fresh official vanilla BAR.sdd plus the stable controller-enabled Recoil 2025.06.24 compatibility engine and latest v0.4.3 Queue Polish LuaUI widgets runs smooth and keeps controller support working.

What is included

  • Fresh official vanilla BAR.sdd payload
  • Stable controller-enabled Recoil 2025.06.24 compatibility engine payload
  • v0.4.3 Queue Polish LuaUI controller widgets
  • Clean payload-driven installer BAT
  • README_AIO_CLEAN_INSTALL.txt

What is not included

  • No old backed-up BAR.sdd
  • No old full/bloated BAR.sdd package
  • No local BYAR Chobby.sdd
  • No Attempt 02 engine
  • No Git requirement
  • No GitHub CLI requirement
  • No internet requirement during install

Release Assets

Download all of these files into the same folder:

  • Install_BAR_Controller_Support_v0.4.3_QUEUE_POLISH_AIO_CLEAN_INSTALL.bat
  • README_AIO_CLEAN_INSTALL.txt
  • BAR_Controller_Support_v0.4.3_QUEUE_POLISH_AIO_PAYLOAD_1_OF_2.zip
  • BAR_Controller_Support_v0.4.3_QUEUE_POLISH_AIO_PAYLOAD_2_OF_2.zip

Notes

This AIO installer backs up existing BAR.sdd, BYAR Chobby.sdd, and recoil_2025.06.24 folders before replacing active files. It intentionally removes local BYAR Chobby.sdd from the active games folder to avoid old local install clutter.

BAR Xbox Controller Support v0.4.3 - Queue Polish

31 May 12:06

Choose a tag to compare

Legacy notice:
This release is legacy/cluttered. Use the AIO Clean Install release instead:
https://github.com/UnderarmCape/underarmcape-bar-controller-support-attempt-01/releases/tag/controller-support-v0.4.3-queue-polish-aio-clean-install

BAR Xbox Controller Support v0.4.3 - Queue Polish

This is the normal v0.4.3 release for BAR Xbox Controller Support. It is not a prerelease.

Important Requirement / Current Recommended Install

This mod still requires the custom controller-enabled Recoil engine, but the current recommended installer no longer installs the old full controller-support BAR.sdd package.

Use:

  • Install_BAR_Controller_Support_v0.4.3_QUEUE_POLISH_FINAL_CLEAN_INSTALL.bat
  • or BAR_Controller_Support_v0.4.3_QUEUE_POLISH_FINAL_CLEAN_INSTALL_PACKAGE.zip

The final clean installer uses:

It does not install:

  • old backed-up BAR.sdd
  • local BYAR Chobby.sdd
  • old bloated full BAR.sdd package
  • Stutter Fix Attempt 02 engine
  • LuaRules/controller game-side files

The previous full BAR.sdd packaging caused periodic RTSS frametime stutter on the user's test system. Fresh official BAR.sdd plus the latest LuaUI widgets and stable compatibility engine tested smooth and restored controller functionality.

Installer Hotfix

The final clean installer now detects the actual Windows Desktop path using Windows known-folder detection, so it works correctly on systems where Desktop is redirected to OneDrive. The log file is written to the detected Desktop path; if Desktop detection fails, the installer falls back safely instead of crashing.

Engine

Required engine release:

https://github.com/UnderarmCape/controllersupport-RecoilEngine-attempt-01/releases/tag/controller-support-recoil-2025-06-24-compat

Engine asset:

recoil_2025.06.24-controller-support-pr2985-win64.zip

The engine preserves the PR beyond-all-reason#2985 Lua controller polling API:

  • Spring.GetAvailableControllers()
  • Spring.GetControllerState(instanceID)

LuaUI Widgets

Primary widgets:

  • gui_controller_camera_test.lua
  • gui_controller_bindings_ui.lua

Optional diagnostic widget:

  • gui_controller_smartx_mouse_audit.lua
  • Disabled by default.
  • Use only for Smart X diagnostics.

Highlights

  • Built on v0.4.2 Smart X calibration.
  • Queue Polish.
  • Fixed Y Do Next queue insertion using vanilla INSERT behavior.
  • Fixed Y-held consecutive line/drag move queue continuation.
  • Removed redundant blue controller move preview overlay.
  • Preserved vanilla move path arrows/waypoints.
  • Added/fixed RT + A individual multi-select accumulation.
  • Final clean install packaging uses fresh official BAR.sdd, not the old full replacement package.

Preserved Smart X Fixes

  • Reclaim, Resurrect, Repair, and Guard target behavior.
  • Mex radius around 55 elmos.
  • Exact target priority.
  • Wreck beats mex priority.
  • Smart X Reclaim/Resurrect/Repair/Guard manual tests passed.

Other Confirmed Working Systems

  • Hold A brush selection.
  • Hold A + X brush filter radial.
  • Compact build menu scaling.
  • RT append.
  • Y + RT priority.
  • DGUN mode.
  • Self-destruct Back/View + R3 + L3.
  • Tactical radial.
  • Build/factory radial.

Known Deferred Work

  • Full vanilla Area Mex behavior.
  • Settings UI reset X/Y crash.
  • Selected-unit type cycling with D-pad Left/Right.
  • Area Mex clue: mouse audit reports Active Command ID = 11 when Area Mex command is active.

Do not claim Area Mex is fixed in this release.

Manual Test Checklist

Install:

  • Run the final clean installer.
  • Confirm gui_controller_camera_test.lua loads.
  • Confirm gui_controller_bindings_ui.lua loads.
  • Confirm the game uses the Recoil 2025.06.24 compatibility/custom engine.

Clean install verification:

  • Launch BAR normally.
  • Open Settings > Developer.
  • Set Singleplayer to Beyond All Reason Dev.
  • Start a local match.
  • Confirm no periodic RTSS stutter.
  • Confirm Xbox controller HUD and input work.

Smart X:

  • Con bot over wreck: Reclaim.
  • Res bot over wreck: Resurrect.
  • Damaged allied target: Repair/Guard.
  • Mex near 40 elmos: protected behavior.
  • Mex near 75 elmos: Move allowed.
  • Wreck near mex: wreck wins.

Queue controls:

  • Queue 4 moves, hold Y, issue new Move: new Move goes next/front and old queue remains.
  • Hold Y and draw consecutive move lines: second line continues previous queued path.
  • Hold RT and draw move lines: append works.
  • Y + RT: Y priority.

Selection:

  • Hold A brush works.
  • A + X filter radial works.
  • RT + A individual unit add works.

Visuals:

  • No extra blue controller move preview line/circles.
  • Vanilla move path visuals remain.
  • Compact build menu scaling works.

Existing controls:

  • DGUN.
  • Self-destruct Back/View + R3 + L3.
  • Tactical radial.
  • Build/factory radial.

Optional:

/luaui enablewidget "Controller SmartX Mouse Audit"

BAR Xbox Controller Support v0.4.2 - Smart X Calibrated

31 May 10:22

Choose a tag to compare

BAR Xbox Controller Support v0.4.2 — Smart X Calibrated

This is a milestone release for the community-driven Beyond All Reason (BAR) Xbox Controller Support project.

Important

CRITICAL ENGINE REQUIREMENT: This controller support mod REQUIRES a custom controller-enabled BAR/Recoil engine compatibility layer build to function. The LuaUI widgets alone are NOT sufficient; they rely on controller-specific C++ APIs introduced in the custom engine. If you do not install the compatibility engine first using the automated installer inside this package, your controller inputs will not be recognized.


1. Release Classification

  • Milestone Release: This is a normal public GitHub release, representing the current best, most advanced, and feature-rich build of the controller widgets and presets.
  • Active WIP: Although this is the best public build, it is still a community work-in-progress. Expect some rough edges.
  • Earlier Baselines: The v0.4.1 and v0.4.0 stable releases remain fully preserved on the GitHub releases page.

2. What's New in v0.4.2

Smart X Calibration Fixes

This release fixes several Smart X (smartAction) targeting accuracy issues that were identified using the new SmartX Mouse Audit diagnostic widget:

Issue Root Cause Fix
Oversized mex no-Move blocking radius snap-build radius (160 elmos) was reused for mex context-checking Corrected to 55 elmo context radius matching vanilla mouse behavior
Exact wreck/unit/building targets ignored near mex spots Mex context check ran before exact-target evaluation Reordered: exact targets now evaluated first, mex check only as fallback
Wrong Resurrect command ID "restore" keyword matched terrain command (110) before Resurrect (125) Corrected Resurrect command keywords and descriptor lookup to use cmdID 125

Conservative Code Cleanup

  • Removed permanently-dead legacy settings UI code block (LEGACY_CONTROLLER_SETTINGS_UI_ENABLED = false) — 25 lines of unreachable code eliminated without any behavioral change.

New Diagnostic Tool (Disabled by Default)

  • SmartX Mouse Audit Widget (gui_controller_smartx_mouse_audit.lua) — a read-only diagnostic overlay for observing vanilla mouse smart/context behavior. Useful for future calibration comparison. Disabled by default. Enable only when debugging:
    /luaui enablewidget "Controller SmartX Mouse Audit"
    

3. Target Installation Order (Summary)

This release package contains both the required widgets and the installer for the custom engine compatibility build:

  1. Engine: Open the required_engine_installer/ folder and run Install_BAR_Controller_Support_v0.4.2_SMARTX_CALIBRATED.bat to automatically download the compiled custom engine, back up active stock files, configure devmode, and disable cardinal camera locks.
  2. Widgets: The installer clones the controller-support-current-master-engine-shim branch directly, which includes all three controller widgets:
    • gui_controller_camera_test.lua — main controller logic
    • gui_controller_bindings_ui.lua — bindings/settings UI
    • gui_controller_smartx_mouse_audit.lua — diagnostic widget (disabled by default)
  3. Launch BAR: Select Settings > Developer, choose Beyond All Reason Dev in the Singleplayer dropdown, and configure your presets!

4. Feature Highlights

  • Smart X Context Commands: Controller right-stick cursor + X button issues smart context commands — Reclaim, Resurrect, Repair, Guard, Build Mex — with calibrated targeting matching vanilla mouse behavior.
  • Smart X No-Move Guard: Prevents accidental Move orders over protected smart targets (wrecks, mex spots, damaged allied units/buildings).
  • Binding Presets System: Includes Balanced RTS and Build-First Commander preset configurations.
  • Build / Factory Radial Menu: Map unit and structure factory blueprints onto a convenient visual radial menu.
  • Shift-Style Command Queuing (RT): Holding RT appends commands to queue end.
  • Do Next / Insert Front Command (Y or RB): Prepend urgent commands to the front of the queue with queue preservation.
  • Hold A Live Brush Selection: Hold A to accumulate mobile units in a live radius brush. Units are added as the brush touches them.
  • A + X Selection Filter Radial: While holding A, press X to open a filter radial (All Mobile / Combat / Builders / Air).
  • RT + A & RT + X Append Placement: Queue multiple building placements without interrupting production.
  • Grid Placement Lock (LB): Holding LB during placement locks coordinates to the grid.
  • LB Tap Placement Pattern Cycle: Tapping LB cycles through layout patterns.
  • Split Queue Removal (L3 / R3):
    • Left Stick Click (L3): Deletes the current/next queued command.
    • Right Stick Click (R3): Deletes the last queued command.
  • Command Layer (Back/View): Toggles the command HUD and quick tactical overlays.
  • Group Layer (Start/Menu): Switch to the Group layer to assign or recall unit groups.

5. Preset Mappings Overview

Balanced RTS Preset

  • A = Select / Confirm / Place
  • B = Cancel / Clear / Deselect
  • X = Move / Smart Context Command
  • Y = Do Next / Insert Front Command Modifier
  • RB = Build / Factory Radial Menu
  • RT = Append Queue (Shift-style Queue)
  • LT = Camera Speed Modifier
  • LB = Camera Pitch / Grid & pattern controls (during placement)
  • Back/View = Command Layer Modifier
  • Start/Menu = Group Layer Modifier
  • Left Stick Click (L3) = Remove Current/Next Queue Item
  • Right Stick Click (R3) = Remove Last Queue Item

Build-First Commander Preset

  • A = Select / Confirm / Place
  • B = Cancel / Clear / Deselect
  • X = Move / Smart Context Command
  • RB = Build / Factory Radial Menu
  • Y = Do Next / Insert Front Command Modifier
  • RT = Append Queue (Shift-style Queue)
  • LT = Camera Speed Modifier
  • LB = Camera Pitch / Grid & pattern controls (during placement)
  • Back/View = Command Layer Modifier
  • Start/Menu = Group Layer Modifier
  • Left Stick Click (L3) = Remove Current/Next Queue Item
  • Right Stick Click (R3) = Remove Last Queue Item

6. Smart X Behavior Reference (v0.4.2)

Scenario Expected Behavior
Con bot reticle over wreck Reclaim (cmdID 90)
Res bot reticle over wreck Resurrect (cmdID 125)
Reticle over damaged allied unit/building Repair (cmdID 40) or Guard (cmdID 25)
Reticle over empty mex spot Build Mex (negative cmdID)
Reticle within ~55 elmos of built mex No-Move guard (protected)
Reticle over wreck that is near a mex spot Wreck target wins over mex
Reticle over open ground, no nearby targets Move (cmdID 10)

7. Manual Test Checklist (For User — Not Yet Verified)

Note

The following checklist has NOT been verified by the release packager. The user should run this after installing v0.4.2.

A. Launch BAR with custom controller-enabled engine.

B. Confirm widgets load (no Lua errors in infolog):

  • gui_controller_camera_test.lua
  • gui_controller_bindings_ui.lua

C. Controller basics:

  • Camera move/rotate/zoom
  • Build/factory radial
  • Tactical radial
  • DGUN mode
  • Self-destruct (Back/View + R3 + L3)

D. Smart X:

  • Con bot over wreck → Reclaim
  • Res bot over wreck → Resurrect
  • Damaged allied unit/building → Repair/Guard as appropriate
  • Built mex at ~40 elmos → No-Move guard active
  • Built mex at ~75 elmos → Normal Move allowed
  • Wreck exactly on mex spot → Wreck wins, not mex

E. Y Do Next:

  • Queue 4 moves
  • Hold Y + issue new move → new move executes next, old queue remains

F. Hold A brush:

  • Brush selects mobile units as touched
  • A + X filter radial works (All Mobile / Combat / Builders / Air)

G. Compact build menu:

  • Scale setting changes build menu size

H. Optional SmartX Mouse Audit (debugging only):

/luaui enablewidget "Controller SmartX Mouse Audit"

8. Documented Known Issues

  • Commander Focus Utility: The Back/View + A + A shortcut (focus/select Commander) is currently unreliable. This is a documented limitation for a future release.
  • Settings UI X/Y Crash: In certain edge cases the settings UI reset may crash. This is a known non-blocker deferred to a future release.
  • Area Mex: Full vanilla Area Mex behavior is deferred. Smart X handles individual mex spot building correctly.

BAR Xbox Controller Support v0.4.4 - Radial UI Polish

04 Jun 14:16

Choose a tag to compare

BAR Xbox Controller Support v0.4.4 - Radial UI Incremental Lua Update

v0.4.4 is a non-AIO Lua-only incremental update.

  • Engine status: No engine code changed.
  • Installer status: No installer BAT changed. No new engine build required.
  • Requirements: Requires v0.4.3 AIO / controller-enabled engine installed first.
  • Multiplayer status: No multiplayer compatibility change beyond the existing custom-engine limitation.

Highlights

  • Area Mex Route A Controller Fix: Rewired Area Mex aimed placement mode to resolve placement order tracking bugs.
  • Repair Area Direct-Order Fix: Interception and direct issuing of repair orders inside the targeted circle using the custom Route A API, completely bypassing command active locks.
  • Tactical Menu Cleanup: Culled redundant movement state controls and pause-wait commands to prevent OpenGL matrix stack crashes.
  • Preset & Bindings Polish: Removed Balanced RTS fully, leaving Build-First Commander as the default/only preset.
  • Factory & Build Menu Controls: B closes the menus cleanly (does not dequeue), and X is the context-sensitive factory dequeue command.
  • Build Radial Categories & Tuning: Build categories now match the vanilla constructor categories exactly (Economy, Combat, Utility, Build), with direct D-pad category jump actions. Added in-game settings sliders for radial size, text scale, icon scale, border thickness, fill alpha, and item spacing.

Install Instructions

  1. Install v0.4.3 AIO first if not already installed.
  2. Extract BAR_Controller_Support_v0.4.4_INCREMENTAL_LUA_WIDGETS.zip.
  3. Copy the included luaui\Widgets\*.lua files into:
    C:\Users\kaili\AppData\Local\Programs\Beyond-All-Reason\data\games\BAR.sdd\luaui\Widgets
  4. Overwrite matching files.
  5. Launch BAR and play in Singleplayer: Beyond All Reason Dev mode.

Files Included

  • luaui/Widgets/gui_controller_camera_test.lua (Latest controller overlay and radial work)
  • luaui/Widgets/cmd_area_mex.lua (Route A Area Mex executor API)
  • luaui/Widgets/gui_controller_bindings_ui.lua (Bindings preset and settings details mapping)
  • luaui/Widgets/gui_controller_smartx_mouse_audit.lua (Smart X assisted targeting logic)

Testing Checklist

  • Build Menu: Verify category tabs are Economy (green), Combat (red), Utility (blue/purple), and Build (yellow/orange).
  • D-pad Jumps: Verify D-pad Up selects Combat, D-pad Right selects Utility, D-pad Down selects Economy, and D-pad Left selects Build.
  • Factory Queue: Verify X dequeues units from factories and B closes the radial without affecting the queue.
  • Settings Slider: Verify all build radial scaling parameters are adjustable under settings Radials category.
  • Area Mex: Verify placing Area Mex works correctly with controller.
  • Repair Area: Verify staging and confirming a Repair Area command executes repair orders.
  • Preset Cleanup: Verify Balanced RTS is gone and Build-First Commander is the only active option.
  • OpenGL Stability: Verify no stack errors or crash alerts occur.

Known Limitations

  • The custom controller support must be run on custom engine builds (like v0.4.3 AIO), limiting compatibility to local offline testing, singleplayer skirmish, and cooperative play on local servers.
  • Dynamic visual adjustments via the new settings tab require closing and reopening the radial menu to render the new scaled sizes.

Rollback Instructions

To rollback to the original v0.4.3 release state:

  • Re-run the original v0.4.3 AIO clean installer, or
  • Restore the previous v0.4.3 Lua widget files from backup.

BAR Xbox Controller Support v0.4.1 Milestone Build

29 May 16:24

Choose a tag to compare

BAR Xbox Controller Support v0.4.1 Milestone Build

This is a major milestone release for controller support in Beyond All Reason.

Required Install Order

  1. Download and extract the milestone ZIP (BAR_Xbox_Controller_Support_v0.4.1_MILESTONE.zip).
  2. Open required_engine_installer/ folder.
  3. Run Install_BAR_Controller_Support_v0.3.7_RECOIL_2025_06_24_COMPAT.bat (double-click it).
    https://github.com/UnderarmCape/underarmcape-bar-controller-support-attempt-01/releases/download/controller-support-v0.4.1-milestone/Install_BAR_Controller_Support_v0.3.7_RECOIL_2025_06_24_COMPAT.bat
  4. Wait for the engine installer to finish successfully.
  5. Copy the v0.4.1 widget files (gui_controller_camera_test.lua and gui_controller_bindings_ui.lua) from the luaui/Widgets/ folder of this package and paste them into your active widgets folder:
    %LOCALAPPDATA%\Programs\Beyond-All-Reason\data\games\BAR.sdd\luaui\Widgets\ (Choose overwrite/replace if Windows asks).
  6. Launch Beyond All Reason.
  7. Go to Settings > Developer.
  8. Set Singleplayer to Beyond All Reason Dev.
  9. Start a local skirmish.
  10. Enable the controller widget if needed, open the Bindings UI, and apply a preset!

Highlights

  • Build-First Commander preset
  • Balanced RTS preset
  • Build/factory radial support
  • RT append queue / Shift-style queue
  • RT + A and RT + X append placement
  • Do Next / Insert Front modifier
  • LB hold forces Grid placement
  • LB tap cycles placement pattern
  • RB no longer cycles placement modes
  • L3/R3 queue removal during and outside placement
  • Back/View command layer
  • Start/Menu group layer
  • Same-type/future-unit group assignment behavior where supported
  • User-facing Bindings UI and preset system

Known Issue

Back/View + A + A commander teleport/focus/select is currently unreliable and may be ignored. This will be addressed in a later update.

Files

Most users should download the corrected ZIP and follow README_INSTALL_FIRST.md.

The individual Lua files are also attached for manual widget updates, but they still require the custom controller-enabled engine.

BAR Controller Support Engine - Recoil 2025.06.24 Compatibility Build
https://github.com/UnderarmCape/controllersupport-RecoilEngine-attempt-01/releases/tag/controller-support-recoil-2025-06-24-compat

BAR Xbox Controller Support v0.4.1 WIP - Presets and Stick-Click Controls

29 May 12:58

Choose a tag to compare

v0.4.1 WIP Pre-Release — Presets & Stick-Click Controls

WIP — Not Stable. The stable release is v0.4.0 Pre-Alpha. This is in-progress work for the next version.

What's New Since v0.4.0

  • Left Stick Click (L3) / Right Stick Click (R3) are now recognized as bindable inputs.
  • Queue removal redesigned:
    • L3 = Remove current/next queued command
    • R3 = Remove last queued command
  • New action: insertNextCommandModifier (Do Next / Insert Command Modifier) — Back/View hold prepends commands to the front of the order queue.
  • LT is now camera speed only — no longer a queue modifier layer.
  • Binding Presets system added to the Bindings UI:
    • Balanced RTS preset
    • Build-First Commander preset
    • Confirmation modal before applying
    • Active / Inactive / Custom status tracking

Known Issues

  • Build radial/menu action name in preset maps is unverified — build menu may not open from preset bindings.
  • insertNextCommandModifier button assignment (Back/View) may conflict with queue removal — needs evaluation.
  • No full in-game manual test pass completed yet.

Commit

35dd9c94 on branch controller-support-current-master-engine-shim

Files Changed

  • luaui/Widgets/gui_controller_bindings_ui.lua
  • luaui/Widgets/gui_controller_camera_test.lua