JamLib — et teknisk bibliotek for andre Minecraft-mods

JamLib — et teknisk bibliotek for andre Minecraft-mods

JamLib er en biblioteksmod til Minecraft som i seg selv ikke legger til gjenstander, blokker, mobs eller strukturer i spillet. Det er en hjelpeomslag som gir forfattere av andre mods følgende: en plattformabstraksjon mellom loadere, et ferdig konfigurasjonsfilsystem og en detektor for ompakkede jar-filer. Uten dette biblioteket vil ikke mods som krever det, starte i det hele tatt.

Hva mod'en gjør

Biblioteket løser tre oppgaver for utvikleren samtidig:

• Plattformabstraksjoner basert på Architectury — samme kode kjører på Fabric, Forge, NeoForge og Quilt uten separate grener.

• Et konfigurasjons-API i JSON5-format med en automatisk innstillingsskjerm i spillet.

• Kontroll av en mods jar-fil for tegn på ompakking fra piratkopierte «speil».

Sett fra spillerens ståsted legger biblioteket ikke til noe i spillopplevelsen. Det eneste man kan legge merke til, er et nytt punkt i mod-menyen for enhver mod som bruker JamLib til sine innstillinger. Hvis slike mods finnes i pakken, vil det tilhørende vinduet vise en automatisk generert side med glidebrytere, brytere og inndatafelt.

JSON5-konfigurasjoner

Standard JSON tillater ikke kommentarer i koden. JSON5, som biblioteket jobber med via avhengigheten Jankson, tillater det. I praksis betyr dette at innstillingsfilene til mods bygget på JamLib ser ut som .json5 og allerede inneholder kommentarer som beskriver hver parameter sammen med standardverdien rett over.

Filene bevarer brukerens redigeringer ved omskriving: hvis du legger til ditt eget notat på en linje som starter med //, blir det værende etter at konfigurasjonen lagres på nytt. Standard JSON-biblioteker kan ikke dette.

Innstillingsskjermer genereres separat. På Fabric og Quilt hentes grensesnittet via den vanlige mod-menyen, på Forge og NeoForge via loaderens innebygde API for konfigurasjonsskjermer. Mod-forfattere trenger ikke skrive et GUI for hånd: JamLib henter feltene fra konfigurasjonsklassen og bygger widgets med validering for dem — tallintervaller, et regulært uttrykk for strenger, advarsler om behovet for å starte spillet på nytt.

Detektor for ompakkede mods

En egen funksjon sjekker om .jar-filen til den installerte moden ble lastet ned fra en offisiell kilde. Enkelte nettsteder pakker om mods under sitt eget navn og legger noen ganger til tredjepartsprogramvare. JamLib sammenligner det faktiske filnavnet med feltet JamLib-File-Name i manifestet. Hvis de ikke stemmer overens, vises en advarsel i chatten etter at verdenen er lastet inn. Meldingen vises én gang per mistenkelig fil, hvorpå navnet på den .jar-filen huskes.

Kontrollen gjelder bare mods hvis forfattere bevisst har lagt til JamLib-File-Name i manifestet sitt (altså mods fra samme utvikler eller de som har integrert denne funksjonen manuelt). Biblioteket skanner ikke alle .jar-filer i mods-mappen for virus eller skadelig kode — det er ikke et antivirusprogram.

Konklusjon

JamLib frigjør en modutvikler fra å skrive et konfigurasjonssystem og en plattformabstraksjon for hånd for fire loadere samtidig. Å installere JamLib er bare meningsfullt sammen med en avhengig mod som krever det. Hvis en pakke ikke inneholder noen mod fra JamCoreModding eller en annen tredjepartsforfatter basert på dette biblioteket, vil JamLibs .jar-fil rett og slett ligge i mods-mappen uten en aktiv rolle.