Forge Config API Port — Minecraft Java Edition

Vanilla Minecraft innehåller inga inbyggda verktyg för smidig konfigurering av spelparametrar eller modifikationer, vilket tvinger utvecklare att skapa egna system för att spara inställningar. Forge mod-loadern erbjuder en färdig lösning i form av sitt eget konfigurationssystem, men Fabric har historiskt sett inte haft någon gemensam standard för detta. På grund av detta måste skapare av plattformsöverskridande moddar skriva separat konfigurationskod för varje loader, vilket tar mycket tid i anspråk för rutinarbete. Forge Config API Port-biblioteket löser detta problem genom att överföra Forges beprövade konfigurationsgränssnitt till Fabric och Quilt.

Hur biblioteket fungerar

Forge Config API Port fungerar som en mellanhand mellan modifikationskoden och spelets filsystem. Det återskapar helt de ursprungliga paketen net.minecraftforge.common.ForgeConfigSpec och net.neoforged.fml.config i Fabric-miljön. Utvecklaren skriver konfigurationsbeskrivningen endast en gång med standard Forge-syntax, och biblioteket skapar automatiskt motsvarande filer på disken samt hanterar inläsningen av dem.

Konfigurationsfilsformatet TOML

Biblioteket sparar alla inställningar i TOML-format. Detta format ger en bekväm struktur för läsning och redigering med en vanlig textredigerare. Varje parameter kan innehålla kommentarer, standardvärden samt tydliga gränser för tillåtna värden (minimiu- och maximisiffra). Konfigurationsfiler visas automatiskt i mappen config i spelets rotkatalog efter den första starten av modifikationen. De har filändelsen .toml och det namn som anges av mod-utvecklaren.

Automatisk synkronisering och dynamisk omladdning

En av de viktigaste funktionerna i Forge Config API Port är det inbyggda stödet för synkronisering och dynamisk omladdning av konfigurationer:

• Synkronisering mellan server och klient (Sync): När en spelare ansluter till servern skickar servern automatiskt sina inställningar till klienten. Detta förhindrar konflikter på grund av olika versioner av konfigurationer hos spelarna på serveren.

• Dynamisk omladdning (Reload): Biblioteket övervakar ändringar i TOML-filer i realtid. Om du redigerar och sparar konfigurationsfilen under pågående spel kommer Forge Config API Port omedelbart att uppdatera parametrarna i RAM-minnet utan att du behöver starta om Minecraft-klienten.

Dessa mekanismer fungerar automatiskt, vilket besparar utvecklare från att själva behöva koda nätverksinteraktion för att synkronisera konfigurationsvärden.

Betydelse för spelare och utvecklare

För vanliga spelare lägger inte Forge Config API Port till något synligt innehåll, nya block eller föremål. Dess roll är att säkerställa att andra modifikationer fungerar. Utan installation av detta bibliotek startar spelet helt enkelt inte om andra moddar refererar till dess klasser. Modifikationen krävs främst för Fabric-användare, eftersom Forge och NeoForge har dessa funktioner som standard i sin struktur.

För utvecklare är biblioteket ett oumbärligt verktyg vid skapande av plattformsöverskridande projekt. Det gör det möjligt att:

1. Spara hundratals rader kod som tidigare gick åt till att utveckla separat logik för att spara inställningar för olika loaders.

2. Säkerställa samma mod-administrationsupplevelse för slutanvändare, eftersom konfigurationsfilerna har en identisk struktur på Fabric och Forge.

3. Använda Forges kraftfulla verktyg för värdevalidering, som automatiskt korrigerer felaktiga användarindata och återställer parametrar till standardvärden vid fel.

Populära beroende modifikationer

Utvecklaren av biblioteket, känd under nicket Fuzs (eller Fuzs_), använder det i alla sina populära moddar. Här är några kända exempel:

• Easy Magic: En modd som ändrar förtrollningsbordets mekanik, vilket gör det möjligt att behålla föremål i bordets förråd och lägger till nya sätt att förbättra förtrollningar.

• Trading Post: Ett block som samlar handelsavtal från alla omgivande bybor i ett enda gränssnitt.

• Visuality: En modd för visuella effekter som lägger till realistiska smutspartiklar, gnistor och vattenstänk från olika mobs handlingar.

• Easy Shulker Boxes: Gör det möjligt att interagera med shulkerboxar direkt från förrådet utan att behöva placera dem på marken.

Utöver projekt från Fuzs använder hundratals andra utvecklare Forge Config API Port för att flytta sina arbeten från Forge till Fabric, vilket ger spelare tillgang till ett enormt bibliotek av kvalitetsinnehåll.