Added Directional Arrow + Other Fixes

Author: cev-api

README.md

@@ -6,14 +6,12 @@ Original Repo: https://github.com/xpple/SeedMapper/
 
 This project is a friendly, independent fork of Seedmapper. I have not proposed any improvements or features to the upstream but I am welcome to them incorporating my changes. I will sporatically maintain this project and re-base/sync with the upstream project.
 
-## Installation and pre-requisites
+## Compiling 
 
-See original [repo](https://github.com/xpple/SeedMapper) for the project. A precompiled version of my fork will be made available for download.
+Original instructions do not apply. Clone and compile as normal. I have included the Cubiome and JExtract files already.
 
 ## Improvements
 
-![Screenshot](https://i.imgur.com/m1lzryd.png)
-
 ### Java 21
 Project now builds against Java 21 LTS, however, Minecraft/Fabric must have the flag ```--enable-preview``` added to the Java arguments. 
 
@@ -22,17 +20,26 @@ This tells the JVM to accept preview bytecode and APIs. Functionally nothing els
 ![Flag](https://i.imgur.com/rOsP2H0.png)
 
 ### Zoom
-Zoom further out on the SeedMap
+Zoom further out on the SeedMap. Limited to approx 30,000x30,000. I suggest enabling the clear cache setting below.
+
+![Zoomies](https://i.imgur.com/utIgDkp.png)
+
+### Directional Arrow
+Around your player icon in the SeedMap there will be a little arrow showing you which direction you're facing. This is toggleable with ```/sm:config ShowPlayerDirectionArrow```.
+
+![Arrow](https://i.imgur.com/pkodE8d.png)
 
 ### Memory Handling
-Added a config option ```/sm:config ClearSeedMapCachesOnClose``` to clear tiles, per‑world locations and any other relevant caches. When enabled, this prevents FPS dips from garbage collection on large caches after zooming out far and then closing the map.
+Added a config option ```/sm:config ClearSeedMapCachesOnClose``` to clear tiles, per‑world locations and any other relevant caches. When enabled, this prevents FPS dips from garbage collection on large caches after zooming out far and then closing the map. Opening the map again will result it in being loaded like its the first time, at smaller zoom levels this isn't a problem.
 
 ### Icon Text
 When hovering over location icons in the SeedMap it will display text telling you what the locations are.
 
+![Text](https://i.imgur.com/A5gCXgP.png)
+
 ### Added Elytra/End Ship Locations
 Can now find Elytra via locating End Ships with the locate command ```/sm:locate feature end_city_ship``` or simply selecting the Elytra icon in the SeedMap
-This has now been implemented by upstream. I have however kept my original Elytra icon, because we aren't going to the ships for anything else are we?
+This has now been implemented by upstream. They have unified both End City Ships and End Cities together. I have utilised their change but kept my original Elytra icon, because we aren't going to the ships for anything else are we?
 
 ### Export SeedMap
 - Added **Export JSON** button on the top right of the SeedMap screen which will export all selected locations to a JSON
@@ -44,6 +51,8 @@ Configurable ESP settings allowing for custom colors, fill (imperfect) and trans
 
 Example: ```/sm:config blockhighlightesp set outlineColor #ff0000 outlineAlpha 0.5 fillEnabled true fillColor #00ff00 fillAlpha 0.35```
 
+![ESP](https://i.imgur.com/S9KeYpR.png)
+
 ### Highlight Timeout Setting
 
 Can now change the default 5 minute render timeout with ```/sm:config esptimeout```

src/main/java/dev/xpple/seedmapper/config/Configs.java

@@ -63,6 +63,13 @@ private static void setPixelsPerBiome(double pixelsPerBiome) {
         PixelsPerBiome = Math.clamp(pixelsPerBiome, SeedMapScreen.MIN_PIXELS_PER_BIOME, SeedMapScreen.MAX_PIXELS_PER_BIOME);
     }
 
+    @Config(comment = "getPlayerDirectionArrowComment")
+    public static boolean ShowPlayerDirectionArrow = true;
+
+    private static Component getPlayerDirectionArrowComment() {
+        return Component.translatable("config.showPlayerDirectionArrow.comment");
+    }
+
     @Config(chatRepresentation = "listToggledFeatures")
     public static EnumSet<MapFeature> ToggledFeatures = Util.make(() -> {
         EnumSet<MapFeature> toggledFeatures = EnumSet.allOf(MapFeature.class);

src/main/java/dev/xpple/seedmapper/seedmap/SeedMapScreen.java

@@ -89,9 +89,11 @@
 import net.minecraft.world.level.levelgen.PositionalRandomFactory;
 import net.minecraft.world.level.levelgen.WorldgenRandom;
 import net.minecraft.world.level.levelgen.XoroshiroRandomSource;
+import net.minecraft.world.phys.Vec3;
 import org.jetbrains.annotations.Nullable;
 import org.slf4j.Logger;
 import org.joml.Matrix3x2f;
+import org.joml.Matrix3x2fStack;
 import org.joml.Vector2i;
 
 import java.lang.foreign.Arena;
@@ -209,6 +211,13 @@ public class SeedMapScreen extends Screen {
         return new Vector2i(x, y);
     };
 
+    private static final ResourceLocation PLAYER_DIRECTION_ARROW_TEXTURE = ResourceLocation.fromNamespaceAndPath(SeedMapper.MOD_ID, "textures/feature_icons/arrow.png");
+    private static final int PLAYER_DIRECTION_ARROW_TEXTURE_WIDTH = 100;
+    private static final int PLAYER_DIRECTION_ARROW_TEXTURE_HEIGHT = 101;
+    private static final double PLAYER_DIRECTION_ARROW_DRAW_HEIGHT = 12.0D;
+    private static final double PLAYER_DIRECTION_ARROW_TIP_OFFSET = 15.0D;
+    private static final double PLAYER_DIRECTION_ARROW_PIVOT_Y = 99.0D;
+
     private static int tileSizePixels() {
         double baseSize = TilePos.TILE_SIZE_CHUNKS * (double) SCALED_CHUNK_SIZE;
         double pixelsPerBiome = Math.max(MIN_PIXELS_PER_BIOME, Configs.PixelsPerBiome);
@@ -527,16 +536,6 @@ public void render(GuiGraphics guiGraphics, int mouseX, int mouseY, float partia
             });
         }
 
-        // draw player position
-        QuartPos2f relPlayerQuart = QuartPos2f.fromQuartPos(QuartPos2.fromBlockPos(this.playerPos)).subtract(this.centerQuart);
-        int playerMinX = this.centerX + Mth.floor(Configs.PixelsPerBiome * relPlayerQuart.x()) - 10;
-        int playerMinY = this.centerY + Mth.floor(Configs.PixelsPerBiome * relPlayerQuart.z()) - 10;
-        int playerMaxX = playerMinX + 20;
-        int playerMaxY = playerMinY + 20;
-        if (playerMinX >= HORIZONTAL_PADDING && playerMaxX <= HORIZONTAL_PADDING + this.seedMapWidth && playerMinY >= VERTICAL_PADDING && playerMaxY <= VERTICAL_PADDING + this.seedMapHeight) {
-            PlayerFaceRenderer.draw(guiGraphics, this.minecraft.player.getSkin(), playerMinX, playerMinY, 20);
-        }
-
         // calculate spawn point
         if (this.toggleableFeatures.contains(MapFeature.WORLD_SPAWN) && Configs.ToggledFeatures.contains(MapFeature.WORLD_SPAWN)) {
             BlockPos spawnPoint = spawnDataCache.computeIfAbsent(this.worldIdentifier, ignored -> this.calculateSpawnData());
@@ -548,6 +547,19 @@ public void render(GuiGraphics guiGraphics, int mouseX, int mouseY, float partia
             FeatureWidget.drawFeatureIcon(guiGraphics, this.markerWidget.featureTexture, this.markerWidget.x, this.markerWidget.y, -1);
         }
 
+        // draw player position last so it always appears on top
+        QuartPos2f relPlayerQuart = QuartPos2f.fromQuartPos(QuartPos2.fromBlockPos(this.playerPos)).subtract(this.centerQuart);
+        int playerMinX = this.centerX + Mth.floor(Configs.PixelsPerBiome * relPlayerQuart.x()) - 10;
+        int playerMinY = this.centerY + Mth.floor(Configs.PixelsPerBiome * relPlayerQuart.z()) - 10;
+        int playerMaxX = playerMinX + 20;
+        int playerMaxY = playerMinY + 20;
+        if (playerMinX >= HORIZONTAL_PADDING && playerMaxX <= HORIZONTAL_PADDING + this.seedMapWidth && playerMinY >= VERTICAL_PADDING && playerMaxY <= VERTICAL_PADDING + this.seedMapHeight) {
+            PlayerFaceRenderer.draw(guiGraphics, this.minecraft.player.getSkin(), playerMinX, playerMinY, 20);
+            if (Configs.ShowPlayerDirectionArrow) {
+                this.drawPlayerDirectionArrow(guiGraphics, playerMinX, playerMinY, partialTick);
+            }
+        }
+
         // draw chest loot widget
         if (this.chestLootWidget != null) {
             this.chestLootWidget.render(guiGraphics, mouseX, mouseY, this.font);
@@ -1435,6 +1447,47 @@ private boolean handleMapFeatureLeftClicked(MouseButtonEvent mouseButtonEvent, b
         return true;
     }
 
+    private void drawPlayerDirectionArrow(GuiGraphics guiGraphics, int playerMinX, int playerMinY, float partialTick) {
+        LocalPlayer player = this.minecraft.player;
+        if (player == null) {
+            return;
+        }
+        Vec3 look = player.getViewVector(partialTick);
+        double dirX = look.x;
+        double dirZ = look.z;
+        double length = Math.hypot(dirX, dirZ);
+        if (length < 1.0E-4D) {
+            return;
+        }
+        double normX = dirX / length;
+        double normZ = dirZ / length;
+
+        double centerX = playerMinX + 10.0D;
+        double centerY = playerMinY + 10.0D;
+        double iconHalf = 10.0D;
+
+        double arrowScale = PLAYER_DIRECTION_ARROW_DRAW_HEIGHT / PLAYER_DIRECTION_ARROW_TEXTURE_HEIGHT;
+        double pivotToTip = PLAYER_DIRECTION_ARROW_PIVOT_Y * arrowScale;
+        double desiredTipDistance = iconHalf + PLAYER_DIRECTION_ARROW_TIP_OFFSET;
+        double pivotDistance = Math.max(0.0D, desiredTipDistance - pivotToTip);
+        double pivotX = centerX + normX * pivotDistance;
+        double pivotY = centerY + normZ * pivotDistance;
+
+        float angle = (float) Math.atan2(normX, -normZ);
+
+        Matrix3x2fStack poseStack = guiGraphics.pose();
+        poseStack.pushMatrix();
+        poseStack.translate((float) pivotX, (float) pivotY);
+        poseStack.rotate(angle);
+        poseStack.scale((float) arrowScale, (float) arrowScale);
+        poseStack.translate(-PLAYER_DIRECTION_ARROW_TEXTURE_WIDTH / 2.0F, (float) -PLAYER_DIRECTION_ARROW_PIVOT_Y);
+
+        GpuTextureView gpuTextureView = Minecraft.getInstance().getTextureManager().getTexture(PLAYER_DIRECTION_ARROW_TEXTURE).getTextureView();
+        BlitRenderState renderState = new BlitRenderState(RenderPipelines.GUI_TEXTURED, TextureSetup.singleTexture(gpuTextureView), new Matrix3x2f(poseStack), 0, 0, PLAYER_DIRECTION_ARROW_TEXTURE_WIDTH, PLAYER_DIRECTION_ARROW_TEXTURE_HEIGHT, 0, 1, 0, 1, -1, guiGraphics.scissorStack.peek());
+        guiGraphics.guiRenderState.submitBlitToCurrentLayer(renderState);
+        poseStack.popMatrix();
+    }
+
     private boolean hasEndCityShip(BlockPos pos) {
         int biome = Cubiomes.getBiomeAt(this.biomeGenerator, BIOME_SCALE, QuartPos.fromBlock(pos.getX()), QuartPos.fromBlock(320), QuartPos.fromBlock(pos.getZ()));
         try (Arena tempArena = Arena.ofConfined()) {

src/main/resources/assets/seedmapper/lang/en_us.json

@@ -96,6 +96,7 @@
   "config.oreAirCheck.comment": "Whether or not SeedMapper should use in-game air checks to invalidate ore positions.",
   "config.devMode.comment": "Enables certain debug commands.",
   "config.clearSeedMapCachesOnClose.comment": "If enabled, closing the seed map frees all cached tiles and structures immediately instead of keeping them for faster re-open.",
+  "config.showPlayerDirectionArrow.comment": "Draws a small arrow outside your icon to show the direction you're facing on the seed map.",
   "config.blockHighlightEsp.comment": "Controls the ESP colors used for highlighted block clusters.",
   "config.oreVeinEsp.comment": "Controls the ESP colors used for ore vein highlights.",
   "config.terrainEsp.comment": "Controls the ESP colors used for terrain outlines.",