v0.5.7-mc26.51

ChiyanMap Changelog

🌟 New Features & Ecosystem Compatibility

• Full Support for BetterRenderDragon (BRD):
  • Achieved deep coexistence and synergy with BetterRenderDragon, enabling both graphics mods to load and run simultaneously.
  • Fully compatible with third-party shader resource packs powered by BetterRenderDragon, automatically reloading and applying shader materials upon entering a world.

⚙️ Architecture & Stability Upgrades

• Graphics Rendering Hook Refactoring:
  • Adopted SafetyHook to manage the DXGI SwapChain hooks under the hood, optimizing chained invocations and rendering interoperability in multi-mod environments.
  • Enhanced graphics context lifecycle management and exception guards, boosting overall stability during gameplay and shutdown.

ChiyanMap 更新日志

🌟 新增特性与生态兼容

• 全面支持 BetterRenderDragon (BRD)：
  • 实现与 BetterRenderDragon 的深度协同共存，支持两大图形模组同时加载运行。
  • 完美兼容基于 BetterRenderDragon 的各类第三方光影资源包，进入世界时自动协同重载并呈现光影材质。

⚙️ 底层架构与稳定性升级

• 图形渲染挂钩重构：
  • 底层引入 SafetyHook 接管 DXGI 交换链，优化多模组环境下的链式调用与渲染协同能力。
  • 增强图形上下文生命周期管理与异常防护，进一步提升整体运行与关闭退出阶段的健壮性。

v0.5.6-mc26.51

Changelog

💡 Input Experience & Native IME Support

• In-Place Multilingual Text Input: Full support for typing Chinese, full-width, and special characters directly within all text input fields, eliminating the need for pencil icon buttons or external native input popups.
• Smart IME Candidate Positioning: The IME candidate window dynamically aligns with the active text input cursor position, delivering a natural, seamless typing experience.
• Streamlined UI: Removed auxiliary pencil edit buttons for a cleaner, more consistent visual style across all input fields.

🎮 Controls & Cursor Experience Improvements

• Screen Cursor Position Memory & Restoration (Vanilla-Authentic):
  • Automatically remembers and precisely restores the last hovered cursor position when opening the native inventory (E), containers (chests, barrels, shulker boxes, etc.), crafting tables, furnaces, chat screen (T), pause menu (ESC), or mod dialogs, matching vanilla Minecraft behavior.
  • The fullscreen world map retains its own independent cursor position memory, ensuring map exploration does not interfere with slot positions in the inventory.
• Windowed Fullscreen Crosshair Edge Protection: During first-person crosshair gameplay, the hardware cursor is securely locked to a small safe area at the center of the screen, completely preventing accidental cursor drift to window edges that could trigger minimize/close buttons or the system taskbar in windowed or borderless fullscreen modes.
• Streamlined World Map Controls: Removed the left double-click action on the fullscreen map to open the waypoint creation window, preventing accidental triggers during rapid clicking or box selection.

🎨 UI & Layout Improvements

• Adaptive Seed Map Legend Layout: Optimized docking and layer hierarchy of the seed map legend panel to ensure it no longer overlaps or blocks the zoom buttons in the bottom-right corner.
• UI Scaling Safeguards: Added a minimum 0.50x bound for global UI scaling along with convenient scale reset options.

⚡ World Map Rendering & Performance Optimizations

• Dynamic Motion Sensing & Microsecond Frame Budgeting:
  • Implemented dynamic motion sensing for panning and rapid mouse wheel / button zooming.
  • Enforced a strict texture generation time budget (under 0.5ms during active motion, 3.5ms when idle), completely eliminating frame drops and stuttering during large-scale zooming and viewport dragging.
• Quadtree Pyramid Draw Call Reduction: In multi-level branch pyramid rendering, redundant draw calls and texture bindings for leaf regions are automatically skipped when their parent branch texture is already rendered, significantly reducing GPU rasterization and DirectX overhead over large viewing areas.
• Zero-Lock Dirty Branch Versioning: Introduced an atomic versioning snapshot mechanism, achieving zero mutex locks across hundreds of branches in view and eliminating render thread lock contention.
• Branchless CPU Terrain Shading Pipeline: Decoupled boundary pixels from the core interior region to process 99.2% of pixels via a branchless shader pipeline, improving CPU terrain shading speed by 4x–5x.

🗺️ Terrain Scanning & Cache Enhancements

• Instant Frame-0 Presentation & Persistence: The player's current center chunk is instantly rendered and committed to disk cache at frame 0, eliminating black block delays upon entering worlds or teleporting.
• Dual-Channel Incremental Rendering & Background Persistence: Delivers high-frequency frontend rendering (12 updates per second) coupled with stable asynchronous disk cache writes, balancing millisecond-level responsiveness with persistent map browsing.

更新日志

💡 输入体验与原生输入法（IME）支持

• 原位多语言文本输入：所有文本输入框全面支持中文、全角及特殊字符直接原位输入，不再依赖铅笔图标按钮或外部弹出原生输入窗。
• 输入法候选框智能跟随：输入法候选窗口自适应对齐当前激活文本框的光标位置，带来自然流畅的沉浸式打字体验。
• 界面精简统一：移除了原有的辅助铅笔编辑按钮，输入组件视觉风格更整洁统一。

🎮 操作交互与光标体验优化

• 界面光标记忆与还原（原生行为体验）：
  • 打开原生物品栏（E 键）、容器（箱子/木桶/潜影盒等）、工作台、熔炉、聊天栏（T 键）、暂停菜单（ESC 键）或各类模组弹窗时，自动记住并精准还原上次光标悬停的位置，完美贴合原版操作习惯。
  • 全屏大地图拥有独立的光标坐标记忆体系，在大地图上的自由浏览探索不会干扰物品栏等界面中的光标槽位位置。
• 窗口化全屏准星防误触保护：第一人称十字准星游玩状态下，系统硬件光标被安全锁定在游戏画面中心的安全微区内，彻底杜绝窗口化全屏或窗口模式下光标无意漂移至屏幕边缘触发右上角最小化/关闭按钮或底部系统任务栏的问题。
• 大地图操作精简：移除了大地图鼠标左键双击打开路径点创建界面的功能，避免快速点击浏览或框选时的误触。

🎨 界面排版优化

• 种子地图图例面板自适应避让：优化了种子地图图例面板的停靠机制与交互层级，图例不再与右下角的缩放控制按钮发生重叠遮挡，保障缩放操作畅通无阻。
• UI 缩放保护机制：全局 UI 缩放支持最低 0.50x 保护，并提供了便捷的缩放重置机制。

⚡ 大地图性能与渲染极致优化

• 动态运动状态机与单帧微秒级时间预算：
  • 引入地图平移与滚轮/按钮快速缩放的动态状态感知。
  • 在大幅度快速缩放与视口平移过程中，单帧纹理生成时间严格受控在 0.5ms 以内（静止时放宽至 3.5ms），彻底消除大范围来回缩放与拖拽时的顿卡和掉帧。
• 四叉树多级金字塔 DrawCall 大幅精简：在大视野多级金字塔分支渲染中，对已构建完成的分支自动跳过其下属原始子区域的重复绘制与纹理切换，显著降低 GPU 光栅化与 DirectX 开销。
• 脏分支版本号零锁快照检测：采用原子版本号递增快照检索机制，视口遍历数以百计的分支时实现 0 互斥锁竞争，消灭渲染主线程的锁竞争瓶颈。
• 无分支 CPU 地形着色流水线：重构像素着色算法，将边界像素与核心内部区域解耦，对占 99.2% 的内部像素采用无分支流水线着色，CPU 计算速度提升 4~5 倍。

🗺️ 地貌扫描与缓存增强

• 首个区块第 0 帧即时呈现与落盘：玩家脚下的中心立足区块在扫描开始瞬间即完成前台渲染与后台缓存持久化写入，杜绝初次进入地图或快速传送时的黑块延迟。
• 增量提交与后台异步持久化双通道：前台提供每秒 12 次高频平滑渲染，后台平稳进行异步磁盘缓存落盘，兼顾毫秒级实时刷新响应与长期持久化浏览。

v0.5.5-mc26.51

ChiyanMap Changelog

🛡️ Rendering Stability & Fault Tolerance

• Self-Healing Rendering State: Introduced an RAII state guard for the core rendering pipeline, completely eliminating edge cases where the minimap or fullscreen world map could permanently freeze during viewport changes, extreme window resizing, or unexpected interrupts.
• Full-Pipeline Exception Isolation: Established a robust structured exception barrier across the DXGI Present chain and ImGui render loops. Any drawing anomalies are seamlessly isolated, guaranteeing zero CTDs (crashes to desktop) and sustained 60+ FPS stability for the game process.
• Graceful Shutdown & Unload: Optimized resource cleanup and window procedure handover during client exit, ensuring all D3D/ImGui resources are released in an orderly fashion and completely eliminating game-exit crashes.

🗺️ Multiworld & Map Instance Management

• Guaranteed Cross-Session Persistence: Added mandatory disk-flush pipelines for drawing annotations and multiworld configurations upon world departure and mod disablement, ensuring all recently placed drawings and map settings are 100% committed to disk.
• Deep Cascade Cleanup on Map Deletion: Deleting a multiworld or custom map instance now automatically purges its associated waypoint sets, custom folders, and multi-dimensional drawing annotations, preventing orphaned leftover files from accumulating on disk.
• Seamless World Reconnection & Resync: Enhanced client-state reset logic when returning to the main menu. Rejoining the same world or entering a new server now reliably triggers full world re-initialization and initial map pre-scanning every time.

📍 Waypoints & Death Points System

• Instant Waypoint Visibility Persistence: Toggling waypoint visibility in the waypoint manager now immediately saves to disk, ensuring enabled/disabled states are fully preserved across game restarts.
• Cross-Session Death Point Conversion Tracking: Added persistent serialization for linked waypoint IDs when converting death points into waypoints. Death points now seamlessly track the existence, deletion, and undo-restoration of their converted waypoints across restarts.

⚡ Chunk Scanning & Memory Safety

• Fully Thread-Safe Scan & Cache Pipeline: Redesigned the concurrent parameter synchronization between high-speed chunk scanning and background disk writes, completely eliminating data-race conditions when active scans are interrupted.
• Self-Healing Region Cache Memory: Hardened the region binary cache loader with unconditional resource cleanup upon load failures, preventing memory leaks caused by corrupt or missing cache entries.
• Biome Index Boundary Protection: Added strict boundary validation for unpopulated and unknown biomes (0xFF), preventing out-of-bounds memory access during surface height sampling and water detection in edge terrain.
• Precise Dirty Texture Hash Eviction: Streamlined region texture GPU cache synchronization by promptly evicting clean entries once baked, noticeably reducing GPU memory scheduling and sync overhead during rapid map panning and zooming.

🎨 Biomes & Visual Palette

• Foliage Tints for New Biomes: Added authentic foliage tint colors for Poplar Forest and Dappled Forest biomes, making terrain and canopy transitions look much more natural on both the minimap and fullscreen world map.
• Seed Map Atlas Expansion: Extended and refined seed map biome icon definitions and GUI atlas mappings for full visual parity.

ChiyanMap 更新日志

🛡️ 渲染稳定性与容灾增强

• 渲染状态自愈机制：引入核心渲染管线 RAII 状态守护机制，彻底杜绝在视口切换、极端窗口缩放或异常中断时小地图/大地图渲染可能永久锁死的问题。
• 全链路异常容灾隔离：在 DXGI Present 呈现层与 ImGui 渲染管线建立严密的异常防护屏障，隔离任何异常渲染图元，确保游戏主进程始终平稳运行、零闪退。
• 退出流程平滑卸载：优化模组在游戏退出阶段的资源清理与窗口过程接管逻辑，确保退出游戏时所有资源有序释放，彻底规避游戏退出崩溃。

🗺️ 多世界与地图实例管理

• 跨会话数据刷盘保障：在模组卸载与世界退出环节新增涂鸦标注与多世界配置的强制持久化流程，确保退出前绘制的图元与地图设置 100% 写入磁盘。
• 地图实例级联深度清理：删除多世界/自定义地图实例时，自动联动清理该地图所属的独立路径点集合、自定义文件夹以及各维度的涂鸦标注文件，杜绝残留孤儿数据占用磁盘。
• 世界重连无缝重载：增强离开世界返回主菜单后的状态重置机理，修复重新连接相同世界或进入新世界时偶发跳过世界初始化与地图预扫描的问题，实现每次进服即刻重新加载最新地图。

📍 路径点与死亡点系统

• 路径点显隐即时持久化：点击路径点管理列表中的显隐切换按钮后即刻执行自动落盘，游戏重启后路径点的显示/隐藏状态完整保留。
• 死亡点转换状态跨会话联动：补齐死亡点“转换为路径点”后的关联 ID 持久化存储，无论重启游戏还是切换世界，已转换的死亡点均能精确感知对应路径点的存在、删除与撤回恢复状态。

⚡ 扫描线程与内存安全优化

• 扫描写入全线程安全：重构区块快速扫描与后台磁盘写入的并发参数同步模型，彻底消除扫描打断时后台缓存写入线程的并发竞争隐患。
• 区域缓存内存自愈：优化区域二进制缓存文件的加载机制，在损坏或空表项场景下引入无条件内存回收，杜绝缓存异常导致的内存泄露。
• 群系索引边界安全防护：全面增加未扫描与未知生物群系（0xFF）的安全边界校验，防止在特殊地形高度取样与水体判定时发生非法内存越界访问。
• 脏纹理哈希精准清理：优化区域纹理缓存同步策略，纹理烘焙完成后即时移除已同步表项，显著降低大地图平移缩放时的 GPU 显存调度与同步开销。

🎨 生物群系与视觉色彩丰富

• 新增群系专属着色：补充杨树林（Poplar Forest）与斑驳森林（Dappled Forest）等特色生物群系的专属树叶群系染色参数，使大地图与小地图的地貌过渡更自然逼真。
• 种子地图图集完善：同步扩充并优化种子地图对应的群系图标定义与 GUI 图集映射。

v0.5.4-mc26.51

Changelog

1. All-New Hardware Cursor System

• Native High-Refresh-Rate Driving: Fully upgraded to operating system native hardware cursor control, bypassing application rendering framerate limitations to deliver silky-smooth movement without trailing, stutter, or ghosting.
• Adaptive Cursor Styles: Dynamically adjusts cursor appearance across mod interfaces based on hovered elements, supporting standard arrows, interactive hand pointers, text input I-beams, and window resize indicators.
• Seamless View Control Transitions: Enjoy unconstrained, full-screen cursor movement across windows and multi-monitor setups when opening the world map or setting panels, followed by instantaneous cursor hiding upon closing for smooth first-person crosshair controls.
• Flawless Native Menu Compatibility: Seamlessly preserves vanilla mouse pointers in the inventory, chests and containers, pause screen, and chat interface.

2. In-Game 3D Waypoints & Native Beacon Beams

• 3D Waypoint Vision: Renders clear 3D spatial waypoint icons and distance readouts directly within the in-game world, offering intuitive directional guidance across all distances.
• Native Beacon Beam Integration: Supports attaching vertical beacon beams that pierce through the sky directly to waypoints, making long-distance navigation and base location effortless.

3. Full-Screen Map Drawing & Annotation System

• Versatile Hand-Drawn & Geometric Tools: Equips the full-screen map with freehand brushes, straight lines, directional arrows, rectangles, ellipses, and custom text labels.
• Convenient Palette & Undo / Redo: Features color palette selections and brush width adjustments, backed by standard shortcut support for rapid undo and redo operations.
• Persistent Local Storage: Annotations and drawings are automatically cataloged and preserved per world and dimension using a built-in SQLite database engine for instant loading and saving.

4. Anarchy Trace Detection & Highway System

• Highway & Anomaly Chunk Highlights: Automatically identifies and visualizes Overworld, Nether, and End highway routes directly on the map.
• Portal Skip Analysis: Detects Nether portal transition trajectories and historical terrain anomalies to aid in navigation and world exploration.
• Dedicated Control Panel: Offers granular filtering controls to customize and toggle highway paths and anomaly markers on demand.

5. Render & Simulation Distance Visual Overlays

• Real-Time Boundary Visualization: Displays the player's active render distance and simulation distance boundaries on both the minimap and full-screen map, clearly illustrating active chunk loading and ticking areas.
• Multi-Grid Synergy: Works concurrently with slime chunk and chunk border overlays to assist in structural planning and redstone engineering.

6. Map Scanning & Cache Architecture Optimizations

• Two-Stage Streaming Scans: Prioritizes the player's immediate field of view for instant texture delivery, while peripheral regions are smoothly generated in the background.
• Persistent Worker Threading: Utilizes pre-allocated memory buffers and dedicated background worker threads, eliminating dynamic heap allocation overhead and micro-stutters during rapid map discovery.
• Surface & Cave Anti-Pollution Safeguards: Strictly prevents subterranean ceilings and cave rocks from contaminating surface caches, ensuring pristine visual fidelity across all dimensions and elevation slices.

更新日志

1. 全新硬件光标系统

• 原生高刷新率驱动：全面升级为操作系统原生硬件光标驱动，彻底摆脱应用程序渲染帧率限制，光标移动平滑如丝，杜绝拖影与掉帧。
• 自适应光标形态：在模组界面中自动根据交互对象切换为系统箭头、交互手型、文本输入框光标及窗口缩放光标。
• 无感视角控制权交接：开启全屏大地图与各类设置面板时光标全屏自由无拘，关闭模组界面后瞬间无缝隐藏，游戏第一人称准星操作连贯顺畅。
• 完美兼容原生菜单：游戏原版背包、容器界面、暂停菜单及聊天栏中的鼠标指针均保持原生状态正常呈现。

2. 游戏内 3D 航点与原生信标光柱

• 3D 航点穿透视野：在游戏画面中直观呈现 3D 空间立体航点图标与距离标注，指引方向清晰直观。
• 原生信标光柱集成：支持直接关联航点并渲染贯穿天际的信标光柱，远距离定位一目了然。

3. 全屏大地图涂鸦与标注系统

• 多样化手绘与几何工具：大地图新增自由画笔、直线、方向箭头、矩形、椭圆与文字标签标注工具。
• 便捷调色与撤销重做：支持多色调色板与笔刷粗细调节，支持通过常用快捷键极速撤销与重做编辑操作。
• 本地持久化存储：涂鸦与标注按世界和维度自动分类保存，采用 SQLite 本地数据库实现秒级极速读写。

4. 无规则痕迹探测与主干道系统

• 主干道与异常区块高亮：支持识别主世界、地狱与末地的主干道路径，并在地图上清晰标记。
• 传送跳跃侦测：自动分析地狱传送门跃迁轨迹与异常地形变动点，辅助探索定位。
• 专属控制面板：提供独立的探测过滤设置，可按需开关主干道和异常标记的视觉呈现。

5. 视距与模拟距离可视化覆盖层

• 实时边界指示：支持在小地图与大地图上实时显示玩家当前的视距边界与模拟距离边界，直观了解区块加载与运作范围。
• 多功能网格协同：可与史莱姆区块及区块边界等图层协同显示，辅助精确规划建筑与红石设施。

6. 地图扫描与缓存架构性能提升

• 双阶段流式扫描：玩家核心视野区域优先完成极速解析并即刻呈现，外围大范围区域在后台持续顺滑补齐。
• 持久化工作线程池：采用预分配内存与持久化后台任务线程，消除了高频扫描时的动态内存分配开销，地图浏览毫无卡顿。
• 地表与洞穴防污染机制：地下探索时严格防止天花板与矿洞岩石数据污染地表缓存，保证各维度与各层级地图画面的纯净度。

v0.5.3-mc26.51

ChiyanMap Changelog

1. World Map System Enhancements

• Collapsible Waypoint Drawer & Camera Alignment

  • Embedded a collapsible waypoint drawer sidebar inside the full-screen world map for quick search and management of waypoints.
  • Clicking a waypoint smoothly pans the camera to align with target coordinates, with optional auto-collapse of the drawer upon completion.

• Box-Selection Drag-to-Export High-Definition PNG

  • Supported box-selecting any rectangular region by dragging the mouse while holding a shortcut key (Shift by default) on the full-screen world map.
  • One-click export of the selected region as a native high-definition lossless PNG image, with customizable shortcut key in keybindings settings.

• Lighting, Color, and Multi-Layer Rendering Pipeline

  • Implemented translucent color blending and transmission for stained glass, and restored realistic lava texture coloration.
  • Introduced swamp biome dual-color grass noise blending, accurately rendering the transition between deep swamp green and withered olive-brown grass.

• Granular Cave Mode System

  • Provided three selectable modes: Off, Layered Cave, and Full Cave.
  • Supported configuring allowed dimension whitelists, auto cave roof detection size, dynamic switching transition delay, as well as custom cave top Y and depth.

• Map Data Source Control & Multi-Tier Caching Architecture

  • Added fine-grained controls for vanilla map data: read-only, read-and-update, and fully offline read modes.
  • Provided configurable RAM cache limits and asynchronous tiered I/O controls, drastically reducing memory footprint during extensive exploration.

---

2. Minimap Rendering & HUD Interaction

• Intelligent PushBox Anti-Overlap System

  • Real-time detection of vanilla Boss health bars and top-right potion status effect indicators.
  • When status icons or boss bars are present, the minimap smoothly shifts inward or downward to prevent interface element overlap.

• Dynamic Environment & Real-Time Weather Display

  • Minimap accurately detects and displays current in-game weather (Clear, Rain, Thunder) and current environment status.

• Slime Chunk & Dynamic Grid Overlay

  • Integrated world seed algorithm to natively render a green translucent slime chunk overlay on the minimap.
  • Provided a configurable chunk grid line overlay, supporting static visibility as well as dynamic fade-in/fade-out based on zoom level.

• Compass Cardinal Marker Visual Redesign

  • When compass markers are positioned on the frame ring, a proper clearance gap is automatically maintained to prevent clipping with the border.
  • When positioned inside the minimap, markers feature a translucent rounded black background panel to prevent blending into complex terrain textures.
  • Added Lock Compass mode, allowing the compass north marker to remain locked facing upward while the minimap rotates.

---

3. Waypoint Management & Sharing System

• Top-Level Waypoint Sets Management

  • Added a dedicated Waypoint Sets system independent of category folders, supporting creating, renaming, deleting, and quick-switching sets across scenarios.
  • Waypoint data is strictly filtered and isolated according to the currently active set.

• Cycle Shortcut Switching & Centered Toast Notifications

  • Supported binding shortcut keys to cycle seamlessly between previous and next waypoint sets in-game.
  • When switching sets, a centered toast notification with a smooth fade-in and fade-out animation displays the active set name.

• Quick Waypoint Sharing & Coordinate Copying

  • Waypoint list supports one-click copying of formatted coordinate strings and generating standardized in-game chat sharing commands.

---

4. Advanced Entity Radar System

• Render Over Minimap Frame

  • When entities move outside the minimap's visible bounds, they smoothly clamp and glide along the inner border of the minimap frame.
  • Offered five operating modes: Off, All Entities, Hostile Mobs Only, Other Players Only, and Only When Holding Tab.
  • Rendered categorized colored arrows outside border icons pointing toward true entity directions, automatically hiding floating nameplates when clamped to keep the viewport clean.

• Custom Wildcard Entity Filter Rules

  • Added dual filters for Include and Exclude rules, active across both minimap and full-screen world map.
  • Supported wildcard patterns * and ? as well as comma-separated compound lists (e.g., *creeper*, *zombie* or *bat*, cod).

• Tamed Mobs Highlight & Heart Badge

  • Native detection of player-tamed pets.
  • When highlighted, renders an exclusive dual-layer neon green halo around the mob icon, with a bright green heart badge (♥) prefixed to the nameplate.

• Configurable Depth Fade Y-Distance

  • Upgraded vertical depth darkening threshold to a smooth float slider (1.0 to 30.0 blocks) with a one-click factory reset button.

---

5. Settings Panel & Core Experience

• Native IME Support

  • Full integration of native IME popup in search boxes and all text input fields, supporting Chinese and multilingual input.

• Real-Time Settings Search & Match Counter

  • Embedded a live search bar across both world map and minimap settings, supporting fuzzy filtering by English, Chinese, and Pinyin with live match counts.

• Dual-Granularity Reset to Defaults

  • Offered reset to defaults at both the current category tab and global settings levels, complete with confirmation dialogs and immediate GPU state refresh.

• Full 16-Language Localization & Config Persistence

  • All new features fully covered across 16 language localizations.
  • All configuration options automatically persist to configuration files.
  • Cleaned up unmaintained beacon beam residue code to ensure engineering cleanliness.

  ChiyanMap 更新日志

一、全屏大地图系统增强

• 路径点折叠抽屉与镜头对齐

  • 在全屏大地图内嵌可折叠的路径点抽屉侧栏，支持快速检索与管理路径点。
  • 点击路径点即可平滑移动镜头对齐目标坐标，并在跳转完成后支持自动收起抽屉。

• 区域拖拽框选高清导出 PNG

  • 支持在全屏大地图中通过快捷键（默认 Shift）拖拽鼠标实时框选任意矩形区域。
  • 支持将所选区域一键导出为原生高清无损 PNG 图片，触发快捷键支持在按键设置中自定义。

• 光影、色彩与多层渲染管线

  • 实现了染色玻璃半透明色彩叠加透射效果与岩浆材质真实色彩还原。
  • 引入沼泽生物群系双色草地噪声混合算法，精准呈现深邃绿与枯萎褐双重草地过渡。

• 洞穴模式（Cave Mode）细分体系

  • 提供了关闭、分层洞穴、完整洞穴三种模式切换。
  • 支持配置生效维度白名单、自动洞穴顶盖探测尺寸、动态切换缓冲时长以及自定义洞穴顶层高度与深度。

• 地图数据源控制与多级缓存架构

  • 增加对原版地图数据仅读取、读取并更新以及仅只读模式的精细控制。
  • 提供运行内存缓存上限调节与异步分层读写控制，大幅降低大范围探索时的内存占用。

---

二、小地图渲染与 HUD 交互

• 智能界面防遮挡推挤系统（PushBox System）

  • 小地图能够实时探测游戏原版 Boss 血条与右上角药水状态效果栏的占位情况。
  • 当存在状态图标或血条时，小地图自动向内侧或下方平滑避让，杜绝界面元素重叠遮挡。

• 动态环境与实时天气显示

  • 小地图界面支持精准检测并显示游戏世界内的当前天气（晴天、降雨、雷暴）及所处环境状态。

• 史莱姆区块与动态网格覆盖层

  • 接入世界种子算法，在小地图上原生绘制绿色半透明史莱姆区块覆盖层。
  • 提供可配置的区块网格线覆盖层，支持静态常驻及随缩放级别动态淡入淡出。

• 罗盘方位字标视觉重构

  • 罗盘字标设置为边框圆环上时，与圆环边框自动保持合理隔离间隙，不再产生穿插遮挡。
  • 罗盘字标设置为地图内侧时，字标底层新增半透明圆角黑色背景板，避免与复杂地形底色融合导致辨识不清。
  • 新增锁指南针模式，支持在小地图旋转时将指南针正北方向锁定朝上。

---

三、路径点管理与分享系统

• 顶层路径点集合管理（Waypoint Sets）

  • 新增独立于分类文件夹的路径点集合系统，支持多场景集合的新建、重命名、删除与一键切换。
  • 路径点数据按当前激活的集合精准过滤隔离。

• 快捷键循环切换与居中浮窗通知（Toast）

  • 支持绑定快捷键在游戏内无缝循环切换上一个或下一个路径点集合。
  • 切换集合时，屏幕中央上方展示带平滑淡入淡出过渡动画的集合名称浮窗通知。

• 路径点快速分享与坐标复制

  • 路径点列表支持一键复制标准坐标文本，以及生成规范格式的聊天栏快速分享指令。

---

四、高级实体雷达系统

• 雷达越界吸附边框（Render Over Minimap Frame）

  • 当实体脱离小地图可视范围时，平滑约束在小地图内边缘滑行。
  • 提供五种工作模式：关闭、全部实体、仅敌对生物、仅其他玩家、仅按住 Tab 键时。
  • 在边缘图标外侧绘制指向实体真实方位的分类彩色外指小箭头，吸附时自动隐藏悬浮命名牌以保持视口清爽。

• 生物自定义通配符高级过滤规则

  • 新增包含规则与排除规则双重过滤器，支持在小地图与全屏大地图双向过滤。
  • 规则支持 * 和 ? 通配符以及逗号复合列表（如 *creeper*, *zombie* 或 *bat*, cod）。

• 已驯服生物高亮识别与爱心标识

  • 原生识别玩家已驯服的宠物生物。
  • 开启高亮时在生物图标外围渲染专属双层荧光绿光环，并在生物命名牌上自动添加亮绿色爱心（♥）前缀。

• 景深淡出高度差自由调节

  • 将生物上下垂直景深暗化阈值升级为 1.0 至 30.0 格的浮点滑块调节，并提供出厂一键复位按钮。

---

五、设置面板与全局基础体验

• 原生多语言输入法唤起（NativeIME）

  • 设置面板搜索框与全部文本输入框全面接入原生输入法，支持中文及各类语言的正常输入。

• 实时设置项搜索与匹配统计

  • 大地图与小地图设置面板均集成实时搜索栏，支持跨分类按中文、英文及拼音模糊过滤，并实时展示匹配结果计数。

• 双粒度一键恢复默认设置

  • 提供当前分类面板与全局全部设置两种粒度的一键恢复出厂设置功能，附带二次确认弹窗并即时刷新渲染状态。

• 多语言本地化覆盖与配置持久化

  • 所有新增功能完整覆盖 16 种语言本地化词条，规范中文表述。
  • 所有配置项自动持久化保存至配置文件。
  • 彻底清理移除未启用的路径点信标光柱遗留实现代码，提升工程整洁度。

v0.5.2-mc26.51

Changelog

🌟 New Features

• Multiworld / Subworld Instance Manager

  • Added a map instance switcher and management panel at the top of the fullscreen map, allowing you to create, rename, delete, and switch between multiple independent sub-map instances within the same world or server, each with isolated chunk caches and waypoints.
  • Added support for three map selection modes: Single Map Mode, Manual Selection Mode, and World Spawn Auto Mode (automatically splits and switches sub-maps when the world spawn point changes).
  • Decoupled the player's Active Map from the Viewed Map in the fullscreen map, allowing you to freely preview other sub-maps without changing your active map, and automatically resetting upon closing the fullscreen map.
  • Added Connect Maps management and cross-map teleport protection: configure connections between sub-maps and automatically intercept teleportation attempts with a warning modal when the target map is not connected to the current active map.

• Waypoint Interactions & Management Enhancements

  • Share Waypoint in Chat: Added a "Share in Chat" option to both the fullscreen map waypoint context menu and the waypoint manager list, sending formatted waypoint coordinates to the in-game chat and copying them to the clipboard with one click.
  • Multi-Level Waypoint Restore Stack & Shortcut Undo: Upgraded waypoint restoration to a 20-level LIFO undo stack. You can continuously restore deleted waypoints via the fullscreen map context menu, the bottom button in the Waypoint Manager, or the Ctrl + Z shortcut, with real-time display of the next restorable waypoint name and remaining count.
  • Min Zoom for Local Waypoints: Added a "Min Zoom For Local Waypoints" slider in Fullscreen Map Settings to automatically hide regular local waypoints when zoomed out below the threshold while keeping pinned (★) and temporary waypoints visible, preventing icon clutter at far zoom levels.
  • Render Waypoint Backgrounds Toggle: Added a setting to toggle the semi-transparent dark background plates behind waypoint name labels across both the minimap and the fullscreen map.
  • Surface / Cave Layer Attribution & Smart View Sync:
    • Added an Overworld layer property (Auto / Surface / Cave) when creating or editing waypoints.
    • Clicking "Locate" in the Waypoint Manager now automatically switches the fullscreen map to the waypoint's dimension and Surface/Cave mode before centering on it.
    • Creating a waypoint or setting a temporary waypoint via right-click on the fullscreen map while viewing another dimension or Cave mode now automatically inherits the currently viewed dimension, Surface/Cave layer, and corresponding elevation.

• Minimap Info Bar Background Toggle

  • Added a "Show Info Bar Background Plate" toggle in Minimap Settings to hide the dark background box beneath the minimap HUD info bar for a clean, transparent floating text display.

---

⚡ Improvements & Optimizations

• Minimap Settings Layout Optimization: Moved the "Adjust Minimap Layout" button to the top of the Minimap Settings panel for quicker access.
• Fullscreen Map Cursor Position Memory: Automatically remembers and restores the exact screen coordinates of the mouse cursor when toggling the fullscreen map in both windowed and fullscreen modes.
• Safe Teleportation to Unexplored Regions: Improved the two-phase high-altitude probing and area landing search mechanism when teleporting to unexplored (black) regions in the Overworld and the Nether, ensuring a safe landing spot with sufficient vertical clearance once chunks finish loading.

更新日志

🌟 新增功能

• 多世界 / 子地图实例管理系统（Multiworld Manager）

  • 全屏大地图顶部新增地图实例切换与管理面板，支持在同一世界/服务器内创建、重命名、删除及切换多个独立的子地图实例，各子地图的区块缓存与路径点相互独立存储。
  • 支持三种地图选择模式：单张地图模式、手动选择模式、世界出生点自动模式（根据世界出生点坐标变化自动切分并切换对应子地图）。
  • 分离玩家当前所处的实际活动地图与全屏大地图正在查看的浏览地图，支持在不改变实际活动地图的情况下自由预览其他子地图，并在关闭大地图时自动复位。
  • 新增**地图互联（Connect Maps）**配置与跨地图传送安全拦截：支持建立或解除不同子地图之间的互联关系；当向未与当前活动地图建立互联的目标地图发起传送时，自动弹出安全警告并拦截传送。

• 路径点交互与管理增强

  • 聊天栏一键分享路径点：全屏大地图路径点右键菜单与路径点管理列表新增“分享到聊天栏”功能，支持一键将格式化坐标信息发送至游戏聊天栏并同步复制到剪贴板。
  • 多级误删恢复栈与快捷键撤销：路径点删除恢复升级为最高 20 级的后进先出（LIFO）撤销栈，支持通过大地图右键菜单、路径点管理器底部按钮或 Ctrl + Z 快捷键连续恢复误删的路径点，并实时显示待恢复路径点的名称与数量。
  • 密集路径点最小缩放阈值：大地图设置新增“局部路径点最小缩放阈值”滑块，当地图缩放低于设定阈值时自动隐藏普通局部路径点，仅保留置顶（★）与临时路径点，避免远景缩小时图标密集遮挡。
  • 路径点名称背景底板开关：设置面板新增“显示路径点名称背景底板”开关，可统一控制小地图与全屏大地图中路径点文字半透明背景框的显示与隐藏。
  • 地表 / 洞穴层级归属与智能联动：
    • 路径点新增主世界层级属性（自动判定 / 地表之上 / 洞穴内），支持在新建与编辑路径点时指定。
    • 在路径点管理列表中点击“定位”时，全屏大地图将自动同步切换至该路径点所属的维度与地表/洞穴模式并居中显示。
    • 在全屏大地图跨维度或洞穴视图下右键新建路径点及设置临时路径点时，自动继承当前大地图所浏览的维度、地表/洞穴层级及对应高度。

• 小地图信息栏背景底板开关

  • 小地图设置新增“显示信息栏背景底板”开关，支持隐藏小地图下方实时信息栏的深色背景框，实现纯文字透明悬浮效果。

---

⚡ 优化与改进

• 小地图设置面板布局调整：将“调整小地图布局”按钮移至小地图设置面板顶部，便于快速进入布局调整模式。
• 全屏大地图光标位置记忆：在窗口化与全屏模式下开关全屏大地图时，自动记忆并恢复鼠标光标的屏幕坐标位置。
• 未探索区域跨维度安全传送优化：升级主世界与下界向未探索黑色区域传送时的两阶段高空探测与范围落脚点搜索机制，确保区块加载稳定后精准降落至具备充足垂直净空的安全位置。
• 16 国语言全量本地化覆盖：全面补全并校对全部 16 种语言（简/繁中文、英、德、西、法、印尼、意、日、韩、巴葡、俄、泰、土、乌、越）的界面文本、种子地图图层详情说明与统计栏、全部 115 种生物实体名称及群系词条，并支持切换语言时动态刷新默认地图名称、临时路径点名称与群系悬停信息。

v0.5.1-mc26.51

更新日志

🗺️ 地图渲染与显示

• 修复地图渲染异常：修复地表部分树木与地形渲染错误、产生黑斑或杂色噪点的问题。
• 重构动态光影管线：优化 3D 浮雕与地形深度阴影的动态计算效果，并支持自动校正受损的历史地图缓存。

🧭 全屏大地图与交互

• 新增主世界洞穴地图切换：大地图顶部“主世界”按钮旁新增“洞穴”按钮，支持一键在主世界地表与洞穴地图之间无缝切换。
• 完善 ESC 键逐级退出逻辑：支持按层级依次关闭右键菜单与模态弹窗、子面板以及全屏大地图，防止误触关闭主地图。
• 优化光标与切屏交互体验：优化全屏大地图的光标生命周期与系统交互，确保在各类窗口模式及切屏切回时鼠标指针流畅可用，且不影响游戏原生界面的鼠标操作。

👾 生物雷达与实体展示

• 新增生物头像缩放设置：大地图设置中新增头像尺寸调节功能，支持自由缩放大地图上的生物与怪物头像。
• 优化生物头像放大显示：放大小地图生物头像时默认隐藏常规生物名称，使画面更清爽（带有命名牌的生物仍正常保留显示名称）。
• 生物名称多语言化：全屏大地图点击实体弹出的信息卡中，生物名称全面支持游戏官方 16 种语言本地化显示。

⚡ 启动性能优化

• 消除主菜单卡顿：优化模组资源加载与异步初始化流程，消除游戏首次启动进入主菜单时的短暂停顿，提升启动流畅度。

🌐 界面与本地化

• 优化设置界面文本：修正小地图设置面板中的文字描述，统一本地化词条。