[1.20.4] Feat: Dynamic qualifier deobfuscation (#117)

This pull requests implements a brand new dynamic class remapping that
uses the existing dynamic reflection serializer
It allows reflection of obfuscated minecraft members for the packet
logger module

Mappings are downloaded from our cloudflare bucket at
`mappings.lambda-client.org` and are stored loosely in the cache folder

Before:
```
net.minecraft.class_2672
  field_12236: -10
  field_12235: -4
  field_34870: net.minecraft.class_6603@721373fb
    net.minecraft.class_6603
      field_34862: 2097152
      field_34863: {MOTION_BLOCKING:[L;3086490446775277226L,3122730762615747244L,3104504914273194157L,3339185846487446187L,3104540029253932717L,3519681675303147692L,3104399154733218493L,3519470292041816236L,3050427429879123655L,3411242338997591207L,3411595972921364163L,3140639401982644921L,3591915948460571321L,3140639607472093891L,3591739268801584302L,3266845471266932423L,3411242545290239149L,3086984267357324989L,3194753034973702833L,3339185846487446191L,3104504846089803442L,3339184675971488428L,3032729277053101234L,3086490446640796329L,3248902058093139627L,3050355889943694515L,3230605634851133098L,2996242119247620788L,3086490446640533671L,2960143917570156202L,3068440725916568229L,3230887659449177258L,3014256517618681506L,3050391143438701737L,2942093163902356648L,3050391143303957669L,22189789353L],WORLD_SURFACE:[L;3086490446775277227L,3122730762615747244L,3104504914273194157L,3339185846487446187L,3122554427763414701L,3519681675303147692L,3104399154733218493L,3519470292041816236L,3050427429879123655L,3411242338997591207L,3411595972921364163L,3140639401982644921L,3591915948460571321L,3140639607472093891L,3591739268801584303L,3266845471266932423L,3411242545290239149L,3086984267357324989L,3194753035108182705L,3339185846487446191L,3104504846089803442L,3339184676105706156L,3032729277053101234L,3086490446640796329L,3248902058093139627L,3050355889943694515L,3230605634851133098L,2996242119247620788L,3086490446640533671L,2960143917570156202L,3068440725916568229L,3230887659449177258L,3014256517618681506L,3050391143438701737L,2942093163902356648L,3050391143303957669L,22189789353L]}
      field_34864: [B@62e634ff
      field_34865: []
  field_34871: net.minecraft.class_6606@703b0ecd
    net.minecraft.class_6606
      field_34873: {2, 3, 4, 11, 12, 13, 14}
      field_34874: {2, 3, 4, 9, 11}
      field_34875: {0, 1, 5, 6, 7, 8, 9, 10}
      field_34876: {0, 1, 5, 6, 7, 8, 10, 12, 13, 14}
      field_34877: [[B@5ebc4893, [B@d2ece77, [B@92524f5, [B@21c01e7a, [B@1d843201, [B@66220ab0, [B@4680880d]
      field_34878: [[B@67926d69, [B@5b3a5fa0, [B@2d3ba9fd, [B@6f398cb7, [B@1bb44d1c]
```

After:
```
ChunkDataS2CPacket
  chunkX: -10
  chunkZ: -8
  chunkData: ChunkData@349c0420
    ChunkData
      MAX_SECTIONS_DATA_SIZE: 2097152
      heightmap: {MOTION_BLOCKING:[L;2797696018872349336L,2761561462444734620L,2797660766991106717L,2743582454868686491L,2942234244450431640L,2779716873588913827L,3121884685859631257L,2797696501120061101L,2761562013141382299L,2924079110605333144L,2888049830799423138L,3122730831997644960L,2941987128944969383L,3212836218723190435L,2779646918238493361L,2743547614632689824L,2779928462473126577L,2743829089607038106L,2942234246602109080L,2815745464315232416L,2942234243778031772L,2815675577414271651L,2941705447942471324L,2887979531044733603L,2815745877438445722L,2924078765392867996L,2815851223858102433L,2905993859626253983L,2815675165097411234L,2887838656116899484L,2779857886762058400L,2924078765123384474L,2887944277684468381L,2869894419118109850L,2924043374593916578L,2815675164291579554L,21382381212L],WORLD_SURFACE:[L;2797696018872349336L,2761561462444734620L,2797660766991106717L,2761596853378168475L,2942234244450431641L,2779716873723393699L,3121884685859631770L,2797696501120061101L,2761562013141382299L,2924079110605333144L,2888049830799423138L,3122730831997907104L,2941987128944969383L,3212836218723190435L,2779682102610582193L,2743547614632689824L,2779928462473126577L,2761843488116520090L,2942234246602109080L,2815745533034709152L,2942234243778032284L,2815675577414271651L,2941740632314560156L,2887979531044733603L,2815745877438445722L,2924078765392867996L,2815851223858364577L,2905993859760471711L,2815675165097411234L,2887838656116899484L,2779857886762058400L,2924078765123384986L,2887944277684468381L,2869894419118109850L,2924043374593916578L,2815745670474710690L,21382381212L]}
      sectionsData: [B@1acfdb99
      blockEntities: []
  lightData: LightData@37f330be
    LightData
      initedSky: {2, 10, 11, 12, 13}
      initedBlock: {2, 3, 4, 10}
      uninitedSky: {0, 1, 3, 4, 5, 6, 7, 8, 9}
      uninitedBlock: {0, 1, 5, 6, 7, 8, 9, 11, 12, 13}
      skyNibbles: [[B@5e55fb7b, [B@3aa2f03b, [B@37a46db0, [B@197ccd3a, [B@6803634d]
      blockNibbles: [[B@458d755e, [B@51d059b2, [B@2e3a4baf, [B@5dd05c2e]
```

This pull request also revamps the file utilities with a more
streamlined and functional approach
Examples:
```kt
File("...")
    .downloadCompare(url = "...", 1) // Download if remote is larger than local
    
File("...")
    .downloadIfNotPresent(url = "...") { header("key", "value") } // Create the file and download the content to it; Modify the http request before posting
```

---------

Co-authored-by: Constructor <fractalminds@protonmail.com>

Author: emyfops

common/src/main/java/com/lambda/mixin/CrashReportMixin.java

@@ -0,0 +1,79 @@
+/*
+ * Copyright 2025 Lambda
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.lambda.mixin;
+
+import com.lambda.Lambda;
+import com.lambda.module.Module;
+import com.lambda.module.ModuleRegistry;
+import com.lambda.util.DynamicException;
+import net.minecraft.client.MinecraftClient;
+import net.minecraft.util.Util;
+import net.minecraft.util.crash.CrashReport;
+import org.spongepowered.asm.mixin.Final;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.Mutable;
+import org.spongepowered.asm.mixin.Shadow;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.Redirect;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfoReturnable;
+
+// Modify the crash report behavior for dynamic remapping, Easter egg and github issue link
+@Mixin(CrashReport.class)
+public class CrashReportMixin {
+    @Mutable
+    @Shadow @Final private Throwable cause;
+
+    @Inject(method = "<init>(Ljava/lang/String;Ljava/lang/Throwable;)V", at = @At("TAIL"))
+    void injectConstructor(String message, Throwable cause, CallbackInfo ci) {
+        if (!Lambda.INSTANCE.isDebug() && MinecraftClient.getInstance() != null) {
+            this.cause = new DynamicException(cause);
+        }
+    }
+
+    @Redirect(method = "asString()Ljava/lang/String;", at = @At(value = "INVOKE", target = "Lnet/minecraft/util/crash/CrashReport;addStackTrace(Ljava/lang/StringBuilder;)V"))
+    void injectString(CrashReport instance, StringBuilder stringBuilder) {
+        stringBuilder.append("If this issue is related to Lambda, check if other users have experienced this too, or create a new issue at https://github.com/lambda-client/lambda/issues.\n\n");
+
+        if (MinecraftClient.getInstance() != null) {
+            stringBuilder.append("Enabled modules:\n");
+
+            ModuleRegistry.INSTANCE.getModules()
+                    .stream().filter(Module::isEnabled)
+                    .forEach(m -> stringBuilder.append("\t").append(m.getName()).append("\n"));
+        }
+
+        stringBuilder.append("\n");
+        stringBuilder.append("-".repeat(43));
+        stringBuilder.append("\n\n");
+
+        instance.addStackTrace(stringBuilder);
+    }
+
+    @Inject(method = "generateWittyComment()Ljava/lang/String;", at = @At("HEAD"), cancellable = true)
+    private static void generateWittyComment(CallbackInfoReturnable<String> cir) {
+        String[] strings = new String[]{"Who set us up the TNT?", "Everything's going to plan. No, really, that was supposed to happen.", "Uh... Did I do that?", "Oops.", "Why did you do that?", "I feel sad now :(", "My bad.", "I'm sorry, Dave.", "I let you down. Sorry :(", "On the bright side, I bought you a teddy bear!", "Daisy, daisy...", "Oh - I know what I did wrong!", "Hey, that tickles! Hehehe!", "I blame Dinnerbone.", "You should try our sister game, Minceraft!", "Don't be sad. I'll do better next time, I promise!", "Don't be sad, have a hug! <3", "I just don't know what went wrong :(", "Shall we play a game?", "Quite honestly, I wouldn't worry myself about that.", "I bet Cylons wouldn't have this problem.", "Sorry :(", "Surprise! Haha. Well, this is awkward.", "Would you like a cupcake?", "Hi. I'm Minecraft, and I'm a crashaholic.", "Ooh. Shiny.", "This doesn't make any sense!", "Why is it breaking :(", "Don't do that.", "Ouch. That hurt :(", "You're mean.", "This is a token for 1 free hug. Redeem at your nearest Mojangsta: [~~HUG~~]", "There are four lights!", "But it works on my machine.", "Popbob was here.", "The oldest anarchy server in Minecraft.", "Better luck next time..", "Fatal error occurred user is too based.", "Running premium software on a potato is not advised", "I don't know, ask that kilab guy", "Ah shit, here we go again.", "I will uhh, fix that sometime.", "Not a bug, a feature!", "You should try out Lambda on Windows XP.", "Blade did that."};
+
+        try {
+            cir.setReturnValue(strings[(int)(Util.getMeasuringTimeNano() % (long)strings.length)]);
+        } catch (Throwable var2) {
+            cir.setReturnValue("Witty comment unavailable :(");
+        }
+    }
+}

common/src/main/kotlin/com/lambda/command/commands/ReplayCommand.kt

@@ -27,8 +27,8 @@ import com.lambda.brigadier.executeWithResult
 import com.lambda.brigadier.required
 import com.lambda.command.LambdaCommand
 import com.lambda.module.modules.player.Replay
+import com.lambda.util.FileUtils.listRecursive
 import com.lambda.util.FolderRegister
-import com.lambda.util.FolderRegister.listRecursive
 import com.lambda.util.extension.CommandBuilder
 import kotlin.io.path.exists
 

common/src/main/kotlin/com/lambda/module/modules/client/Network.kt

@@ -31,6 +31,7 @@ import com.lambda.network.NetworkManager.updateToken
 import com.lambda.network.api.v1.endpoints.login
 import com.lambda.util.StringUtils.hash
 import com.lambda.util.extension.isOffline
+import net.minecraft.SharedConstants
 import net.minecraft.client.network.AllowedAddressResolver
 import net.minecraft.client.network.ClientLoginNetworkHandler
 import net.minecraft.client.network.ServerAddress
@@ -51,6 +52,9 @@ object Network : Module(
     val authServer  by setting("Auth Server", "auth.lambda-client.org")
     val apiUrl      by setting("API Server", "https://api.lambda-client.org")
     val apiVersion  by setting("API Version", ApiVersion.V1)
+    val mappings    by setting("Mappings", "https://mappings.lambda-client.org")
+
+    val gameVersion = SharedConstants.getGameVersion().name
 
     private var hash: String? = null
 

common/src/main/kotlin/com/lambda/module/modules/network/PacketLogger.kt

@@ -30,14 +30,14 @@ import com.lambda.util.Communication
 import com.lambda.util.Communication.info
 import com.lambda.util.DynamicReflectionSerializer.dynamicString
 import com.lambda.util.FolderRegister
+import com.lambda.util.FolderRegister.relativeMCPath
 import com.lambda.util.Formatting.getTime
 import com.lambda.util.text.*
 import kotlinx.coroutines.channels.BufferOverflow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import net.minecraft.network.packet.Packet
 import java.awt.Color
 import java.io.File
-import java.nio.file.Path
 import java.time.format.DateTimeFormatter
 import kotlin.io.path.pathString
 
@@ -83,7 +83,6 @@ object PacketLogger : Module(
         extraBufferCapacity = 1000,
         onBufferOverflow = BufferOverflow.DROP_OLDEST
     )
-    private val File.relativePath: Path get() = mc.runDirectory.toPath().relativize(toPath())
 
     init {
         runIO {
@@ -105,15 +104,14 @@ object PacketLogger : Module(
                     createNewFile()
                 }
                 val info = buildText {
-                    clickEvent(ClickEvents.openFile(relativePath.pathString)) {
+                    clickEvent(ClickEvents.openFile(relativeMCPath.pathString)) {
                         literal("Packet logger started: ")
                         color(Color.YELLOW) { literal(fileName) }
                         literal(" (click to open)")
                     }
                 }
                 this@PacketLogger.info(info)
             }.apply {
-                // ToDo: Add more rich and accurate data to the header
                 StringBuilder().apply {
                     appendLine(Communication.ascii)
                     appendLine("${Lambda.SYMBOL} - Lambda ${Lambda.VERSION} - Packet Log")
@@ -144,8 +142,8 @@ object PacketLogger : Module(
             file?.let {
                 val info = buildText {
                     literal("Stopped logging packets to ")
-                    clickEvent(ClickEvents.openFile(it.relativePath.pathString)) {
-                        color(Color.YELLOW) { literal(it.relativePath.pathString) }
+                    clickEvent(ClickEvents.openFile(it.relativeMCPath.pathString)) {
+                        color(Color.YELLOW) { literal(it.relativeMCPath.pathString) }
                         literal(" (click to open)")
                     }
                 }

common/src/main/kotlin/com/lambda/module/modules/player/MapDownloader.kt

@@ -21,8 +21,8 @@ import com.lambda.event.events.TickEvent
 import com.lambda.event.listener.SafeListener.Companion.listen
 import com.lambda.module.Module
 import com.lambda.module.tag.ModuleTag
+import com.lambda.util.FileUtils.locationBoundDirectory
 import com.lambda.util.FolderRegister
-import com.lambda.util.FolderRegister.locationBoundDirectory
 import com.lambda.util.StringUtils.hashString
 import com.lambda.util.player.SlotUtils.combined
 import com.lambda.util.world.entitySearch

common/src/main/kotlin/com/lambda/module/modules/player/Replay.kt

@@ -38,8 +38,8 @@ import com.lambda.sound.SoundManager.playSound
 import com.lambda.util.Communication.info
 import com.lambda.util.Communication.logError
 import com.lambda.util.Communication.warn
+import com.lambda.util.FileUtils.locationBoundDirectory
 import com.lambda.util.FolderRegister
-import com.lambda.util.FolderRegister.locationBoundDirectory
 import com.lambda.util.Formatting.asString
 import com.lambda.util.Formatting.getTime
 import com.lambda.util.KeyCode

common/src/main/kotlin/com/lambda/network/LambdaHttp.kt

@@ -34,11 +34,20 @@ val LambdaHttp = HttpClient {
     }
 }
 
-suspend inline fun HttpClient.download(url: String, file: File, block: HttpRequestBuilder.() -> Unit = {}) =
-    file.writeBytes(get(url, block).readRawBytes())
+suspend inline fun HttpClient.download(url: String, file: File, block: HttpRequestBuilder.() -> Unit = {}) {
+    val response = get(url, block)
+    check(response.status.isSuccess()) { "Download for $url failed with non 2xx status code" }
 
-suspend inline fun HttpClient.download(url: String, output: OutputStream, block: HttpRequestBuilder.() -> Unit = {}) =
-    output.write(get(url, block).readRawBytes())
+    file.writeBytes(response.readRawBytes())
+}
+
+suspend inline fun HttpClient.download(url: String, output: OutputStream, block: HttpRequestBuilder.() -> Unit = {}) {
+    val response = get(url, block)
+    check(response.status.isSuccess()) { "Download for $url failed with non 2xx status code" }
+
+    output.write(response.readRawBytes())
+}
 
 suspend inline fun HttpClient.download(url: String, block: HttpRequestBuilder.() -> Unit) =
     get(url, block).readRawBytes()
+

common/src/main/kotlin/com/lambda/network/api/v1/endpoints/GetCape.kt

@@ -31,7 +31,7 @@ import java.util.UUID
  * Example:
  *  - id: ab24f5d6-dcf1-45e4-897e-b50a7c5e7422
  *
- * response: [Cape] or error
+ * @return results of cape
  */
 suspend fun getCape(uuid: UUID) = runCatching {
 	LambdaHttp.get("$apiUrl/api/${apiVersion.value}/cape?id=$uuid").body<Cape>()

common/src/main/kotlin/com/lambda/network/api/v1/endpoints/LinkDiscord.kt

@@ -32,7 +32,7 @@ import io.ktor.http.*
  * Example:
  *  - token: OTk1MTU1NzcyMzYxMTQ2NDM4
  *
- * response: [Authentication] or error
+ * @return result of [Authentication]
  */
 suspend fun linkDiscord(discordToken: String) = runCatching {
 	LambdaHttp.post("${apiUrl}/api/${apiVersion.value}/link/discord") {

common/src/main/kotlin/com/lambda/network/api/v1/endpoints/Login.kt

@@ -32,7 +32,7 @@ import io.ktor.http.*
  *  - username: Notch
  *  - hash: 069a79f444e94726a5befca90e38aaf5
  *
- * response: [Authentication] or error
+ * @return result of [Authentication]
  */
 suspend fun login(username: String, hash: String) = runCatching {
 	LambdaHttp.post("${apiUrl}/api/${apiVersion.value}/login") {