# LifePlay Revival — portage Unreal Engine 5.5

Reprise de [LifePlay](https://github.com/vinfamy/LifePlay) de Vinfamy, simulation de vie open source et moddable
(contenu adulte), portée d'Unreal Engine 4.27 vers **Unreal Engine 5.5**.

> *English summary: community port of Vinfamy's LifePlay from UE 4.27 to UE 5.5. Branch `main` is the validated V1
> (compiles, runs, no crash in a 2-hour session). `Content/Heavy` (3D assets) is not in this repository, as in the
> original. Migration documentation (in French) is in `Docs/Migration/`.*

## État : V1 (tag `v1.0`, 2026-09-30)

- L'éditeur `LifePlayEditor` compile sans erreur ; tous les Blueprints se chargent et compilent.
- Les 8563 paquets du projet sont au format UE5.
- Une build Development empaquetée a été jouée environ 2 h sans plantage : personnages distincts, visibles et habillés,
  scènes, sauvegarde et rechargement.
- Anomalies connues et lots suivants : [`Docs/Migration/Registre_Erreurs.md`](Docs/Migration/Registre_Erreurs.md) et
  [`Docs/Migration/04_Cahier_Des_Charges.md`](Docs/Migration/04_Cahier_Des_Charges.md) (lots L7).

## Branches

| Branche | Contenu |
|---|---|
| `main` | **référence** : la V1 UE 5.5, base des développements suivants |
| `ue5.5-v1` | la V1 telle que validée (identique à `main` à sa publication) |
| `archive/ue4.27` | le projet tel qu'il tournait sous UE 4.27, avant la migration (archive) |
| `archive/original` | le dépôt d'origine de Vinfamy, V3.6 (archive) |

Chaque étape de la migration a ses tags `<lot>-avant` / `<lot>-apres` ; le journal
[`Docs/Migration/Journal_Modifications.md`](Docs/Migration/Journal_Modifications.md) décrit chaque modification et son
retour arrière.

## Contenu du dépôt

Mêmes règles que le dépôt d'origine (voir `.gitignore`) : code C++, configuration, plugins `ModdingExtra` et
`StreetMap`, contenu de gameplay (`BPs`, `UI`, `Structs`, `Render`, `Scenes`), données texte `Content/Modules`,
documentation.

**Absents** : `Content/Heavy` (modèles 3D, textures, animations : environ 6 Go), `Content/Saves`, les fichiers
`*.png`, `*.7z`, `*.mp4`, les binaires et caches. **Le dépôt seul ne suffit donc pas pour compiler et jouer.**
L'auteur d'origine distribuait les sources complètes (dont `Heavy`, au format UE 4.27) ici :
<https://mega.nz/folder/1XYSXbRb#nFHZ1wdwTbL6rS1oUdMe0g>. La V1 a été validée avec un `Heavy` converti au format
UE5 ; la distribution de ce `Heavy` converti reste à organiser.

## Prérequis

- Unreal Engine **5.5** (validé en 5.5.4), Windows 64 bits.
- Visual Studio 2022 avec la charge de travail « Développement Desktop en C++ ».
- Le plugin d'outillage `McpAutomationBridge` (automatisation de l'éditeur par IA) est référencé par le
  `.uproject` mais n'est pas fourni : l'éditeur propose de le désactiver au premier lancement.

## Documentation de la migration

Point d'entrée : [`Docs/Migration/README.md`](Docs/Migration/README.md) (architecture de LifePlay, audit, plan de tests,
cahier des charges, journal, registre des erreurs). Les outils de contrôle (`Tools/*.ps1`) et les commandlets de
diagnostic et de correction (`Source/LifePlayEditorTools`) y sont décrits.

## Licences

Code et contenu sous licence **AGPL-3.0** (`LICENSE`), comme le projet d'origine. Licences et crédits des composants
tiers (StreetMap, OpenStreetMap, ManuelLab, MakeHuman, modèles 3D, modding) : dossier [`Licenses/`](Licenses/).