2.7 KiB
Files shared between development machines
Commit these website assets together with the source code:
public/images/example-map.webp— homepage illustration and map-card fallback.public/tools/mod/minegeo-fabric-1.21.11-0.1.3.jar— Java 21 Fabric mod.public/tools/mod/minegeo-fabric-26.1-0.1.3.jar— Java 25 Fabric mod for 26.1.public/tools/mod/minegeo-fabric-26.2-0.1.3.jar— Java 25 Fabric mod for 26.2.public/tools/plugin/minegeo-plugin-0.1.3.jar— Bukkit/Paper plugin for all three.
Next.js serves these directly under /images/ and /tools/. The download page
uses versioned filenames to avoid stale downloads. Unversioned 1.21.11 URLs
remain updated compatibility copies. These assets are deliberately tracked, so a
fresh checkout on macOS has the homepage image and all download buttons without
building Minecraft tools or running the renderer proof.
After changing the Java source, run npm run java:build with Java 25 selected
as JAVA_HOME, and Java 21 available for the older mod and plugin toolchains.
Gradle builds the older Yarn-based mod and both separate Mojang-named 26.x mods.
On Windows/OneDrive, set MINEGEO_JAVA_BUILD_ROOT to a local temporary directory
to keep generated Gradle output outside synced folders.
The build copies the new JARs into public/tools/; commit those updated files too.
Gradle caches, intermediate build output, and generated test panoramas remain
ignored. The JARs contain Java bytecode and work across Windows, macOS, and Linux.
On the Mac, pull the commit, run npm install, and restart the development
server. For a production server, run npm run build and then npm start.
Keep that machine's Supabase credentials in its own .env.local.
Both tools connect to https://minegeo.vercel.app without URL setup. The mod
still stores its contributor token and selected map locally; the plugin retains
its contributor token, Minecraft connection address, and export settings.
The website accepts 1.21.11 and 26.1/26.2 capture manifests. The updated worker selects and verifies vanilla models/textures for each export's version. Restart the terrain rendering worker on its existing host after updating these source files. Vercel includes processing for the mod's captured PNGs; plugin terrain rendering still runs on that separate worker host.
Verification commands:
Select Java 25 in JAVA_HOME for the Paper matrix. It checks 1.21.11, the
maintained 26.1.2 release of the 26.1 family, and 26.2 without launching a game
client. Fabric builds are compile-checked; client capture was not runtime-tested.
node scripts/test-minecraft-versions.mjs: local Paper command/export matrix.node scripts/test-renderer.mjs --fixture 26.1(or26.2): versioned rendering.