LibJF — Libreria tecnica e core per il supporto di mod di terze parti in Minecraft

LibJF — Libreria tecnica e core per il supporto di mod di terze parti in Minecraft

LibJF è una libreria modulare dell'autore JFronny, che contiene un set di componenti condivisi per le sue stesse mod. Sul PC di un giocatore, questa mod di solito non viene installata da sola, ma come dipendenza obbligatoria — senza di essa, le rispettive mod non si avviano. LibJF non aggiunge ricette, mob o nuovi blocchi a Minecraft. Il suo compito è diverso: estrarre funzionalità ripetitive — formato di configurazione, sistema di traduzione, server HTTP locale, due tag di utilità — in un progetto separato e riutilizzarlo attraverso diverse mod dello stesso sviluppatore.

Scopo in un Modpack

La libreria è divisa in moduli separati, ognuno responsabile del proprio compito: formato dei file di configurazione e il loro menu di gioco, tag degli oggetti, traduzione, componenti di rete. Le mod che dipendono da LibJF caricano solo i moduli che usano effettivamente. Pertanto, dopo il primo avvio del gioco, nella cartella config/ non appare un solo file, ma diversi (uno per modulo attivo).

Uno degli effetti di base che il giocatore noterà subito è il ricaricamento automatico delle configurazioni. Il parametro watchForChanges è abilitato per impostazione predefinita: se modifichi un file di configurazione che funziona tramite LibJF, le modifiche verranno applicate senza riavviare il gioco.

Tag universali per oggetti e armature

LibJF aggiunge due tag disponibili sia per altre mod che per i datapack vanilla:

I tag stessi sono vuoti — vengono riempiti da un datapack o da una mod di terze parti. Per rendere, ad esempio, un set di cuoio completo "impenetrabile" in sopravvivenza, è sufficiente creare un piccolo datapack che aggiunga minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings e minecraft:leather_boots al file del tag libjf:overpowered.

Sottosistema di traduzione

Il modulo libjf-translate-v1 dà alle altre mod dello sviluppatore accesso a un servizio di traduzione di stringhe. La libreria in sé non traduce nulla nella chat o nell'interfaccia — determina solo attraverso quale servizio esterno passeranno le richieste se una mod le chiama. Sono supportate quattro opzioni di provider:

• Google — interfaccia pubblica di Google Translate (valore predefinito).

• DeepLX — implementazione aperta dell'API DeepL.

• LibreTranslate — soluzione open-source self-hosted; richiede di specificare manualmente l'indirizzo dell'istanza.

• Noop — uno stub che restituisce il testo immesso senza modifiche; utile per i test e per disabilitare completamente la traduzione.

Un parametro separato throttleMillis imposta la pausa minima tra le chiamate al servizio. Questa restrizione è necessaria per evitare ban temporanei dall'API gratuita in caso di richieste frequenti da parte di una mod.

Server Web Locale

Il modulo libjf-web-v1 lancia un piccolo server HTTP all'interno del gioco. Viene utilizzato dalle altre mod dell'autore quando è necessario fornire al client qualcosa di più di un normale pacchetto di rete (ad esempio, una pagina statica o un file di anteprima). Nell'ambiente standard di un giocatore, questo modulo di solito è silenzioso: la porta è aperta solo localmente (127.0.0.1) e la condivisione di file è disabilitata.

Gli amministratori di server privati possono abilitare la condivisione di file arbitrari dalla cartella config/wwwroot come risorse statiche tramite un parametro di configurazione separato — questa è una funzione opzionale, non attivata per impostazione predefinita.

Conclusione

LibJF è una libreria di dipendenza richiesta quando un modpack contiene una mod dello stesso sviluppatore o un datapack che usa i tag libjf:overpowered o libjf:shulker_boxes_illegal. Rispetto ad altre librerie di questa classe, si distingue per un'architettura modulare e la presenza di un server HTTP locale insieme a un livello di traduzione, che la maggior parte delle librerie ausiliarie non offre. Per un normale modpack Minecraft Java Edition vanilla, non ha senso installare LibJF; per i modpack con le mod di JFronny, è un componente obbligatorio.