Forge Config API Port — Minecraft Java Edition

Vanilla Minecraft indeholder ikke indbyggede værktøjer til nem konfiguration af spilparametre eller modifikationer, hvilket tvinger udviklere til selv at oprette systemer til at gemme konfigurationer. Forge mod loaderen tilbyder en færdig løsning i form af sit eget konfigurationssystem, men Fabric har historisk set ikke en fælles standard for dette. Derfor skal skabere af tværplatform-mods skrive separat konfigurationskode til hver loader, hvilket tager meget tid med rutinearbejde. Forge Config API Port-biblioteket løser dette problem ved at overføre Forge's tidsprøvede konfigurationsgrænseflade til Fabric og Quilt.

Hvordan biblioteket fungerer

Forge Config API Port fungerer som en formidler mellem modifikationskoden og spillets filsystem. Det genskaber fuldstændigt de originale pakker net.minecraftforge.common.ForgeConfigSpec og net.neoforged.fml.config i Fabric-miljøet. Udvikleren skriver kun konfigurationsbeskrivelsen én gang ved hjælp af standard Forge-syntaks, og biblioteket opretter automatisk de tilsvarende filer på disken og administrerer indlæsningen af dem.

Formatet for TOML-konfigurationsfiler

Biblioteket gemmer alle indstillinger i TOML-format. Dette format giver en praktisk struktur til læsning og redigering ved hjælp af en almindelig teksteditor. Hver parameter kan indeholde kommentarer, standardværdier samt klare grænser for acceptable værdier (minimums- og maksimumstal). Konfigurationsfiler vises automatisk i mappen config i spillets rodmappe efter den første start af modifikationen. De har filtypenavnet .toml og det navn, som mod-udvikleren har angivet.

Automatisk synkronisering og dynamisk genindlæsning

En af de vigtigste funktioner i Forge Config API Port og den indbyggede understøttelse af synkronisering og dynamisk genindlæsning af konfigurationer:

• Synkronisering mellem server og klient (Sync): Når en spiller forbinder til en server, sender serveren automatisk sine indstillinger til klienten. Dette forhindrer konflikter på grund af forskellige konfigurationsversioner blandt spillere på serveren.

• Dynamisk genindlæsning (Reload): Biblioteket overvåger ændringer i TOML-filer i realtid. Hvis du redigerer og gemmer konfigurationsfilen under spillet, vil Forge Config API Port øjeblikkeligt opdatere parametrene i RAM uden at skulle genstarte Minecraft-klienten.

Disse mekanismer fungerer automatisk, hvilket sparer udviklere for at skulle kode netværksinteraktion selv for at synkronisere konfigurationsværdier.

Betydning for spillere og udviklere

For almindelige spillere tilføjer Forge Config API Port ikke noget synligt indhold, nye blokke eller genstande. Dets rolle er at sikre, at andre modifikationer fungerer. Uden installation af dette bibliotek vil spillet simpelthen ikke starte, hvis andre mods refererer til dets klasser. Modifikationen er mest nødvendig for Fabric-brugere, da Forge og NeoForge har disse funktioner som standard i deres struktur.

For udviklere er biblioteket et uundværligt værktøj ved oprettelse af tværplatform-projekter. Det gør det muligt at:

1. Spare hundredvis af linjer kode, som tidligere gik til at udvikle separat logik til at gemme indstillinger for forskellige loadere.

2. Sikre den samme mod-administrationsoplevelse for slutbrugere, da konfigurationsfiler har en identisk struktur på Fabric og Forge.

3. Bruge Forge's kraftfulde værktøjer til værdavalidering, som automatisk retter forkerte brugerinput og gendanner standardværdier i tilfælde af fejl.

Populære afhængige modifikationer

Udvikleren af biblioteket, kendt under kaldenavnet Fuzs (eller Fuzs_), bruger det i alle sine populære mods. Her er nogle kendte eksempler:

• Easy Magic: Et mod, der ændrer fortryllelsesbordets mekanik, så genstande kan gemmes i bordets inventar, og tilføjer nye måder at forbedre fortryller på.

• Trading Post: En blok, der samler handelstilbud fra alle omkringliggende landsbyboere i én grænseflade.

• Visuality: Et mod til visuelle effekter, der tilføjer realistiske partikler af snavs, gnister og vandsprøjt fra forskellige mob-handlinger.

• Easy Shulker Boxes: Gør det muligt at interagere med shulkerbokse direkte fra inventaret uden at skulle placere dem på jorden.

Udover projekter fra Fuzs bruger hundredvis af andre udviklere Forge Config API Port til at overføre deres arbejde fra Forge til Fabric, hvilket giver spillere adgang til et enormt bibliotek af kvalitetsindhold.