Compatibilité et versions
Le champ NeoModApiVersion
Section intitulée « Le champ NeoModApiVersion »Chaque mod indique dans son .uplugin la version de l’API de mod pour laquelle il a été écrit :
"NeoModApiVersion": 5Au chargement, NeoPiano compare cette valeur à la plage qu’il accepte :
| Situation | Résultat |
|---|---|
| Champ absent | Mod refusé |
| Version plus récente que NeoPiano | Refusé : mettez NeoPiano à jour |
| Version plus ancienne que le minimum accepté | Refusé : le mod doit être reconstruit |
| Version dans la plage | Mod chargé |
La règle « ajout en fin seulement »
Section intitulée « La règle « ajout en fin seulement » »L’API ne fait que s’enrichir : chaque nouvelle version ajoute des fonctions, des composants ou des capacités, sans rien retirer ni modifier. Un mod écrit pour une version donnée continue donc de fonctionner avec les versions suivantes.
Une rupture de compatibilité serait annoncée comme une version majeure, avec un relèvement explicite du minimum accepté.
Versions actuelles
Section intitulée « Versions actuelles »| Version | |
|---|---|
API de mod (NeoModApiVersion) |
5 |
| Minimum accepté | 1 |
API neo (scripts) |
2 |
Votre mod peut lire la version de l’API à l’exécution pour activer une fonctionnalité seulement si elle est disponible.
Documentation synchronisée avec NeoPiano · commit cbf48cc · 17 octobre 2026