From f334b44a55128a6a719f3b609db12bd99fb2b0c6 Mon Sep 17 00:00:00 2001
From: laforetbrut <vyrriox@gmail.com>
Date: Wed, 22 Apr 2026 03:33:11 +0200
Subject: [PATCH] Add compat-mods staging folder for mod compatibility analysis

Local .jar staging area for inspecting mod APIs and writing compatibility
shims. Binaries git-ignored; README documents the purpose and conventions.
---
 compat-mods/.gitignore |  2 ++
 compat-mods/.gitkeep   |  0
 compat-mods/README.md  | 31 +++++++++++++++++++++++++++++++
 3 files changed, 33 insertions(+)
 create mode 100644 compat-mods/.gitignore
 create mode 100644 compat-mods/.gitkeep
 create mode 100644 compat-mods/README.md

diff --git a/compat-mods/.gitignore b/compat-mods/.gitignore
new file mode 100644
index 0000000..a96b8c1
--- /dev/null
+++ b/compat-mods/.gitignore
@@ -0,0 +1,2 @@
+*.jar
+!.gitkeep
diff --git a/compat-mods/.gitkeep b/compat-mods/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/compat-mods/README.md b/compat-mods/README.md
new file mode 100644
index 0000000..ce2a67e
--- /dev/null
+++ b/compat-mods/README.md
@@ -0,0 +1,31 @@
+# Compat Mods
+
+Drop `.jar` files of mods that must be compatible with **PlayerSync** here for local analysis and testing.
+
+## Purpose
+
+- Reference bundles for writing compatibility shims (see `src/main/java/vip/fubuki/playersync/sync/addons/`).
+- Local inspection of mod APIs, capabilities, and data structures.
+- NOT loaded by the dev runtime — purely a staging folder for analysis.
+
+## Rules
+
+- `.jar` files are **git-ignored** — do not commit mod binaries.
+- Keep one version per mod; rename with version suffix if multiple are needed (e.g. `sophisticatedbackpacks-1.21.1-3.23.0.jar`).
+
+---
+
+# Mods de compatibilité
+
+Déposez les fichiers `.jar` des mods qui doivent être compatibles avec **PlayerSync** ici pour analyse et tests locaux.
+
+## Objectif
+
+- Bundles de référence pour écrire des shims de compatibilité (voir `src/main/java/vip/fubuki/playersync/sync/addons/`).
+- Inspection locale des APIs, capabilities et structures de données des mods.
+- Non chargé par le runtime de dev — dossier de staging uniquement pour analyse.
+
+## Règles
+
+- Les fichiers `.jar` sont **ignorés par git** — ne pas commit les binaires de mods.
+- Une seule version par mod ; renommer avec le suffixe de version si plusieurs sont nécessaires (ex : `sophisticatedbackpacks-1.21.1-3.23.0.jar`).