Skip to content

About

A Borderlands 4 Native Mod Menu

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

ECHO Mod Menu

A native Mods tab for Borderlands 4, with automatic SDK mod discovery, staged settings, keyboard rebinding, language selection and controller navigation.

Installation

Use the install package produced by Build and test under the repository's Actions tab, or its ready-to-install files. Exit the game, then copy these files into the Borderlands 4 installation root:

File Destination relative to the game root
SDK mod sdk_mods/bl4_echo_mod_menu.sdkmod
Native UI PAK OakGame/Content/Paks/zzz_BL4_ECHO_Mod_Menu_999_P.pak
Required tag configuration OakGame/Config/Tags/BL4EchoModMenu.ini

Keep the SDKMOD filename unchanged and restart the game completely. The INI is required: Unreal imports its tag definitions at startup. A BL4-compatible PythonSDK installation with unrealsdk and mods_base is required.

The mod starts automatically when the inventory is first activated. Open the inventory and select Mods. No console/PyExec activation is needed.

The current native profile is Steam, Windows x64, game update 1.11, restricted to the reviewed executable fingerprint. Read compatibility before installing on a different executable or storefront.

Using the menu

ECHO discovers registered SDK mods, their visible options and their actual registered keybinds. Authors can optionally supply categories, presets, translations and additional settings through API v1.

Version 1.3.0 adds bundled Tabler/ECHO icons and optional PNG mod logos or banners. Authors can declare artwork independently of their settings provider. The installer also includes an optional TPS logo overlay for the integration from the v100.3 bundle; see its enclosed installation notes.

The selected mod's logo or compact name heading sits above its category tabs and remains visible while scrolling settings. Categories open directly to their presets and options; the option count appears beside the tabs.

  • Edit values locally, then choose Save & Apply to queue the complete draft.
  • Close the inventory to apply and save queued changes through their owning mods.
  • Changing to another tab does not apply the draft.
  • Discard draft restores the queued values. Clearing the queue removes the pending commands. Validation errors must be corrected before saving.
  • Changing the menu language preserves the current draft. Mod descriptions are translated only when their author supplies translations.

Language selection

Choose Auto to follow the game's text language, or open the adjacent dropdown to select one of 14 languages by its native name. Spanish (Spain/Latin America) and Chinese (Simplified/Traditional) have separate selections.

ECHO's own menu texts are translated into all 14 selectable languages. Mod-provided translations use the selected language, with English fallback when needed. This selection changes ECHO's language independently of the game.

Confirm opens the list. D-pad up/down navigates and scrolls within it; Confirm applies the selection and Cancel closes the list without changing the language. Mouse and virtual gamepad cursor selection are also supported.

Bundled TrueType fonts cover ECHO's translated menu text and language names, including Latin, Cyrillic and the five Asian scripts. Windows language packs are not required. Mod names, descriptions and option text remain supplied by each mod.

Keyboard capture supports individual supported keyboard keys. It does not add an on-screen keyboard or physical gamepad-button rebinding.

Controller

Use the game's logical navigation/Confirm/Cancel bindings. With the usual DualSense layout, Confirm is Cross and Cancel is Circle.

  • D-pad moves between mods, categories, options and footer actions.
  • Numeric rows expose separate Minus / Slider / Plus targets.
  • Confirm on a slider or choice begins the orange edit mode. Left/right changes the value; Confirm keeps it and Cancel restores the value before that edit.
  • Cancel ends active text entry/capture first. Outside an edit, native Back runs.
  • Move the mouse or gamepad cursor to resume cursor operation.

See controls for focus, capture and cancellation details.

Mod authors

Ordinary SDK mods need no ECHO dependency or integration file. Start with the author guide, then use the full API reference.

Complete example Demonstrates
Level 2 SDK-owned options, categories, presets, conditions and translated names/descriptions.
Level 3 Custom JSON loading/saving, validated callbacks, a queued Reset action and ordering.
Combined SDK options, a registered keybind and separate mod-owned persistence.

The install package includes each source folder and a matching optional SDKMOD under examples/. Copy only the example SDKMODs you want into sdk_mods. These examples store settings and do not affect gameplay.

Developer sources

The repository and separate _sources.zip contain the developer sources, build instructions and architecture notes. GitHub Actions builds and tests the packages on Windows and uploads the installer, sources and checksums as one artifact.

For a manual repository update, extract _sources.zip and upload its contents at the repository root. It includes the matching ready-to-install package/ files.

Runtime data and diagnostics

Mod values remain owned and saved by each mod. ECHO stores its own preferences under the SDK settings directory, in bl4_echo_mod_menu/preferences.json. Normal operation does not write full session reports. Set the process environment variable ECHO_MOD_MENU_DIAGNOSTICS=1 before startup to enable bounded diagnostic files; errors can also produce reports. Runtime settings, logs and captures are not part of this repository.

Version

Current version: 1.3.3, provider API 1. See the changelog, compatibility and third-party notices.

About

A Borderlands 4 Native Mod Menu

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages