BAR Controller Support v0.4.3 - Stutter Fix Attempt 02 Engine

BAR Controller Support v0.4.3 - Stutter Fix Attempt 02 Engine

This prerelease contains the official-launcher test engine for BAR Xbox Controller Support v0.4.3 Queue Polish.

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

Build

• RecoilEngine test repo: UnderarmCape/controllersupport-RecoilEngine-attempt-01
• Source branch: stutter-fix-attempt-02
• Commit: 703a5c58aae59bf27e18be5f4fe8a9ab47b5d037
• GitHub Actions run: https://github.com/UnderarmCape/controllersupport-RecoilEngine-attempt-01/actions/runs/26747195739
• Artifact: recoil-controller-amd64-windows-703a5c58aae59bf27e18be5f4fe8a9ab47b5d037

Debug Launcher Test Result

RTSS periodic ~2 second stutter was completely gone in the Debug Launcher test for this Attempt 02 engine.

Main Attempt 02 Changes

• InputHandler::PushEvents now uses one explicit SDL_PumpEvents() followed by SDL_PeepEvents(), avoiding repeated implicit SDL_PollEvent pump work.
• SDL joystick events are disabled while SDL game-controller events remain enabled.
• Controller add/remove/remap events have a 1000ms duplicate-event debounce.
• Duplicate controller add for an already tracked device is skipped.
• vJoy/virtual joystick devices are filtered during scan/add handling.
• VSync/rendering code was not touched.

Included Assets

• recoil-controller-amd64-windows-703a5c58aae59bf27e18be5f4fe8a9ab47b5d037.zip
• recoil-controller-amd64-windows-703a5c58aae59bf27e18be5f4fe8a9ab47b5d037.zip.sha256
• controller-windows-build-logs-703a5c58aae59bf27e18be5f4fe8a9ab47b5d037.zip

Status

Prerelease testing build only. This does not replace the stable BAR controller support release.

BAR Controller Support v0.4.3 - Stable Diagnostic Engine

BAR Controller Support v0.4.3 - Stable Diagnostic Engine

Purpose

Fresh vanilla BAR.sdd test package for BAR Xbox Controller Support v0.4.3 Queue Polish using the prior stable diagnostic controller engine.

Engine

• Commit: 0451b78
• Branch/ref: controller-api-recoil-2025-06-24-compat
• GitHub Actions run: https://github.com/UnderarmCape/controllersupport-RecoilEngine-attempt-01/actions/runs/26740896752
• Engine artifact: recoil-controller-amd64-windows-0451b78b1c36a2f5ee9a75d4913bfc3da1d10857

Packaging strategy

• Fresh official vanilla BAR.sdd from https://github.com/beyond-all-reason/Beyond-All-Reason.git
• Stable diagnostic controller engine from run 26740896752
• Latest controller LuaUI widgets only
• No old backed-up BAR.sdd
• No local BYAR Chobby.sdd

Reason

The old full BAR.sdd package caused the periodic RTSS stutter. Fresh vanilla BAR.sdd fixed the stutter. This release is for testing whether the prior stable controller engine restores controller functionality while keeping the clean fresh BAR.sdd packaging.

Assets

• recoil-controller-amd64-windows-0451b78b1c36a2f5ee9a75d4913bfc3da1d10857.zip
• recoil-controller-amd64-windows-0451b78b1c36a2f5ee9a75d4913bfc3da1d10857.zip.sha256
• controller-windows-build-logs-0451b78b1c36a2f5ee9a75d4913bfc3da1d10857.zip

This is a prerelease/test engine package, not a final stable release.

BAR Controller Support Engine - Recoil 2025.06.24 Compatibility Build

This is the stable controller-enabled Recoil 2025.06.24 compatibility engine used by the BAR Controller Support v0.4.3 Queue Polish AIO Clean Install release:
https://github.com/UnderarmCape/underarmcape-bar-controller-support-attempt-01/releases/tag/controller-support-v0.4.3-queue-polish-aio-clean-install

BAR Controller Support Engine - Recoil 2025.06.24 Compatibility Build

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

Compatibility build of the BAR Xbox Controller Support RecoilEngine patch rebased onto upstream RecoilEngine 2025.06.24.

This is the current recommended stable engine for the BAR Xbox Controller Support v0.4.3 Queue Polish final clean installer.

Controller API

Preserves the PR beyond-all-reason#2985 Lua controller polling API:

• Spring.GetAvailableControllers()
• Spring.GetControllerState(instanceID)
• instanceID
• deviceID
• name
• buttons
• axes

Built from commit:

a0fa874a732efbabc1b656985c048bcc7dcfaaaf

Recommended Pairing

• Engine release: controller-support-recoil-2025-06-24-compat
• Controller/Lua release: controller-support-v0.4.3-queue-polish
• Installer package: BAR_Controller_Support_v0.4.3_QUEUE_POLISH_FINAL_CLEAN_INSTALL_PACKAGE.zip
• Installer BAT: Install_BAR_Controller_Support_v0.4.3_QUEUE_POLISH_FINAL_CLEAN_INSTALL.bat

Use this engine with:

• Fresh official vanilla BAR.sdd from beyond-all-reason/Beyond-All-Reason
• v0.4.3 Queue Polish LuaUI widgets only
• devmode.txt
• CamSpringLockCardinalDirections = 0

Do not use this with the old backed-up BAR.sdd package or local BYAR Chobby.sdd package.

Installer Hotfix

The mirrored 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.

Packaging Note

The previous full BAR.sdd packaging caused periodic RTSS frametime stutter on the user's test system. The tested-good final setup is:

• Fresh official vanilla BAR.sdd
• This stable compatibility engine
• Latest v0.4.3 Queue Polish LuaUI widgets only
• No old backed-up BAR.sdd
• No local BYAR Chobby.sdd
• No Stutter Fix Attempt 02 engine

The final clean installer assets are mirrored on this engine release for discoverability, but the engine ZIP itself is unchanged.

Recoil Controller Engine PR #2985 API Test - fb438d6

Recoil Controller Engine PR beyond-all-reason#2985 API Test - fb438d6

This is a test engine build for validating the reviewed PR beyond-all-reason#2985 controller input API changes in-game.

PR:

beyond-all-reason#2985

Built from temporary artifact branch:

build/pr-controller-input-lua-api-artifact @ fb438d6e2fd1d41e96048ee87ca652c8c4e45cf6

The source code under test includes the PR review-feedback commit from:

pr/controller-input-lua-api

Purpose

This release is for local BAR testing only.

It is intended to verify that the reviewed Recoil controller API still:

• compiles successfully;
• initializes SDL joystick/gamecontroller support;
• detects Xbox controllers at startup;
• exposes controller state to LuaUI;
• avoids ButtonDown/ButtonUp/AxisMotion log spam.

Important API change from v0.3.6

The reviewed PR branch changed the Lua API shape:

Old prototype behavior:

• instanceId
• deviceId
• 0-based buttons / axes

Reviewed PR behavior:

• instanceID
• deviceID
• 1-indexed Lua buttons / axes

Any BAR LuaUI widget used with this engine must be updated or shimmed for that API change.

Engine artifact

Upload asset:

recoil-controller-amd64-windows-fb438d6e2fd1d41e96048ee87ca652c8c4e45cf6.zip

Status

Pre-release test build for validating PR review changes before replying back on the upstream PR.

Recoil Controller Engine v0.3.6 - Detection Restored + Log-Spam Fixed

Included files

Compiled Recoil Engine

recoil-controller-amd64-windows-a76a36b9b18910f225a9cb8a4c42f920e14b33de.zip

This is the compiled custom Recoil Engine build for the BAR Xbox controller-support prototype.

Built from:

research/controller-api-investigation @ a76a36b9b18910f225a9cb8a4c42f920e14b33de

This engine restores controller startup detection and keeps the controller input log-spam fix.

AI Bible / continuation pack

BAR_Xbox_Controller_Support_AI_Continuation_Pack_v0.3.6_UPDATED.zip

This is the full AI continuation / project Bible archive.

Use this if you are trying to understand what this project is, why this custom engine exists, what files were changed, how the installer works, or how to help continue development with ChatGPT, Codex, Antigravity, or another AI coding assistant.

Recommended use:

1. Upload the ZIP to a new AI chat.
2. Tell the AI to read 00_READ_ME_FIRST_FOR_AI_CONTINUATION.txt first.
3. Tell the AI to use 01_PRIMARY_SOURCE_OF_TRUTH_Project_Bible.md as the main source of truth.
4. Treat Codex and Antigravity worklogs as supporting history only.

The Markdown Pack explains what the hell to do with everything in this release and how the BAR-side mod, Recoil engine patch, installer, camera config fix, and controller-support testing all fit together.

Milestone 01 — Working Xbox Controller Detection

Milestone 01 — Working Xbox Controller Detection

Known-good branch:

research/controller-api-2025-06-19

Known-good commit:

d5c8a21

GitHub Actions run:

https://github.com/UnderarmCape/controllersupport-RecoilEngine-attempt-01/actions/runs/26261215514

Artifact ZIP:

recoil-controller-amd64-windows-d5c8a21e2704a4dd16c1d0e3e9abe7527dd5f5d5.zip

Confirmed working

• BAR launches with the modified Recoil 2025.06.19-compatible engine.
• Temporary BAR common/constants.lua version shim is still required for local testing.
• Spring.GetAvailableControllers() exists and returns a controller.
• Spring.GetControllerState(instanceId) exists and returns live controller state.
• Xbox controller is detected as Controller (Xbox One For Windows).
• Axis motion events are received in the engine.
• Button down/up events are received in the engine.
• Controller Diagnostics widget displays live controller state.

Evidence from infolog

[ControllerDiag], Controller state:, instanceId=0 name=Controller (Xbox One For Windows) axes=neutral buttons=none
[ControllerInput] AxisMotion: instanceId=0 axisId=0 value=...
[ControllerInput] AxisMotion: instanceId=0 axisId=1 value=...
[ControllerInput] ButtonDown: instanceId=0 buttonId=10 value=1
[ControllerInput] ButtonUp: instanceId=0 buttonId=10 value=0