JamLib — et teknisk bibliotek for andre Minecraft-mods

JamLib — et teknisk bibliotek for andre Minecraft-mods

JamLib er en biblioteks-mod til Minecraft, som i sig selv ikke tilføjer genstande, blokke, mobs eller strukturer til spillet. Det er en utility-wrapper, der giver forfattere til andre mods følgende: en platformabstraktion mellem loaders, et færdigt konfigurationsfilsystem og en detektor for ompakkede jar-filer. Uden dette bibliotek starter mods, der kræver det, simpelthen ikke.

Hvad mod'en gør

Biblioteket løser tre opgaver for udvikleren på samme tid:

• Platformabstraktioner baseret på Architectury — den samme kode kører på Fabric, Forge, NeoForge og Quilt uden separate grene.

• En konfigurations-API i JSON5-format med en automatisk indstillingsskærm i spillet.

• Kontrol af en mods jar-fil for tegn på ompakning fra piratkopierede «spejle».

Set fra spillerens synspunkt tilføjer biblioteket ikke noget til gameplayet. Det eneste, man kan bemærke, er et nyt punkt i mod-menuen for enhver mod, der bruger JamLib til sine indstillinger. Hvis sådanne mods findes i pakken, vil det tilhørende vindue vise en automatisk genereret side med skydeknapper, kontakter og indtastningsfelter.

JSON5-konfigurationer

Standard-JSON tillader ikke kommentarer i koden. JSON5, som biblioteket arbejder med via afhængigheden Jankson, tillader det. I praksis betyder det, at indstillingsfilerne for mods bygget på JamLib ligner .json5 og allerede indeholder kommentarer, der beskriver hver parameter sammen med standardværdien lige ovenover.

Filerne bevarer brugerens rettelser ved genskrivning: hvis du tilføjer din egen note på en linje, der starter med //, forbliver den på plads, efter at konfigurationen er gemt igen. Standard JSON-biblioteker kan ikke dette.

Indstillingsskærme genereres separat. På Fabric og Quilt hentes grænsefladen via den almindelige mod-menu, på Forge og NeoForge via loaderens indbyggede API til konfigurationsskærme. Mod-forfattere behøver ikke skrive en GUI manuelt: JamLib tager felterne fra konfigurationsklassen og bygger widgets med validering til dem — talintervaller, et regulært udtryk for strenge, advarsler om behovet for at genstarte spillet.

Detektor for ompakkede mods

En separat funktion kontrollerer, om .jar-filen for den installerede mod blev downloadet fra en officiel kilde. Nogle sites ompakker mods under deres eget navn og tilføjer nogle gange tredjepartssoftware. JamLib sammenligner det faktiske filnavn med feltet JamLib-File-Name i dets manifest. Stemmer de ikke overens, vises en advarsel i chatten, efter at verdenen er indlæst. Beskeden vises én gang pr. mistænkelig fil, hvorefter navnet på den .jar huskes.

Kontrollen gælder kun mods, hvis forfattere bevidst har tilføjet JamLib-File-Name til deres manifest (altså mods fra samme udvikler eller dem, der har integreret denne funktion manuelt). Biblioteket scanner ikke alle .jar-filer i mods-mappen for vira eller ondsindet kode — det er ikke et antivirusprogram.

Konklusion

JamLib frigør en mod-udvikler fra manuelt at skrive et konfigurationssystem og en platformabstraktion til fire loaders på én gang. Det giver kun mening at installere JamLib sammen med en afhængig mod, der kræver det. Hvis en pakke ikke indeholder nogen mod fra JamCoreModding eller en anden tredjepartsforfatter baseret på dette bibliotek, vil JamLibs .jar simpelthen ligge i mods-mappen uden en aktiv rolle.