1. The Installation Path

LUA scripts live on your Radio's SD card. If they aren't in the exact right folder, your radio won't "see" them.

SD_CARD (Root)

└── SCRIPTS

└── TOOLS

├── elrsV3.lua

└── bf.lua

Tip: Most modern radios like the RadioMaster Pocket or TX16S come with these pre-installed. Only update them if you update your firmware.

2. The Big Three

ExpressLRS

/elrsV3.lua

Ready

Adjust packet rates, telemetry ratio, and transmit power (mW) on the fly.

REQ: Must match your ELRS major version (v2 vs v3).

Betaflight

/bf.lua

Ready

Change PIDs, Rates, and VTX channels from your radio screen.

REQ: Requires 'Telemetry' to be enabled in Betaflight Ports tab.

TBS Crossfire

/crossfire.lua

Ready

The original long-range config script for Team BlackSheep hardware.

REQ: Standard with OpenTX/EdgeTX installations.

3. Troubleshooting

"Loading..." Forever

This usually means your radio and drone aren't talking. Ensure the drone is powered on (plug in a battery) and that Telemetry is enabled in the Betaflight Configuration tab.

Script Syntax Error

Usually happens when the LUA file version doesn't match your Radio's OS (EdgeTX/OpenTX). Re-download the correct version from the official GitHub.