Update README with killswitch removal information
Added comprehensive killswitch section: - What the killswitch is and how EA uses it - Code location and exact changes made - Technical explanation with code snippet - Why the patch is permanent (immutable bytecode) - Verification instructions - Link to full KILLSWITCH-REMOVAL-GUIDE.md Reorganized documentation section: - Killswitch removal guide as first item (most critical) - Technical details section at bottom - File locations and line numbers - How to verify the patch worked Makes it clear this branch has the EA shutdown bypass code. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
99
README.md
99
README.md
@@ -1,4 +1,4 @@
|
|||||||
# 🏎️ RR3 APK Modification Tools + Server Browser
|
# 🏎️ RR3 APK Modification Tools + Server Browser + Killswitch Removal
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||
@@ -10,6 +10,62 @@ This repository contains tools to modify the Real Racing 3 APK to connect to **c
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 🔓 NEW: Killswitch Removal Code (Branch: killswitch-killer)
|
||||||
|
|
||||||
|
**EA's March 2026 shutdown bypassed!** This branch contains the code modifications that disable EA's server-controlled killswitch.
|
||||||
|
|
||||||
|
### What's the Killswitch?
|
||||||
|
|
||||||
|
EA added a remote shutdown mechanism to RR3 v14 that checks their servers on every startup. When they flip the switch in March 2026, the stock APK will refuse to launch.
|
||||||
|
|
||||||
|
### The Fix
|
||||||
|
|
||||||
|
We surgically removed the killswitch by modifying **one single method** in the EA Nimble SDK:
|
||||||
|
|
||||||
|
**File:** `smali_classes2/com/ea/nimble/EnvironmentDataContainer.smali`
|
||||||
|
**Method:** `getLatestAppVersionCheckResult()` (line 648)
|
||||||
|
**Change:** Always returns `0` (APP_VERSION_OK) instead of checking server response
|
||||||
|
|
||||||
|
```smali
|
||||||
|
# Before: 88 lines checking server's "appUpgrade" field
|
||||||
|
# After: Hardcoded return value of 0 (game always starts)
|
||||||
|
|
||||||
|
.method public getLatestAppVersionCheckResult()I
|
||||||
|
.locals 1
|
||||||
|
|
||||||
|
# KILLSWITCH DISABLED BY COMMUNITY MOD
|
||||||
|
const-string v0, "🔓 Killswitch bypassed - returning APP_VERSION_OK"
|
||||||
|
invoke-static {v0, v1}, Landroid/util/Log;->i(Ljava/lang/String;Ljava/lang/String;)I
|
||||||
|
|
||||||
|
const/4 v0, 0x0 # Always return 0 (OK)
|
||||||
|
return v0
|
||||||
|
.end method
|
||||||
|
```
|
||||||
|
|
||||||
|
### Documentation
|
||||||
|
|
||||||
|
📖 **[KILLSWITCH-REMOVAL-GUIDE.md](KILLSWITCH-REMOVAL-GUIDE.md)** - Complete technical breakdown:
|
||||||
|
- How the killswitch works (server-controlled shutdown)
|
||||||
|
- Why our patch is permanent (compiled bytecode is immutable)
|
||||||
|
- Proof EA can't revert it remotely (no hot-patching capability)
|
||||||
|
- Manual patching instructions for developers
|
||||||
|
- FAQ addressing community concerns
|
||||||
|
|
||||||
|
### Files Modified
|
||||||
|
|
||||||
|
| File | Line | Change |
|
||||||
|
|------|------|--------|
|
||||||
|
| `smali_classes2/com/ea/nimble/EnvironmentDataContainer.smali` | 648-668 | Replaced entire `getLatestAppVersionCheckResult()` method |
|
||||||
|
|
||||||
|
### Result
|
||||||
|
|
||||||
|
✅ Game works after EA servers shut down
|
||||||
|
✅ No dependency on EA infrastructure
|
||||||
|
✅ Can't be remotely disabled
|
||||||
|
✅ Progress preserved locally
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 🚀 **[NEW: Getting Started Guide!](GETTING-STARTED.md)**
|
## 🚀 **[NEW: Getting Started Guide!](GETTING-STARTED.md)**
|
||||||
|
|
||||||
**First time building?** Check out our comprehensive **[GETTING-STARTED.md](GETTING-STARTED.md)** guide with:
|
**First time building?** Check out our comprehensive **[GETTING-STARTED.md](GETTING-STARTED.md)** guide with:
|
||||||
@@ -163,10 +219,51 @@ Together, these projects create a **complete community-run RR3 experience**!
|
|||||||
|
|
||||||
## 📚 Documentation
|
## 📚 Documentation
|
||||||
|
|
||||||
|
### Core Documentation
|
||||||
|
- **[KILLSWITCH-REMOVAL-GUIDE.md](KILLSWITCH-REMOVAL-GUIDE.md)** - 🔓 Bypass EA's March 2026 shutdown (NEW!)
|
||||||
- **[Server Browser Guide](docs/SERVER_BROWSER_GUIDE.md)** - User guide for server browser UI
|
- **[Server Browser Guide](docs/SERVER_BROWSER_GUIDE.md)** - User guide for server browser UI
|
||||||
- **APK_MODIFICATION_GUIDE.md** - Technical APK modding details
|
- **APK_MODIFICATION_GUIDE.md** - Technical APK modding details
|
||||||
- **NETWORK_COMMUNICATION_ANALYSIS.md** - RR3 protocol documentation
|
- **NETWORK_COMMUNICATION_ANALYSIS.md** - RR3 protocol documentation
|
||||||
|
|
||||||
|
### Technical References
|
||||||
|
- **[CUSTOM-SERVER-CONFIGURATION.md](CUSTOM-SERVER-CONFIGURATION.md)** - Server URL hardcoding & SSL bypass
|
||||||
|
- **[KEYSTORE-README.md](KEYSTORE-README.md)** - APK signing information
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛠️ Technical Details
|
||||||
|
|
||||||
|
### Killswitch Removal (v14 Ultimate)
|
||||||
|
|
||||||
|
**Purpose:** Disable EA's remote shutdown mechanism to preserve the game after March 2026
|
||||||
|
|
||||||
|
**Modified Files:**
|
||||||
|
```
|
||||||
|
smali_classes2/com/ea/nimble/EnvironmentDataContainer.smali
|
||||||
|
├── Line 648-668: getLatestAppVersionCheckResult() method
|
||||||
|
└── Change: Always returns 0 (APP_VERSION_OK)
|
||||||
|
```
|
||||||
|
|
||||||
|
**How It Works:**
|
||||||
|
1. Original code checks `m_getDirectionResponseDictionary.get("appUpgrade")`
|
||||||
|
2. EA's server returns `0` (OK), `1` (Warning), or `2` (BLOCKED)
|
||||||
|
3. Our patch ignores the server response completely
|
||||||
|
4. Method now hardcoded to return `0` regardless of server state
|
||||||
|
|
||||||
|
**Why It's Permanent:**
|
||||||
|
- Smali bytecode → DEX → machine code = **immutable after installation**
|
||||||
|
- EA can only change server DATA, not compiled METHOD CODE
|
||||||
|
- No `DexClassLoader` or hot-patching in RR3
|
||||||
|
- Firebase Remote Config only affects data/flags, not executable code
|
||||||
|
|
||||||
|
**Verification:**
|
||||||
|
```bash
|
||||||
|
# Check logcat for this message on startup:
|
||||||
|
I/RealRacing3: 🔓 Killswitch bypassed - returning APP_VERSION_OK (community mod)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 🤝 Contributing
|
## 🤝 Contributing
|
||||||
|
|
||||||
Contributions welcome! Areas for improvement:
|
Contributions welcome! Areas for improvement:
|
||||||
|
|||||||
Reference in New Issue
Block a user