Nivå 3Tom mod

Til lærerveiledningen

Åpne på mobilen

Skann koden med kameraet på mobilen. Avkrysningene dine blir med.

Introduksjon

Den minste moden som virker, har bare to filer: fabric.mod.json, som forteller Fabric hvem moden er, og én Java-klasse som kjøres når spillet starter. Moden gjør ingenting du kan se i spillet. Den skriver bare Hei fra rubinmod! i loggen.

Det høres lite ut, men i resten av kurset bygger du videre på akkurat disse to filene. Du lærer hva en mod-id er, hva et entrypoint er, og hvor du finner loggen når noe går galt.

Før du starter, må maskinen være klar. Følg

installasjonsveiledningen

først.

Steg 1: Se deg rundt i prosjektet

Åpne prosjektet rubinmod i IntelliJ. Det er mange filer, men bare noen av dem er dine. Resten hører til Gradle.

Sjekkliste

src/main/java og src/main/resources er moden din. Nesten alt du gjør i kurset, skjer i de to mappene.

Prosjektvinduet med src/main/java og src/main/resources
åpnet

Steg 2: fabric.mod.json

Når Minecraft starter med Fabric, leter Fabric etter fila fabric.mod.json i hver mod. Den sier hva moden heter, hva den trenger, og hvilken klasse som skal kjøres.

Sjekkliste

  • {
      "schemaVersion": 1,
      "id": "rubinmod",
      "version": "${version}",
      "name": "Rubinmod",
      "description": "Kursmod fra Lær Kidsa Koding.",
      "authors": ["Lær Kidsa Koding"],
      "license": "MIT",
      "environment": "*",
      "entrypoints": {
        "main": ["no.kidsakoder.rubinmod.RubinMod"]
      },
      "depends": {
        "fabricloader": ">=0.20.1",
        "minecraft": "~26.3",
        "java": ">=25",
        "fabric-api": "*"
      }
    }
    

${version} byttes ut med versjonsnummeret fra gradle.properties når moden bygges.

Steg 3: Klassen RubinMod

Sjekkliste

  • package no.kidsakoder.rubinmod;
    
    import net.fabricmc.api.ModInitializer;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    
    // Fabric kjører onInitialize() én gang når spillet starter,
    // fordi klassen står under "main" i fabric.mod.json.
    public class RubinMod implements ModInitializer {
        public static final String MOD_ID = "rubinmod";
        public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);
    
        @Override
        public void onInitialize() {
            LOGGER.info("Hei fra rubinmod!");
        }
    }
    

ModInitializer er et grensesnitt fra Fabric, med én metode: onInitialize(). Klassen din lover å ha den metoden. Fabric leser fabric.mod.json, finner klassen, lager et objekt av den og kaller onInitialize(). Det er her moden din forteller Minecraft om alt den har.

LOGGER skriver til loggen. Det er Minecraft sin versjon av IO.println. Meldingene havner i vinduet Run i IntelliJ og i fila logs/latest.log.

MOD_ID er mod-id-en en gang til, som en konstant. Den bruker vi mye senere.

Steg 4: Start spillet og finn meldingen

Sjekkliste

Test prosjektet

Tips

Java-koden leses bare når spillet starter. Når du har endret Java-kode, må du lukke Minecraft og kjøre runClient på nytt. Det gjelder resten av kurset også.

Steg 5: Når noe går galt

Loggen er det viktigste verktøyet ditt. Når spillet krasjer, står forklaringen der.

Sjekkliste

Feilmeldinger fra Java er lange. Les fra toppen, og se etter ord du kjenner igjen, som navnet på klassen eller fila di. Linjene som starter med at, viser hvor i koden feilen skjedde.

Utfordring