Skip to content

memaxo/cp2077-tweak-xl-macos

 
 

Repository files navigation

TweakXL (macOS)

Runtime TweakDB modification for Cyberpunk 2077 on macOS ARM64.

Status: Complete and validated — all 7 features bootstrapped, 3 StatService hooks, 120s+ stable.

What it does

TweakXL enables runtime modification of TweakDB values (game stats, items, vehicles, economy). Loads .yaml and .tweak files from r6/tweaks/ and applies them during game initialization. Built as a RED4ext .dylib plugin with Frida-based hooking.

Prerequisites

  • RED4ext installed and functional
  • CMake 3.24+, Clang 15+

Build

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(sysctl -n hw.ncpu)

Install

cp build/TweakXL.dylib "<game>/red4ext/plugins/TweakXL/"
cp -r bundle/Data/ "<game>/red4ext/plugins/TweakXL/Data/"
cp -r bundle/Scripts/ "<game>/red4ext/plugins/TweakXL/Scripts/"

Key files

File Purpose
lib/Support/macOS/AddressResolverOverride.hpp macOS address mappings (include first)
src/Red/Addresses/Library.hpp TweakXL-specific hash constants
src/App/Tweaks/TweakService.cpp Main hook attachments
docs/STATUS.md Port status

Related projects

Project Description
RED4ext Required mod loader
RED4ext.SDK SDK dependency
ArchiveXL Companion resource plugin

Attribution

Forked from psiberx/cp2077-tweak-xl. macOS port by memaxo.

About

MACOS PORT. Cyberpunk 2077 mod that allows you to modify TweakDB.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Makefile 98.1%
  • C++ 1.6%
  • Other 0.3%