JamLib — una libreria tecnica per altre mod di Minecraft

JamLib — una libreria tecnica per altre mod di Minecraft

JamLib è una mod-libreria per Minecraft che, da sola, non aggiunge al gioco né oggetti, né blocchi, né mob, né strutture. È un wrapper di utilità che offre agli autori di altre mod quanto segue: un'astrazione di piattaforma tra i loader, un sistema di file di configurazione già pronto e un rilevatore di file jar riconfezionati. Senza questa libreria, le mod che la richiedono semplicemente non si avviano.

Cosa fa la mod

La libreria risolve tre compiti per lo sviluppatore contemporaneamente:

• Astrazioni di piattaforma basate su Architectury — lo stesso codice funziona su Fabric, Forge, NeoForge e Quilt senza rami separati.

• Un'API di configurazione in formato JSON5 con una schermata delle impostazioni automatica in gioco.

• Verifica del file jar di una mod alla ricerca di segni di riconfezionamento da «specchi» pirata.

Dal punto di vista del giocatore, la libreria non aggiunge nulla al gameplay. L'unica cosa che si può notare è la comparsa di una voce nel menu delle mod per ogni mod che usa JamLib per le proprie impostazioni. Se tali mod sono presenti nel modpack, nella finestra corrispondente apparirà una pagina con cursori, interruttori e campi di inserimento, generata automaticamente.

Configurazioni JSON5

Il JSON standard non consente commenti nel codice. JSON5, con cui la libreria lavora tramite la dipendenza Jankson, li consente. In pratica ciò significa che i file di impostazioni delle mod costruite su JamLib appaiono come .json5 e contengono già commenti che descrivono ogni parametro insieme al suo valore predefinito, subito sopra di esso.

I file conservano le modifiche dell'utente durante la riscrittura: se aggiungi una tua nota con una riga //, questa rimarrà al suo posto dopo il successivo salvataggio della configurazione. Le librerie JSON standard non sono in grado di farlo.

Le schermate delle impostazioni vengono generate separatamente. Su Fabric e Quilt l'interfaccia viene ripresa tramite il menu mod standard, su Forge e NeoForge tramite l'API integrata delle schermate di configurazione del loader. Gli autori delle mod non devono scrivere una GUI a mano: JamLib prende i campi dalla classe di configurazione e costruisce per essi widget con validazione — intervallo numerico, espressione regolare per le stringhe, avviso sulla necessità di riavviare il gioco.

Rilevatore di mod riconfezionate

Una funzione separata verifica se il file .jar della mod installata è stato scaricato da una fonte ufficiale. Alcuni siti riconfezionano le mod con nomi propri e talvolta vi aggiungono software di terze parti. JamLib confronta il nome reale del file con il campo JamLib-File-Name presente nel suo manifest. Se non corrispondono, dopo il caricamento del mondo viene mostrato un avviso in chat. Il messaggio viene mostrato una volta per ogni file sospetto, dopodiché il nome di quel .jar viene memorizzato.

Il controllo riguarda solo le mod i cui autori hanno deliberatamente aggiunto JamLib-File-Name al proprio manifest (cioè mod dello stesso sviluppatore o di chi ha integrato questa funzione manualmente). La libreria non esegue la scansione di ogni .jar nella cartella mods alla ricerca di virus o codice dannoso — non è un antivirus.

Conclusione

JamLib libera lo sviluppatore di una mod dalla scrittura manuale di un sistema di configurazione e di un'astrazione di piattaforma per quattro loader contemporaneamente. Installare JamLib ha senso solo insieme a una mod dipendente che lo richieda. Se un modpack non contiene alcuna mod di JamCoreModding o di un altro autore terzo basata su questa libreria, il .jar di JamLib rimarrà semplicemente nella cartella mods senza un ruolo attivo.