Wiki tecnica per creator e sviluppatori addon.

Addon concessi e linee guida sviluppatori

Cosa e permesso creare attorno a Flash Replay, cosa non e permesso, e come pubblicare addon compatibili senza violare licenza o stabilita.

Free downloadAll Rights ReservedNeoForge 1.21.1

Asset reali verificati

Regola base

Un addon deve essere un progetto separato che dipende dalla mod ufficiale installata dall'utente.

Gli addon concessi sono contenuti, preset, compatibilita o integrazioni esterne che rispettano consenso utente, licenza e confini tecnici documentati.

Addon concessi

Tipo addon	Concesso se
Resource pack / traduzioni	Usa asset tuoi o testi tuoi e non copia logo, icone o immagini proprietarie senza permesso.
Preset visual o guide look	Distribuisce solo valori, istruzioni o file propri, non file interni della mod.
Librerie animazioni `.franim`	Contengono animazioni create da te e non materiale copiato da replay privati senza consenso.
Pack skin/cape per actor	Usa skin e cape con diritti corretti e istruzioni di import chiare.
Profili export	Distribuisce preset o documentazione dei valori, senza sovrascrivere config utente a forza.
Compat mod	Usa dipendenza opzionale, non include Flash Replay, non modifica jar ufficiale e fallisce in modo sicuro.
Server companion integration	Richiede consenso client e non avvia registrazioni senza opt-in esplicito dell'utente.

Non concesso

Redistribuire il jar di Flash Replay dentro un addon o modpack come file modificato.
Pubblicare una build patchata di Flash Replay.
Copiare codice, UI, logo, banner, GIF o screenshot ufficiali come se fossero asset tuoi.
Usare nomi o icone che fanno sembrare l'addon ufficiale se non lo e.
Aggirare consenso utente per recording, Save Last, export o upload.
Leggere o caricare replay/export dell'utente verso servizi esterni senza consenso chiaro.
Dipendere da classi interne instabili come contratto pubblico quando la wiki non le dichiara API.

Contratto tecnico consigliato

Tratta com.lordbanana.flashreplay.* come interno salvo API pubbliche documentate in futuro.
Non esistono ancora entry point SDK pubblici stabili: finche non vengono documentati qui, non considerarli supportati.
Usa dipendenze opzionali e controlli ModList/loader per non crashare se Flash Replay non e installato.
Non mixare dentro classi Flash Replay per cambiare comportamento core senza accordo esplicito.
Non scrivere direttamente nel config JSON dell'utente: se devi fornire preset, documenta i valori o usa import controllato.
Versiona il tuo addon dichiarando la versione Flash Replay testata e la versione Minecraft/NeoForge.

Naming e pubblicazione

Nome consigliato: Nome Addon for Flash Replay o Flash Replay compatibility for NomeMod.
Scrivi chiaramente Unofficial addon se non e pubblicato dal maintainer di Flash Replay.
Linka la pagina ufficiale Flash Replay come dipendenza.
Non usare Flash Replay come unico nome del tuo progetto.
La licenza del tuo addon puo essere scelta da te, ma non puo concedere diritti su Flash Replay o sui suoi asset.

Checklist prima di pubblicare

Verifica che l'addon funzioni senza includere il jar Flash Replay.
Dichiara dipendenze e versioni testate.
Rimuovi asset Flash Replay copiati se non hai permesso esplicito.
Aggiungi informativa se tocchi recording, file replay, export o upload.
Testa avvio con e senza Flash Replay installato.
Testa su un nuovo profilo Minecraft per evitare di dipendere dalla tua config locale.