Frames Map 3D

v0.0.0-beta.1 — Initial 1.21.1 beta release

Authorized fork/port of 3D Maps v0.8.2 (Fabric) by larsphp to NeoForge 21.1.249 / Minecraft 1.21.1. The original author explicitly authorized this fork.

Feature

• Item-framed maps render the surrounding terrain in real 3D, with distance-based level of detail
• Adjacent framed maps line up their terrain (including water edges) across frames
• Per-frame settings screen (3D on/off, start height) and a global settings screen reachable from Options → next to Video Settings
• Shader-pack aware: skips the 3D mesh during Iris shadow passes

Technical Changes

• Server-side: Map3DSavedData/Map3DVolume (terrain capture and storage), Map3DServer (capture scheduling), FramedMapServer (frame interaction), 6 network payloads (NeoForge RegisterPayloadHandlersEvent/PayloadRegistrar), common mixins ItemFrameMixin/MapItemMixin
• Client-side: Map3DMesh (mesh builder, ported near-verbatim), Map3DRenderTypes (rebuilt on the classic 1.21.1 RenderType.create/CompositeState API — the original's newer RenderPipeline-based approach doesn't exist in this Minecraft version), Map3DShaderCompat, ItemFrameRendererMixin/MapRendererMixin (rebuilt around a small static bridge, since 1.21.1 has no equivalent to the original's render-state architecture)
• License: MIT, matching the upstream 3D Maps license. Full attribution and the fork-authorization record in NOTICE

Notes

Install on both client and server for full 3D rendering (server-only is safe: clients without the mod just see the flat vanilla map). Verified: ./gradlew build, ./gradlew runServer (boots to Done, mixins apply, 0 errors) and ./gradlew runClient (all three client mixins apply cleanly, no crash). Visual in-game verification of the 3D rendering itself is still pending.

JAR: frames_map_3d-1.21.1-neoforge-21.1.249-0.0.0-beta.1.jar

Tag: 1.21.1-neoforge-beta.1