帧映射 3D

🗺️ Frames Map 3D

物品展示框中的地图会以三维方式渲染周围的地形，就呈现在你眼前。


---

✨ 概述

Frames Map 3D 将一张普通的带框地图变成它所描绘之地的微型立体模型。地图的周围环境不再是平坦的绘制方块，而是真实的 3D 起伏——山丘从框中隆起，水面处于各自的高度，细节层次会随着你站立的距离平滑缩放。旋转一张带框地图，或将多张并排悬挂，地形会在各展示框之间无缝衔接，正如原版地图本身所做的那样。 这是 larsphp 所作 3D Maps（最初为 Fabric 模组）经授权的 NeoForge 移植版，由 Stalking Dragons 在原作者明确许可下移植到 NeoForge 1.21.1。渲染管线针对 1.21.1 的实际 API 从头重建（此 Minecraft 版本没有原模组所依赖的较新渲染状态架构），同时保持相同的外观和行为。除该许可外，与原作者无关联，亦未获其背书。

🎯 特性

🏔️ 每张带框地图中的 3D 地形

一旦地图被走过（或在服务器端捕获）并放入物品展示框，其周围环境便会使用地图自身的颜色数据渲染为真正的 3D 几何体——而非平坦的纹理——因此它始终与地图所显示的内容相匹配。

🌊 基于距离的细节层次

摄像机距离越远，网格细节会自动缩放降低，即使同时可见多张带框地图，也能保持较低的渲染开销。该缩放的激进程度可在游戏内设置界面中配置。

🏞️ 无缝的多框地形

属于同一地形的相邻带框地图会对齐边缘，包括水面边缘，因此一整墙的带框地图会呈现为一幅连续的地景，而非各自独立的图块。

⚙️ 游戏内设置

视频设置旁的设置按钮会打开一个专用于本模组客户端选项的界面（细节层次激进程度、启用/禁用 3D 渲染）。每张带框地图也有其各自的单框设置（3D 开/关、基础高度），可从地图本身进入。

🏠 兼容光影包

检测 Iris 是否正在渲染阴影通道，并在该通道中跳过 3D 网格，避免在光影包下出现双重变暗或重复的几何体。

🧱 模组结构

区域	提供的功能
Map3DVolume / Map3DSavedData	服务器端对地图周围 3D 地形数据的捕获与持久化存储。
Map3DServer / FramedMapServer	捕获调度与物品展示框交互处理（旋转、打开设置）。
Map3DMesh / Map3DRenderTypes	客户端网格构建及用于绘制它的自定义渲染管线。
ItemFrameMixin / ItemFrameRendererMixin / MapRendererMixin	挂钩原版物品展示框和地图渲染器，在可用时替换为 3D 网格。
FramedMapSettingsScreen / Map3DSettingsScreen	单框与全局设置界面。

📋 需求

Minecraft	1.21.1
NeoForge	21.1.249+
依赖项	无
侧	客户端和服务器（两端均需安装 3D 渲染才能工作；仅服务器端运行也安全，未安装的客户端只会看到平坦的原版地图）

🎮 使用方法

1. 为 Minecraft 1.21.1 安装 NeoForge 21.1.249 或更高版本。
2. 将 Frames Map 3D 放入 mods 文件夹——在服务器以及多人游戏中的每个客户端上均需安装。
3. 填充一张地图并将其放入物品展示框。给地形一点时间被捕获，它便会自动以 3D 方式渲染。
4. 从地图本身打开该地图的单框设置，或从选项 → 视频设置旁的按钮打开全局设置。

---

🙏 鸣谢与许可

Frames Map 3D 是 larsphp 所作 3D Maps（Fabric）经授权的 NeoForge 移植版，由 Stalking Dragons 在原作者明确许可下移植到 NeoForge 1.21.1，允许分叉并移植该模组。除该许可外，与原作者无关联，亦未获其背书。

许可： MIT，与 3D Maps 发布的许可相同。完整对应的源代码发布于 gitlab.com/stalking-dragons/minecraft/frames-map-3d。完整许可文本随 jar 发布（META-INF/LICENSE），并包含在仓库的 LICENSE/NOTICE 文件中。

https://codex.skdragons.com/

Codex Stalking Dragons — Minecraft Modding