JamLib — ett tekniskt bibliotek för andra Minecraft-mods

JamLib — ett tekniskt bibliotek för andra Minecraft-mods

JamLib är en biblioteksmod för Minecraft som i sig själv inte lägger till några föremål, block, mobbar eller strukturer i spelet. Det är en hjälpomslagning som ger andra modförfattare följande: en plattformsabstraktion mellan loaders, ett färdigt konfigurationsfilsystem och en detektor för ompaketerade jar-filer. Utan detta bibliotek startar helt enkelt inte de mods som kräver det.

Vad mod'en gör

Biblioteket löser tre uppgifter för utvecklaren samtidigt:

• Plattformsabstraktioner baserade på Architectury — samma kod körs på Fabric, Forge, NeoForge och Quilt utan separata grenar.

• Ett konfigurations-API i JSON5-format med en automatisk inställningsskärm i spelet.

• Kontroll av en mods jar-fil för tecken på ompaketering från piratkopierade «speglar».

Ur spelarens perspektiv lägger biblioteket inte till något i spelupplevelsen. Det enda man kan märka är en ny post i modmenyn för varje mod som använder JamLib för sina inställningar. Om sådana mods finns i paketet visas i motsvarande fönster en automatiskt genererad sida med skjutreglage, brytare och inmatningsfält.

JSON5-konfigurationer

Standard-JSON tillåter inte kommentarer i koden. JSON5, som biblioteket arbetar med via beroendet Jankson, tillåter det. I praktiken betyder detta att inställningsfilerna för mods byggda på JamLib ser ut som .json5 och redan innehåller kommentarer som beskriver varje parameter tillsammans med standardvärdet direkt ovanför.

Filerna bevarar användarens ändringar vid omskrivning: om du lägger till en egen anteckning på en //-rad förblir den kvar efter att konfigurationen sparas igen. Standard-JSON-bibliotek kan inte göra detta.

Inställningsskärmar genereras separat. På Fabric och Quilt hämtas gränssnittet via den vanliga modmenyn, på Forge och NeoForge via loaderns inbyggda API för konfigurationsskärmar. Modförfattare behöver inte skriva ett GUI för hand: JamLib tar fälten från konfigurationsklassen och bygger widgets med validering för dem — talintervall, ett reguljärt uttryck för strängar, varningar om behovet av att starta om spelet.

Detektor för ompaketerade mods

En separat funktion kontrollerar om den installerade modens .jar-fil laddades ner från en officiell källa. Vissa webbplatser paketerar om mods under sina egna namn och lägger ibland till tredjepartsmjukvara. JamLib jämför filens faktiska namn med fältet JamLib-File-Name i dess manifest. Om de inte stämmer överens visas en varning i chatten efter att världen har laddats. Meddelandet visas en gång per misstänkt fil, varefter namnet på den .jar-filen kommer ihåg.

Kontrollen gäller endast mods vars författare medvetet lagt till JamLib-File-Name i sitt manifest (alltså mods från samma utvecklare eller de som har integrerat denna funktion manuellt). Biblioteket skannar inte varje .jar-fil i mods-mappen efter virus eller skadlig kod — det är inget antivirusprogram.

Slutsats

JamLib befriar en modutvecklare från att manuellt skriva ett konfigurationssystem och en plattformsabstraktion för fyra loaders samtidigt. Det är bara meningsfullt att installera JamLib tillsammans med en beroende mod som kräver det. Om ett paket inte innehåller någon mod från JamCoreModding eller en annan tredjepartsförfattare baserad på detta bibliotek, kommer JamLibs .jar-fil helt enkelt att ligga i mods-mappen utan en aktiv roll.