1
0
forked from Mirrors/RGSX

update readme

This commit is contained in:
skymike03
2025-09-03 18:45:31 +02:00
parent 2e9785e4e1
commit 51255fd813
2 changed files with 100 additions and 0 deletions

View File

@@ -108,6 +108,7 @@ INFO: for retrobat on first launch, the application will download Python in the
- Follow the on-screen instructions to map each action by holding the key or button for 3 seconds.
- Button names are automatically displayed according to your controller (A, B, X, Y, LB, RB, LT, RT, etc.).
- The configuration is compatible with all controllers supported by EmulationStation.
- If controls behave incorrectly or mapping is corrupted, delete the file: `/saves/ports/rgsx/controls.json` then restart the application (it will be recreated).
---
@@ -203,3 +204,51 @@ git checkout -b feature/your-feature-name
This project is free. You are free to use, modify and distribute it under the terms of this license.
Developed with ❤️ for retro gaming enthusiasts.
## 🔄 Changelog
### 1.9.9.4 (2025-09-03)
- Game Source toggle (RGSX / Custom) with info popups
- No fallback when custom source invalid (empty list + message)
- Pause menu reorder (Game Source before Update)
- Symlink status messages and minor translations
- Popup timer fix and path placeholders
### 1.9.9.3
- Symlink option added (nested platform folders)
- Persistent symlink setting and translations
### 1.9.9.2
- Unified settings file rgsx_settings.json (language, music, accessibility, symlink, sources)
- Automatic migration of legacy JSON configs
### 1.9.9.1
- Batch (multi-select) downloads & improved history
- Archive handling warnings & better error popups
### 1.9.9.0
- Accessibility font scale, language selector, controls help, OTA update system
### 1.9.8.x
- Initial public features (downloads, controller mapping, adaptive UI, logging)
---
## 🌐 Custom Game Sources
You can switch source mode in the pause menu (Game Source: RGSX / Custom).
Custom mode expects a ZIP URL (HTTP/HTTPS) pointing to a sources archive with the same structure as the default. Configure it in:
`{rgsx_settings path}` → key: `sources.custom_url`
Behavior:
- If custom mode selected and URL missing/invalid → empty list + popup (no fallback)
- Fix the URL then use "Update games list" and restart if required
Example snippet in rgsx_settings.json:
```json
"sources": {
"mode": "custom",
"custom_url": "https://example.com/my-sources.zip"
}
```
Switch back to RGSX mode anytime via pause menu.

View File

@@ -106,6 +106,7 @@ INFO : pour retrobat au premier lancement, l'application téléchargera Python d
- Suivez les instructions à l'écran pour mapper chaque action en maintenant la touche ou le bouton pendant 3 secondes.
- Les noms des boutons s'affichent automatiquement selon votre manette (A, B, X, Y, LB, RB, LT, RT, etc.).
- La configuration est compatible avec toutes les manettes supportées par EmulationStation.
- En cas de problème de contrôles ou configuration corrompue, supprimez le fichier : `/saves/ports/rgsx/controls.json` puis redémarrez l'application (il sera recréé automatiquement).
---
@@ -124,6 +125,56 @@ Les logs sont enregistrés dans `roms/ports/RGSX/logs/RGSX.log` sur batocera et
---
## 🔄 Journal des modifications
### 1.9.9.4 (2025-09-03)
- Bascule Source des jeux (RGSX / Personnalisée) + popups
- Pas de fallback si source personnalisée invalide (liste vide + message)
- Réorganisation menu pause (Source avant Mise à jour)
- Messages détat symlink + traductions mineures
- Correction minuterie popup et placeholders de chemin
### 1.9.9.3
- Ajout option symlink (dossiers plateformes imbriqués)
- Persistance et traductions symlink
### 1.9.9.2
- Fichier unifié rgsx_settings.json (langue, musique, accessibilité, symlink, sources)
- Migration automatique anciens JSON
### 1.9.9.1
- Téléchargements multi-sélection & historique amélioré
- Gestion archives + meilleures popups derreur
### 1.9.9.0
- Taille de police (accessibilité), sélection langue, aide contrôles, système de mise à jour
### 1.9.8.x
- Fonctionnalités initiales publiques (téléchargements, remapping manette, interface adaptative, logs)
---
## 🌐 Sources de jeux personnalisées
Vous pouvez changer la source dans le menu pause (Source des jeux : RGSX / Personnalisée).
Le mode personnalisé attend une URL ZIP (HTTP/HTTPS) pointant vers une archive des sources avec la même structure que celle par défaut. À configurer dans :
`{chemin rgsx_settings}` → clé : `sources.custom_url`
Comportement :
- Si mode personnalisé sélectionné et URL vide/invalide → liste vide + popup (aucun fallback)
- Corrigez lURL puis utilisez "Mettre à jour la liste des jeux" et redémarrez si nécessaire
Exemple dans rgsx_settings.json :
```json
"sources": {
"mode": "custom",
"custom_url": "https://exemple.com/mes-sources.zip"
}
```
Revenez au mode RGSX à tout moment via le menu pause.
---
## 📁 Structure du projet
```
/roms/windows/RGSX