Updating Canvas

canvas_update.md

Note: format for commands is windows cmd, but it should be pretty easily changed
Linkie
mappings.dev

Note: you cannot migrate mojang mappings between different versions (yet?) so we will be migrating to yarn then back to mojang (steps 2-9 excluding 5)

1. cd fabric
2. migrate mappings for fabric/src/main/java to target version, e.g. (targeting 1.21)

..\gradlew migrateMappings --mappings "1.21+build.9"

3. replace the actual fabric/src/main/java with contents from remappedSrc
4. Repeat steps 2-3 but for common/src/main/java, e.g.

..\gradlew migrateMappings --mappings "1.21+build.9" --input ..\common\src\main\java

5. Update gruntle by changing MC_VERSION in gruntle.sh and executing ./gruntle.sh. WSL works if on windows
6. open build.gradle and change the mappings loom.officialMojangMappings() to mappings "net.fabricmc:yarn:<version>" ( should be the same as your --mappings arg in step 2)

dependencies {
    // ...
    mappings "net.fabricmc:yarn:1.21+build.9"
}

8. Repeat steps 2-4 but with --mappings net.minecraft:mappings:<version>, e.g.

..\gradlew migrateMappings --mappings net.minecraft:mappings:1.21

9. Undo step 6 (change the mappings back to loom.officialMojangMappings())
10. try to gradle build and fix any errors that occur (may need to fix mixins also)