Support custom character image folders and document structure

2026-06-06 11:42:06 +00:00 · 2026-02-12 02:02:07 +01:00
parent f38d15c681
commit de11a1dea7
2 changed files with 56 additions and 7 deletions
@@ -0,0 +1,21 @@
+# Character image catalog
+
+Put custom character images here using this structure:
+
+```text
+src/shared/character-images/
+  street-fighter-6/
+    ryu.png
+    ken.png
+  tekken-8/
+    jin.png
+```
+
+Rules:
+
+- Folder name = game slug (`toLowerCase`, replace non alphanumeric with `-`).
+  - Example: `Guilty Gear -Strive-` -> `guilty-gear-strive`
+- File name = character slug with the same rule.
+  - Example: `Chun-Li` -> `chun-li`
+- Supported extensions: `.png`, `.jpg`, `.jpeg`, `.webp`, `.avif`, `.svg`.
+- If an image is missing, the dashboard shows a generated placeholder preview.