箱庭3D地图

一个用于 Minecraft 1.20.1 / Forge 的交互式等距 3D 地图。按下 M 键，即可将你周围已加载的区块以可旋转、可缩放的立体模型形式呈现，渲染在 Minecraft 风格 GUI 内（泥土背景、内嵌视口边框、工具提示风格面板）。仅客户端——加入未安装本模组的原版或模组服务器也是安全的。

功能

• M 键（可重新绑定）打开全屏 3D 地图
• 已加载区块以立体模型形式渲染，使用原版地图颜色，并带有浮雕阴影、海拔色调和水深阴影
• 鼠标控制：拖动旋转（15 至 90 度倾斜），右键拖动 / Shift+拖动平移，滚轮缩放
• 投影切换（P）：等距（正交）或透视
• Y 轴切片滑块（也可用上下方向键和 PgUp/PgDn）：水平切割世界——切片至地下可显示洞穴横截面；下界会以屋顶下方预切片的状态打开
• 标记： 你 = 青色箭头 + 光柱，其他玩家 = 白色并带有名牌，敌对生物 = 红色，其他实体 = 黄色
• 悬停任一方柱可查看其坐标 / 方块 / 生物群系 / 区块；点击复制坐标（x y z，可直接粘贴到 /tp 命令中）
• 区块边界网格（G）、半径滑块（4-16 个区块，默认跟随你的渲染距离）、指南针、刷新（R）、Home 键重置视角
• 完全本地化为英语和日语

安装

将 hakoniwa-1.1.0.jar 放入任意 1.20.1 Forge 实例的 mods 文件夹中。进入世界后按下 M 键即可。无需在服务端安装。

配置文件（config/hakoniwa-client.toml）

选项	含义	默认值
maxRadiusChunks	半径滑块的上限	16
defaultRadiusChunks	打开时的半径；0 = 跟随渲染距离（上限为 12）	0
showEntities	打开时显示生物标记	true
orthographic	以等距投影启动	true
chunkGrid	打开时显示区块边界	true

已知限制

• 地形是打开地图时拍摄的快照（玩家/生物标记保持实时）。世界变化后请按 R 键刷新。
• 视图显示的是“从上方可见的内容”，除非使用 Y 轴切片——内部结构和悬挑部分只能通过切片显示。
• 客户端未加载的区块（例如服务器限制视距时）会显示为空洞。

---

日本語

プレイヤーの周りに読み込まれているチャンクを、アイソメトリック風の俯瞰3Dジオラマとして眺められるインタラクティブ3DマップMODです。Minecraft 1.20.1 / Forge 用、クライアント専用（サーバー側の導入は不要・どのサーバーに入っても安全）。GUIはバニラ準拠の見た目（設定画面と同じ土テクスチャ背景、インベントリ枠風の彫り込みビューポート、ツールチップ風の情報パネル）。

できること

• Mキー（変更可）で全画面の3Dマップを開く
• 読み込み済みチャンクが「箱庭（ジオラマ）」として表示される——色はバニラ地図と同じブロック色プラス起伏の陰影プラス高度による明暗、水は深さで色が変化
• マウス操作: ドラッグ＝回転（見下ろし角15°から真上90°）、右ドラッグ／Shift+ドラッグ＝平行移動、ホイール＝ズーム
• 投影切替（P）: アイソメ（等角・遠近感なし）⇔ 遠近
• 高度カット（Yスライス）: スライダーか上下矢印/PgUp/PgDn で世界を水平に輪切り。地下にスライスすると洞窟の床が断面として見える。ネザーでは最初から天井の下でカットされた状態で開く
• マーカー: 自分＝水色の矢印＋光の柱、他プレイヤー＝白（名前つき）、敵Mob＝赤、その他＝黄
• ホバーで座標・ブロック名・バイオーム・チャンク座標を表示、クリックで座標をコピー（x y z 形式、/tp にそのまま貼付可）
• チャンク境界グリッド（G）、範囲スライダー（半径4から16チャンク、初期値は描画距離連動）、コンパス、再読込（R）、Homeで視点リセット
• 日本語・英語 完全対応

導入

hakoniwa-1.1.0.jar を 1.20.1 Forge の mods フォルダに入れるだけ。ワールドに入って M キーで開きます。サーバー側の導入は不要です。

設定（config/hakoniwa-client.toml）

項目	意味	初期値
maxRadiusChunks	範囲スライダーの上限（チャンク）	16
defaultRadiusChunks	開いたときの半径。0=描画距離に追従（上限12）	0
showEntities	Mobマーカーを最初から表示	true
orthographic	最初からアイソメ投影	true
chunkGrid	最初からチャンク境界を表示	true

既知の割り切り

• 地形は開いた瞬間のスナップショット（プレイヤー・Mobマーカーは常にライブ）。地形が変わったら R で再読込。
• 表示は「上から見えている面」ベース——高度カットしない限り、洞窟や建物内部は映らない。
• 未読込チャンク（マルチで描画距離がサーバー制限される場合など）は穴として表示される。