strumento
MineSync
Sincronizza la cartella di un server Minecraft, vanilla o con mod (Forge, NeoForge, Fabric, Quilt), tra i PC di un gruppo su una rete ZeroTier privata. Un hub self-hosted conserva ogni mondo con tutta la sua storia; il client prende un lock esclusivo, scarica solo i file cambiati, avvia il server e carica una nuova versione ogni cinque minuti.
- Stelle GitHub
- 0

Contesto
Un mondo Minecraft condiviso ha bisogno di un host. Un server dedicato aggiunge costi e manutenzione, e quando l’host è il PC di uno dei membri, il mondo è disponibile solo finché quel PC è acceso. MineSync permette a qualsiasi membro del gruppo di ospitarlo: il mondo risiede su un hub, e ogni sessione parte dalla sua ultima versione.
Ospitare una sessione
Il client elenca i server presenti sull’hub. Avviarne uno prende il lock, così ospita un solo membro alla volta, poi scarica i file cambiati dall’ultima sessione, sceglie un runtime Java compatibile e avvia il server con una console integrata. Ogni cinque minuti salva il mondo e carica una nuova versione; all’arresto del server carica lo stato finale e rilascia il lock.
- Lock esclusivo: mantenuto attivo da un heartbeat e rilasciato dopo 90 secondi se l’host si blocca.
- Le modifiche locali sono preservate: quelle mai arrivate all’hub vengono caricate prima, quando è sicuro, oppure conservate in un backup se nel frattempo ha ospitato qualcun altro.
- Funzionamento senza supervisione: il server si arresta dopo 30 minuti senza giocatori online e si riavvia automaticamente dopo un crash, fino a due volte.
- Indirizzo fisso: l’hub può servire il DNS per
zerotier.<server>.internal, che punta all’host corrente, così i giocatori tengono un solo indirizzo in Minecraft.



L’hub
Un unico binario Go statico, distribuito come container Docker su una macchina sempre accesa, per esempio un NAS. L’archiviazione è indirizzata per contenuto (SHA-256, con i file di regione divisi in blocchi), quindi ogni versione salva solo ciò che è cambiato. Ogni versione si può ripristinare, come mondo intero o come singolo file, oppure esportare in ZIP. La pulizia automatica non rimuove mai le ultime 24 ore e conserva una versione al giorno per una settimana.
L’interfaccia web mostra l’host corrente e l’indirizzo per entrare, i dettagli del mondo, i giocatori, le mod e tutto lo storico. L’hub può anche verificare che la porta di gioco dell’host sia raggiungibile e pubblicare su Telegram quando un server si apre o si chiude.




Accesso e sicurezza
MineSync non ha password né token propri. L’hub gira dentro la rete del container ZeroTier e identifica ogni richiesta tramite ZTNET, quindi l’accesso segue l’appartenenza alla rete: aggiungere un giocatore significa autorizzarlo in ZTNET. L’hub coordina soltanto le sessioni; il traffico di gioco passa direttamente tra i giocatori e l’host.
I client si aggiornano dall’hub. Ogni download viene verificato con checksum SHA-256 e, se configurata, con una firma ed25519, e i downgrade vengono rifiutati. Il client, l’interfaccia web e il bot Telegram sono disponibili in inglese e italiano.

Progetto successivo
mpv_audio_kit
Motore audio per Flutter e Dart, basato su mpv 0.41.