mapsyncer-paper: server side of MapSyncer for Xaero's World Map, discovery-limited

Paper 26.2 plugin speaking the stock MapSyncer client mod's protocol. Renders Xaero region zips from the world's region files, but only for chunks players have actually been sent (PlayerChunkLoadEvent), seeded once from InhabitedTime. Shared or per-player visibility, background render cycle, per-player streaming with hash/timestamp skipping, Gitea Actions release workflow. Vendors the MCA parser and Xaero writer from upstream MapSyncer (GPL-3.0), see NOTICE.md. Claude-Session: https://claude.ai/code/session_011FePLXwBsCGLTzaSkk1Z6V
2026-09-07 00:04:43 +03:00
commit 7fb3a82482
67 changed files with 10934 additions and 0 deletions
@@ -0,0 +1,62 @@
+package com.mapsyncer.mca.convert.biome;
+
+import com.mapsyncer.mca.ChunkDataParser;
+import com.mapsyncer.mca.LightMode;
+import com.mapsyncer.mca.convert.model.MapRegionData;
+
+import static com.mapsyncer.mca.convert.model.ConvertConstants.CHUNKS_PER_REGION;
+import static com.mapsyncer.mca.convert.model.ConvertConstants.REGION_SIZE_BLOCKS;
+
+/**
+ * 扫描完成后填充 biome，对齐 Xaero fillBiomes（按 topHeight/height 采样）。
+ *
+ * <p>地表层：有扫描结果时用 heightMap；否则用高度图地表 Y。</p>
+ * <p>洞穴层：有扫描结果时用洞穴壁 Y；否则用 caveStart，且不回退到地表群系。</p>
+ */
+public final class BiomeFillPass {
+
+    private BiomeFillPass() {}
+
+    public static void fill(MapRegionData data) {
+        for (int rx = 0; rx < REGION_SIZE_BLOCKS; rx++) {
+            for (int rz = 0; rz < REGION_SIZE_BLOCKS; rz++) {
+                int chunkX = rx >> 4;
+                int chunkZ = rz >> 4;
+                if (chunkX >= CHUNKS_PER_REGION || chunkZ >= CHUNKS_PER_REGION) {
+                    continue;
+                }
+
+                ChunkDataParser.ChunkInfo chunk = data.chunkGrid[chunkX][chunkZ];
+                if (chunk == null) {
+                    continue;
+                }
+
+                int lx = rx & 0xF;
+                int lz = rz & 0xF;
+                int[][] heightmap = chunk.heightmap();
+
+                boolean caveMode = data.lightMode == LightMode.CAVE
+                    && data.caveParams.caveStart() != Integer.MAX_VALUE;
+
+                int sampleY;
+                if (data.hasData[rx][rz]) {
+                    sampleY = data.heightMap[rx][rz];
+                } else if (caveMode) {
+                    sampleY = data.caveParams.caveStart();
+                } else if (heightmap != null) {
+                    sampleY = heightmap[lx][lz];
+                    data.heightMap[rx][rz] = sampleY;
+                } else {
+                    continue;
+                }
+
+                String biome = caveMode
+                    ? BiomeQuartResolver.resolveAtY(chunk, lx, sampleY, lz)
+                    : BiomeQuartResolver.resolve(chunk, lx, sampleY, lz);
+                if (BiomeQuartResolver.isValidBiome(biome)) {
+                    data.biomeNames[rx][rz] = biome;
+                }
+            }
+        }
+    }
+}