# RR3 APK Modification Tools

![License: Educational](https://img.shields.io/badge/license-Educational-blue.svg)
![Platform: Windows](https://img.shields.io/badge/platform-Windows-lightgrey.svg)
![Language: PowerShell](https://img.shields.io/badge/language-PowerShell-blue.svg)

## 🎮 Real Racing 3 - Community Server APK Modifier

This repository contains tools to modify the Real Racing 3 APK to connect to **community-hosted servers** instead of EA's official servers. Perfect for game preservation, private servers, and offline play.

## ⚡ Quick Start

```powershell
.\RR3-Community-Mod.ps1 -ServerUrl "http://your-server-ip:5000"
```

## 📦 What's Included

- **RR3-Community-Mod.ps1** - Automated APK modification script
- **APK_MODIFICATION_GUIDE.md** - Complete guide (14,000 words)
- **APK_MODIFICATION_SUMMARY.md** - Quick reference (12,000 words)  
- **NETWORK_COMMUNICATION_ANALYSIS.md** - Protocol docs (13,000 words)

## 🔍 How It Works

Real Racing 3 has **built-in support** for custom servers! Just change the configuration in `AndroidManifest.xml`:

```xml
<meta-data android:name="com.ea.nimble.configuration" android:value="custom" />
<meta-data android:name="NimbleCustomizedSynergyServerEndpointUrl" android:value="http://your-server:5000" />
```

## 🌐 Need a Server?

Check out **[rr3-server](https://github.com/ssfdre38/rr3-server)** - ASP.NET Core community server with web admin panel!

---

**Made for game preservation 🏎️**