rr3-apk/README-apktool.md

RR3 APKTool Decompiled Version (Discord Collaboration)

This branch contains the APKTool-decompiled version of Real Racing 3 from the Discord community team.

Source: https://github.com/supermegamestre/Project-Real-Resurrection-3

Why APKTool Instead of JADX?

This repository uses APKTool decompilation, not JADX like the other branches. Here's why:

APKTool (This Branch)

• Format: Smali bytecode (Android assembly language)
• Readable: ❌ Very hard to read - low-level assembly code
• Modifiable: ✅ YES - Can rebuild APK after editing
• Use Case: Modding, patching, rebuilding APKs

JADX (Other Branches)

• Format: Java source code
• Readable: ✅ Easy to read - high-level Java
• Modifiable: ❌ NO - Cannot rebuild APK
• Use Case: Understanding code, reverse engineering

Recommended Workflow

1. Use JADX branches (main, discord-community) to understand the code
2. Use this APKTool branch (discord-apktool) to modify the code
3. Rebuild the APK with APKTool after making changes

Example:

# 1. Read Java code to understand a feature
cd ../rr3-apk-main
cat sources/com/ea/feature/Example.java

# 2. Find corresponding Smali file
cd ../rr3-apk
nano smali/com/ea/feature/Example.smali

# 3. Make changes to Smali

# 4. Rebuild APK
apktool b . -o modified-rr3.apk

What's Different in This Version?

Based on the Discord team's work:

• ✅ Both 32-bit and 64-bit support (armeabi-v7a + arm64-v8a)
• ✅ Full Smali source for all game classes
• ✅ All resources (XML, images, sounds)
• ✅ Ready to rebuild with APKTool

Architecture Support

lib/
├── armeabi-v7a/          # 32-bit ARM (older devices)
│   └── libRealRacing3.so # 22.56 MB
└── arm64-v8a/            # 64-bit ARM (modern devices)
    └── libRealRacing3.so # 31.58 MB

How to Rebuild This APK

Prerequisites:

# Install APKTool
# Windows: Download from https://ibotpeaches.github.io/Apktool/
# Linux: apt install apktool

# Install Java Development Kit
# Required for signing APKs

Build Process:

# 1. Make your modifications to Smali or resource files

# 2. Rebuild APK
apktool b . -o realracing3-modded.apk

# 3. Sign the APK (required for installation)
# Generate keystore first (one-time):
keytool -genkey -v -keystore rr3.keystore -alias rr3key -keyalg RSA -keysize 2048 -validity 10000

# Sign the APK:
jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore rr3.keystore realracing3-modded.apk rr3key

# 4. Optimize with zipalign:
zipalign -v 4 realracing3-modded.apk realracing3-final.apk

# 5. Install on device:
adb install realracing3-final.apk

Common Modding Tasks

1. Change Server URL

Edit: smali/com/ea/config/ServerConfig.smali Look for: .field public static SERVER_URL:Ljava/lang/String;

2. Unlock All Cars

Edit: smali/com/ea/garage/CarManager.smali Modify: isCarUnlocked() method to always return true

3. Unlimited Currency

Edit: smali/com/ea/currency/CurrencyManager.smali Modify: Currency check methods

4. Remove Ads

Edit: AndroidManifest.xml Remove: Ad-related permissions and activities

File Structure

discord-apktool/
├── AndroidManifest.xml         # App configuration
├── apktool.yml                 # APKTool build settings
├── res/                        # Resources (images, XML, etc)
├── smali/                      # Main game code (Smali)
├── smali_classes2/             # Additional classes
├── smali_classes3/             # Additional classes
├── lib/                        # Native libraries (.so files)
├── assets/                     # Game assets
└── original/                   # Original APK metadata

Learning Smali

Smali is challenging but learnable. Key concepts:

• Registers: v0, v1, p0, p1 (like variables)
• Method calls: invoke-virtual, invoke-static
• Conditional jumps: if-eq, if-ne, goto
• Field access: .field, iget, iput

Resources:

• https://github.com/JesusFreke/smali/wiki
• https://source.android.com/devices/tech/dalvik/dalvik-bytecode

Branch Comparison

Branch	Tool	Format	Readable	Modifiable	Use Case
main	JADX	Java	✅ Yes	❌ No	Understanding original
discord-community	JADX	Java	✅ Yes	❌ No	Understanding Discord version
discord-apktool	APKTool	Smali	❌ No	✅ Yes	Modding & rebuilding

Notes

• This is the active development version used by the Discord team
• Check GitHub for updates: https://github.com/supermegamestre/Project-Real-Resurrection-3
• Always test on emulator before installing on real device
• Keep backups of working APKs

---

Last synced: 2025-02-18
Discord team: supermegamestre and contributors