funman300
d71234b03d
AGENTS.md is the new canonical AI-agent entry point (FIFA17 active target, repo map, FIFA23->FIFA17 pivot history). README/CLAUDE/setup.sh get stale banners pointing to it. Retained pre-existing WIP brought forward.
99 lines
3.4 KiB
Markdown
99 lines
3.4 KiB
Markdown
# OpenFUT
|
|
|
|
> ⚠️ **Status — see [`docs/PROJECT_STATE.md`](./docs/PROJECT_STATE.md) (canonical).** The working, actively-developed target is **FIFA 17**, not FIFA 23. Everything below this banner describes the **superseded FIFA 23 `bridge` lineage** and is kept for historical context.
|
|
>
|
|
> **Run the server (canonical):** `cd fifa17-recon/docker/fifa17-python && docker compose up -d` — see [`fifa17-recon/FUT-RUNBOOK.md`](./fifa17-recon/FUT-RUNBOOK.md). `openfut-core` is the shared offline backend (still used by the FIFA 17 path); `openfut-bridge` is the retired FIFA 23 integration.
|
|
|
|
**Offline Ultimate Team — like SPT, but for FIFA 23.**
|
|
|
|
OpenFUT replaces EA's retired FUT servers with a fully offline, single-player backend. You own FIFA 23 legitimately. You just want to keep playing after EA shut down the servers.
|
|
|
|
---
|
|
|
|
## Repositories
|
|
|
|
| Repo | Purpose |
|
|
|---|---|
|
|
| [`openfut-core`](./openfut-core) | Game-independent offline FUT backend |
|
|
| [`openfut-bridge`](./openfut-bridge) | FIFA 23 integration layer + reverse-engineering proxy |
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
FIFA 23 client
|
|
│
|
|
▼
|
|
┌─────────────────┐
|
|
│ openfut-bridge │ ← intercepts FUT traffic, maps routes, logs unknown
|
|
└────────┬────────┘
|
|
│
|
|
▼
|
|
┌─────────────────┐
|
|
│ openfut-core │ ← offline FUT backend: profiles, packs, squads, SBCs
|
|
└─────────────────┘
|
|
│
|
|
▼
|
|
SQLite database
|
|
```
|
|
|
|
**Core** is game-independent. It speaks a clean REST API and knows nothing about FIFA 23 internals.
|
|
|
|
**Bridge** is FIFA-specific. It speaks FIFA 23's wire protocol and translates it into Core API calls. Bridge is where all reverse engineering work happens.
|
|
|
|
---
|
|
|
|
## Current Status
|
|
|
|
| Feature | Status |
|
|
|---|---|
|
|
| Local profiles + clubs | ✅ Working |
|
|
| Coin system | ✅ Working |
|
|
| Pack generator | ✅ Working |
|
|
| Card collection | ✅ Working |
|
|
| Squad builder | ✅ Working |
|
|
| Objectives engine | ✅ Working |
|
|
| SBC engine | ✅ Working |
|
|
| Match rewards | ✅ Working |
|
|
| NPC transfer market | ✅ Working |
|
|
| Statistics | ✅ Working |
|
|
| FIFA 23 integration | 🔴 Reverse engineering in progress |
|
|
| Chemistry calculation | 🟡 In progress |
|
|
| Full Draft mode | 🟡 In progress |
|
|
| Squad Battles AI generator | 🟡 In progress |
|
|
| Objectives claim flow | 🟡 In progress |
|
|
|
|
---
|
|
|
|
## Running
|
|
|
|
```bash
|
|
# Start the offline backend
|
|
cd openfut-core
|
|
cargo run
|
|
|
|
# Start the proxy (for traffic capture / FIFA integration)
|
|
cd openfut-bridge
|
|
cargo run
|
|
```
|
|
|
|
Core listens on `http://127.0.0.1:8080` by default.
|
|
Bridge listens on `http://127.0.0.1:8443` by default.
|
|
|
|
---
|
|
|
|
## Design Principles
|
|
|
|
- **Offline-first.** No EA account required. No internet connection needed.
|
|
- **Single-player only.** This is not a multiplayer server emulator.
|
|
- **Data-driven.** All cards, packs, SBCs, and objectives are JSON files. Everything is moddable.
|
|
- **Clean architecture.** Core has zero knowledge of FIFA 23. Bridge has zero game logic.
|
|
- **No copyrighted assets.** No real player images, no EA trademarks in data files.
|
|
|
|
---
|
|
|
|
## Disclaimer
|
|
|
|
This project is not affiliated with EA Sports. You must own FIFA 23 legitimately to use this software. This project does not bypass any ownership verification and is intended only to restore offline playability of a game whose online services have been retired.
|