{"url":"https://levimc.org/mods/github.com/CoralFans-Dev/CoralMap/","id":"github.com/CoralFans-Dev/CoralMap","name":"CoralMap","description":"CoralFans' map mod","owner":"CoralFans-Dev","logo":"https://raw.githubusercontent.com/CoralFans-Dev/CoralFans-doc/refs/heads/main/docs/icon.png","repository":"https://github.com/CoralFans-Dev/CoralMap","issues":"https://github.com/CoralFans-Dev/CoralMap/issues","releases":"https://github.com/CoralFans-Dev/CoralMap/releases","stars":4,"downloads":290,"updated":"2026-09-26T15:02:07Z","published":"2026-09-26T05:49:13Z","created":"2026-06-24T06:55:23Z","license":"CC0-1.0","side":["client"],"platform":["win-x64"],"gameVersions":["1.26.51"],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"client","version":"26.51.1","install":"lip install github.com/CoralFans-Dev/CoralMap#client@26.51.1"},"readmes":[{"file":"README.md","lang":"en","text":"# CoralMap\n\n[简体中文](README_zh.md) | English\n\nA minimap / world map mod for Minecraft Bedrock (Windows client) powered by [LeviLamina](https://github.com/LiteLDev/LeviLamina). It draws through a DirectX 11 hook with an ImGui overlay and is client-side only.\n\n## Showcase\n\n![World map with biome-based terrain coloring and hill shadows](resource/showcase/showcase1.png)\n\n![Desert island with long shadow-map shadows at high zoom](resource/showcase/showcase2.png)\n\n![Zoomed-out overview of explored regions](resource/showcase/showcase3.png)\n\n## Features\n\n- **Minimap**: circular minimap at the top-right corner showing surrounding terrain, chunk grid lines, the current chunk highlighted, a player heading arrow, and coordinates — with configurable size, margins, and colors\n- **World map**: toggled with the `M` key (rebindable), scroll-wheel zoom (0.2–40 px/block), drag-to-pan; rendered as per-region (256×256 blocks) textures composited via ImGui, with idle-texture VRAM reclamation\n- **Terrain coloring**: biome-based colors loaded from `resource/biome_color.json`, falling back to in-game biome sampling when unavailable; transparent water that turns more opaque with depth\n- **Shadow rendering**: three modes — none / simple heightmap gradient / shadow map with edge bevel — plus PCF soft shadows and a configurable fixed light direction (northwest azimuth, 60° zenith by default)\n- **Smooth camera**: spring-damper smoothed following, with adjustable stiffness and damping\n- **Background terrain scanning**: small per-frame batches to avoid stutters (32 chunks/frame, 128-block radius by default), periodic rescans, region-level baking when too many chunks are dirty, and a LevelDB disk cache\n\n## Configuration\n\nA `config.json` is generated in the mod's config directory on first load. Common options:\n\n| Option | Description |\n| --- | --- |\n| `worldMap.toggleKey` | Key to toggle the world map (Win32 virtual-key code; `0x4D` = `M` by default) |\n| `miniMap.sizeRatio` / `radiusChunks` | Minimap diameter as a fraction of window width / chunk radius shown |\n| `terrain.scanRadius` / `scanMaxChunksPerFrame` | Scan radius in blocks / max chunks scanned per frame |\n| `terrain.enableDiskCache` | Enable the disk cache |\n| `terrain.shadow.*` | Shadow mode, strength, softening radius, light direction |\n| `fontSize` | UI font size |\n\n## Building\n\nDependencies: xmake, Visual Studio (clang-cl toolchain), LeviLamina client and its xmake-repo.\n\n```bash\nxmake f -y -p windows -a x64 -m release\nxmake\n```\n\nAfter a successful build, the mod is packed into `bin/CoralMap/` (including `CoralMap.dll`, `manifest.json`, and the `resource/` assets).\n\n## Installation\n\nCopy the whole `bin/CoralMap` folder into the `mods/` directory of your LeviLamina client installation and start the game.\n\n## Project Structure\n\n```\nsrc/\n├── mod/     Entry point (CoralMap class, mod registration, memory operators)\n├── render/  Minimap / world map renderers\n├── state/   Core state: terrain scanning, chunk management, coloring, shadow rendering\n├── data/    Chunk / region data structures, memory and disk caches\n├── helper/  DX11 hook, game event hooks, input blocking\n└── config/  Configuration definitions\n```\n\n## Contributing\n\nQuestions are welcome via issues; PRs accepted.\n\n## License\n\nCC0-1.0 © CoralMap contributors\n"},{"file":"README_zh.md","lang":"zh-Hans","text":"# CoralMap\n\nEnglish | [简体中文](README_zh.md)\n\n基于 [LeviLamina](https://github.com/LiteLDev/LeviLamina) 的 Minecraft 基岩版（Windows 客户端）小地图 / 大地图 mod。通过 DirectX 11 钩子接入游戏渲染，使用 ImGui 绘制地图界面，仅客户端生效。\n\n## 效果展示\n\n![群系地形着色与山地阴影](resource/showcase/showcase1.png)\n\n![高倍缩放下的沙漠岛屿与长阴影](resource/showcase/showcase2.png)\n\n![大地图缩放总览](resource/showcase/showcase3.png)\n\n## 功能特性\n\n- **小地图**：屏幕右上角圆形小地图，显示周围地形、区块网格线、当前区块高亮、玩家朝向箭头与坐标，尺寸 / 边距 / 配色均可配置\n- **大地图**：按 `M` 键开合（可在配置中改键），滚轮缩放（0.2 ~ 40 像素/方块）、鼠标拖拽平移；以 region（256×256 方块）为单位分块纹理拼贴渲染，并带 VRAM 闲置回收\n- **地形着色**：按群系着色，颜色表来自 `resource/biome_color.json`，加载失败时自动回退到游戏内群系采样；支持透明水体效果（随水深增加不透明度）\n- **阴影渲染**：三种模式——无阴影 / 简单高度图梯度阴影 / 阴影图 + 边缘 bevel，支持 PCF 柔化与固定光源方向（默认西北方向、天顶角 60°）\n- **平滑相机**：弹簧-阻尼平滑跟随，力度与阻尼可调\n- **后台地形扫描**：分帧扫描避免卡顿（默认每帧最多 32 chunk、半径 128 方块），按帧间隔自动重扫，脏块过多时切换为 region 级烘焙，支持 LevelDB 磁盘缓存\n\n## 配置\n\n首次加载后会在 mod 配置目录生成 `config.json`，常用项：\n\n| 配置 | 说明 |\n| --- | --- |\n| `worldMap.toggleKey` | 大地图开合按键（Win32 虚拟键码，默认 `0x4D` 即 `M`） |\n| `miniMap.sizeRatio` / `radiusChunks` | 小地图直径占窗口宽度比例 / 显示区块半径 |\n| `terrain.scanRadius` / `scanMaxChunksPerFrame` | 扫描半径（方块）/ 每帧扫描 chunk 上限 |\n| `terrain.enableDiskCache` | 是否启用磁盘缓存 |\n| `terrain.shadow.*` | 阴影模式、强度、柔化半径、光源方向 |\n| `fontSize` | 界面字号 |\n\n## 构建\n\n依赖：xmake、Visual Studio（clang-cl 工具链）、LeviLamina 客户端版及其 xmake-repo。\n\n```bash\nxmake f -y -p windows -a x64 -m release\nxmake\n```\n\n构建成功后，mod 会打包到 `bin/CoralMap/`（含 `CoralMap.dll`、`manifest.json` 与 `resource/` 资源）。\n\n## 安装\n\n将 `bin/CoralMap` 整个文件夹复制到 LeviLamina 客户端的 `mods/` 目录，启动游戏即可。\n\n## 项目结构\n\n```\nsrc/\n├── mod/     入口（CoralMap 类、mod 注册、内存操作符）\n├── render/  小地图 / 大地图渲染器\n├── state/   地形扫描、区块管理、着色、阴影渲染等核心状态\n├── data/    区块 / region 数据结构与内存、磁盘缓存\n├── helper/  DX11 钩子、游戏事件钩子、输入拦截\n└── config/  配置定义\n```\n\n## Contributing\n\n欢迎通过 issue 提问、通过 PR 贡献代码。\n\n## License\n\nCC0-1.0 © CoralMap contributors\n"}],"gallery":[],"versions":[{"version":"26.51.1","prerelease":false,"released":"2026-09-26T15:02:07Z","releaseUrl":"https://github.com/CoralFans-Dev/CoralMap/releases/tag/v26.51.1","manifestUrl":"https://github.com/CoralFans-Dev/CoralMap/blob/v26.51.1/tooth.json","info":{"name":"CoralMap","description":"CoralFans' map mod","tags":["platform:levilamina","type:mod"],"logo":"https://raw.githubusercontent.com/CoralFans-Dev/CoralFans-doc/refs/heads/main/docs/icon.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":">=26.51.0 <26.52.0"}}]}},{"version":"26.51.0","prerelease":false,"released":"2026-09-26T05:49:13Z","releaseUrl":"https://github.com/CoralFans-Dev/CoralMap/releases/tag/v26.51.0","manifestUrl":"https://github.com/CoralFans-Dev/CoralMap/blob/v26.51.0/tooth.json","info":{"name":"CoralMap","description":"CoralFans' map mod","tags":["platform:levilamina","type:mod"],"logo":"https://raw.githubusercontent.com/CoralFans-Dev/CoralFans-doc/refs/heads/main/docs/icon.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":">=26.51.0 <26.52.0"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}