JamLib — een technische bibliotheek voor andere Minecraft-mods

JamLib — een technische bibliotheek voor andere Minecraft-mods

JamLib is een bibliotheek-mod voor Minecraft die op zichzelf geen items, blokken, mobs of structuren aan het spel toevoegt. Het is een utility-wrapper die auteurs van andere mods het volgende biedt: een platformabstractie tussen loaders, een kant-en-klaar configuratiebestandensysteem en een detector voor reverpakte jar-bestanden. Zonder deze bibliotheek starten mods die haar vereisen simpelweg niet op.

Wat de mod doet

De bibliotheek lost drie taken tegelijk op voor de ontwikkelaar:

• Platformabstracties gebaseerd op Architectury — dezelfde code werkt op Fabric, Forge, NeoForge en Quilt zonder aparte branches.

• Een configuratie-API in JSON5-formaat met een automatisch instellingenscherm in het spel.

• Controle van het jar-bestand van een mod op tekenen van reverpakking vanaf piraten-«spiegels».

Vanuit het perspectief van de speler voegt de bibliotheek niets toe aan de gameplay. Het enige wat opvalt, is een nieuw item in het mod-menu voor elke mod die JamLib gebruikt voor zijn instellingen. Als zulke mods in de pack aanwezig zijn, verschijnt in het bijbehorende venster een automatisch gegenereerde pagina met schuifregelaars, schakelaars en invoervelden.

JSON5-configuraties

Standaard-JSON staat geen commentaar in de code toe. JSON5, waarmee de bibliotheek werkt via de afhankelijkheid Jankson, staat dit wel toe. In de praktijk betekent dit dat de instellingenbestanden van mods die op JamLib zijn gebouwd, eruitzien als .json5 en al commentaar bevatten dat elke parameter beschrijft, samen met de standaardwaarde er direct boven.

De bestanden behouden gebruikerswijzigingen bij het herschrijven: als je je eigen notitie toevoegt met een //-regel, blijft deze staan nadat de configuratie opnieuw is opgeslagen. Standaard JSON-bibliotheken kunnen dit niet.

Instellingenschermen worden apart gegenereerd. Op Fabric en Quilt wordt de interface opgepikt via het standaard modmenu, op Forge en NeoForge via de ingebouwde configuratieschermen-API van de loader. Mod-auteurs hoeven geen GUI met de hand te schrijven: JamLib haalt de velden uit de configuratieklasse en bouwt daarvoor widgets met validatie — getalbereik, een reguliere expressie voor tekenreeksen, waarschuwingen over de noodzaak om het spel opnieuw te starten.

Detector voor reverpakte mods

Een aparte functie controleert of het .jar-bestand van de geïnstalleerde mod is gedownload van een officiële bron. Sommige sites verpakken mods opnieuw onder hun eigen naam en voegen er soms software van derden aan toe. JamLib vergelijkt de werkelijke bestandsnaam met het veld JamLib-File-Name in het manifest. Komen ze niet overeen, dan verschijnt er na het laden van de wereld een waarschuwing in de chat. Het bericht wordt één keer per verdacht bestand getoond, waarna de naam van die .jar wordt onthouden.

De controle geldt alleen voor mods waarvan de auteurs JamLib-File-Name bewust aan hun manifest hebben toegevoegd (dus mods van dezelfde ontwikkelaar of van wie deze functie handmatig heeft geïntegreerd). De bibliotheek scant niet elk .jar-bestand in de mods-map op virussen of schadelijke code — het is geen antivirus.

Conclusie

JamLib bevrijdt een modontwikkelaar van het handmatig schrijven van een configuratiesysteem en platformabstractie voor vier loaders tegelijk. JamLib installeren heeft alleen zin samen met een afhankelijke mod die het vereist. Als een pack geen enkele mod van JamCoreModding of een andere externe auteur op basis van deze bibliotheek bevat, blijft de .jar van JamLib gewoon zonder actieve rol in de mods-map staan.