World Preview (Unofficial Port)

1.3.2–1.3.5

New Features

• Added world analysis engine with UI (region metrics, profile sampling, progress tracking)
• Added generation statistics panel (sampling progress, biome/structure counts)
• Added dual zoom levels (32px/64px per chunk, Ctrl+scroll to switch)
• Added chunk preload system (configurable radius, idle-only mode)
• Added mod compatibility framework (auto-detection, TFC adapter, generator abstraction layer)
• Added biome search: right-click a biome in the biome list to trigger "Find this Biome", which automatically tries random seeds in the background and fills in the seed when a match is found
  • Search supports real-time progress display (attempts/max)
• Added "Search min area" setting: configure the minimum percentage of screen sample points that must be covered by the target biome (0–100%, 0 = no requirement)
• Added "Search max distance" setting: require the target biome to have at least one sample point within this distance from the screen center (0–10000 blocks, 0 = no requirement)
• Added "Show biome counts" setting: display the number of visible blocks for each biome in the biome list
• Added "Enable analysis area" setting: toggle the analysis button above the biome list
• Added spawn pin mode: a "Spawn" button is available in the world creation preview screen, next to the settings button. Click it to toggle spawn pin placement mode
  • Left-click on the preview map to place or move the spawn pin (uses the same Steve head icon as the player position indicator)
  • Right-click on the preview map to remove the spawn pin
  • The spawn point is automatically applied when the world is created — no cheats required
  • The spawn pin button is hidden in the in-game pause menu preview (only available during world creation)
• Added terrain map export: export large-scale biome/terrain distribution as PNG images from the General settings page
  • Configurable coverage radius and blocks-per-pixel resolution
  • Terrain classification into 9 categories (Deep Ocean, Ocean, River, Beach, Plains, Forest, Hills, Mountain, Peak)
  • Optional contour line overlay on exported maps
  • Progress tracking with elapsed/remaining time estimation
  • Exported to config/world_preview/terrain_exports/
• Added hillshade rendering: simulated sun illumination overlay on the heightmap view for enhanced 3D terrain perception
  • Configurable light azimuth (0–360°), altitude (0–90°), ambient light (0–1), and vertical exaggeration (0.1–5.0)
  • Only effective in heightmap mode
• Added contour lines: topographic contour lines overlay on the heightmap preview
  • Configurable contour interval (5–64 blocks)
  • Optional minor contour lines at 1/5 interval for finer detail
  • Major lines drawn in brown, minor lines in olive
• Added config management system: ConfigBackupManager, ConfigLoader, and ConfigMigrator for robust config backup, loading, and version migration

Improvements

• Reworked settings UI from tabs to sidebar + page architecture
• Reorganized the General settings page into three sections: Sampling, Display, and Other
• Rendering performance: adaptive throttling
• Scheduling optimization: thread pre-starting, batch deduplication, drag-throttled cadence (50ms)
• Config system: version migration, validation and normalization, analysis defaults
• Added 35 JUnit 5 tests (covering storage, sampler, analysis, compatibility layer, rendering)
• The export button text updates instantly upon click in both the world creation screen and the in-game pause menu
• The spawn pin button text changes to indicate the current state ("Spawn" / "Spawn ✓")
• Spawn pin coordinates are saved to config and restored when reopening the world creation screen
• Translated all code comments from Chinese to English throughout the codebase
• Added diagnostic logging ([WP-*] prefixed) across GUI lifecycle, tab management, and mouse interaction for easier debugging
• Added cache loading state tracking to PreviewContainer
• Lightweight terrain export biome sampler that bypasses full SampleUtils for efficient large-area sampling