merge: sync main (production client launch test + world screenshot, #22)

Keeps the multi-version Stonecutter build; the launch test itself is ported
to all supported Minecraft versions in the next commit. Takes main's client
gametest source (src/gametest) as-is.

Author: claude

README.md

@@ -1,9 +1,10 @@
 # BetterHUD Fabric Mod
-A simple HUD with essential information easily accessible for Minecraft Fabric. 
-
 [![Modrinth Downloads](https://img.shields.io/modrinth/dt/betterhudfabric?style=for-the-badge&logo=modrinth)
 ](https://modrinth.com/mod/betterhudfabric)
 
+A simple HUD with essential information easily accessible for Minecraft Fabric. 
+
+[Cloth Config](https://modrinth.com/mod/cloth-config), [Mod Menu](https://modrinth.com/mod/modmenu), and [Fabric API](https://modrinth.com/mod/fabric-api) are also required.
 
 ![Picture of HUD](https://cdn.modrinth.com/data/cached_images/4dd33c9ed510e100af5cc442eb93092624856ba5.png)
 

src/gametest/java/dsns/betterhud/gametest/BetterHudClientGameTest.java

@@ -0,0 +1,39 @@
+package dsns.betterhud.gametest;
+
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestSingleplayerContext;
+import net.minecraft.client.gui.screens.worldselection.WorldCreationUiState;
+
+@SuppressWarnings("UnstableApiUsage")
+public class BetterHudClientGameTest implements FabricClientGameTest {
+	@Override
+	public void runTest(ClientGameTestContext context) {
+		assertScreenshotSaved(context.takeScreenshot("betterhud-title-screen"));
+
+		try (TestSingleplayerContext singleplayer = context.worldBuilder()
+				.adjustSettings(creator -> creator.setGameMode(WorldCreationUiState.SelectedGameMode.SURVIVAL))
+				.create()) {
+			singleplayer.getClientLevel().waitForChunksRender();
+
+			// Let the world tick a little with the HUD rendering before capturing evidence.
+			context.waitTicks(40);
+			assertScreenshotSaved(context.takeScreenshot("betterhud-survival-world"));
+		}
+	}
+
+	private static void assertScreenshotSaved(Path screenshot) {
+		try {
+			if (!Files.isRegularFile(screenshot) || Files.size(screenshot) == 0) {
+				throw new AssertionError("Screenshot was not saved: " + screenshot);
+			}
+		} catch (IOException e) {
+			throw new UncheckedIOException("Could not verify screenshot " + screenshot, e);
+		}
+	}
+}

src/gametest/resources/fabric.mod.json

@@ -0,0 +1,16 @@
+{
+	"schemaVersion": 1,
+	"id": "betterhud-gametest",
+	"version": "1.0.0",
+	"name": "BetterHUD GameTest",
+	"description": "Client gametests for BetterHUD.",
+	"license": "AGPL-3.0",
+	"environment": "client",
+	"entrypoints": {
+		"fabric-client-gametest": ["dsns.betterhud.gametest.BetterHudClientGameTest"]
+	},
+	"depends": {
+		"betterhud": "*",
+		"fabric-client-gametest-api-v1": "*"
+	}
+}