Sviluppo e roadmap

Sviluppo e roadmap

Questa pagina raccoglie convenzioni e prossimi passi tecnici.

Convenzioni

• Java 21.
• Maven multi-modulo.
• Package pubblico dev.openrp.*.
• Messaggi utente in italiano.
• API Paper/Bukkit con dipendenze server-side in provided.
• Storage e I/O fuori dal main thread.
• Ritorno al main thread prima di usare API Bukkit non thread-safe.
• Config default sicuri.
• Comandi e permessi documentati.

Validazione consigliata

mvn -B -ntp validate
mvn -B -ntp test -pl open-access -am
mvn -B -ntp package -pl open-access -am
bash scripts/build-resource-packs.sh

Quando Open Weapons sara' standalone:

mvn -B -ntp clean package

Roadmap Open Access

• Test manuale completo su Paper con WorldGuard.
• Provider per proprieta'.
• Provider per aziende.
• Provider per hotel.
• Migrazione dati da installazioni precedenti.
• Audit viewer admin.
• Esportazione/importazione profili.

Roadmap Open Cosmetics

• Migliorare persistenza stazioni.
• Documentare schema completo weapon_cosmetics.yml.
• Validatore config.
• Preview cosmetici in GUI.
• Supporto a piu' bridge arma.
• Test su NBT/PersistentDataContainer.

Roadmap Open Weapons

• Creare OpenWeaponsPlugin extends JavaPlugin.
• Aggiungere plugin.yml o paper-plugin.yml.
• Rimuovere dipendenze dal vecchio core.
• Creare openrp-core-api o adapter minimi.
• Rendere opzionali aziende/polizia/staff log.
• Portare config e comandi in namespace pubblico.
• Aggiungere test registry.
• Aggiungere test model data visual variants.
• Aggiungere test combat policy.
• Documentare i file YAML in dettaglio.

Checklist per un nuovo modulo

1. Directory Maven sibling.
2. Package dev.openrp.<modulo>.
3. README italiano.
4. plugin.yml o paper-plugin.yml.
5. Config default.
6. Comandi e permessi.
7. API pubblica se altri moduli devono integrarsi.
8. Test unitari per logica pura.
9. Build mirata con mvn -B -ntp package -pl <modulo> -am.
10. Documentazione wiki aggiornata.