Chunky GUI 1.2.0 - Forge

Minecraft 1.21.1 / Forge

This is the first official Forge release of Chunky GUI.

Chunky GUI provides an in-game graphical interface for managing Chunky world pregeneration tasks.

This file is the Forge build of Chunky GUI 1.2.0. NeoForge and Fabric builds are also available separately.

Features

World Generation Management

• Manage Chunky pregeneration directly from an in-game GUI.
• Supports:
  • Overworld
  • Nether
  • End
  • Custom dimensions
• Configure generation center coordinates.
• Use the player's current position as the generation center.
• Configure target generation radius and shape.
• Start / Pause / Resume / Cancel generation tasks.

Multi-Dimension Task Management

• Added collapsible per-dimension task cards.
• Each active or resumable dimension has its own task state and progress display.
• Task cards can display:
  • Dimension and world information
  • Task state
  • Generation center
  • Radius and shape
  • Generated / target chunks
  • Progress
  • Generation speed
  • Elapsed time
  • ETA
  • Generation-range preview
  • Disk-usage estimates
• Configure another dimension while existing generation tasks continue running.

Generation Preview

• Preview the target generation area before starting a task.
• Supports very large generation radii and offset generation centers.
• Displays estimated chunk count, generation time, and disk usage.

Task Recovery

• Resume unfinished tasks after leaving a singleplayer world.
• Resume tasks after dedicated-server restart.
• Improved recovery for Nether, End, and custom-dimension tasks.
• Different world saves maintain isolated Chunky task state.
• Improved task identity and stale-state protection.

History

• View completed and cancelled generation tasks.
• Displays elapsed time, generation speed, and task details.
• Individual history records can be deleted.
• History deletion is validated and handled by the server.

Multiplayer & Permissions

• Singleplayer world owners can manage Chunky GUI without enabling cheats.
• Dedicated-server management actions require permission level 2 or higher.
• Non-OP players can open the GUI and view task status, but cannot control generation tasks.
• Task management and history deletion are validated server-side.

Localization

• English
• Traditional Chinese

Server-provided task and history information is localized according to each client's Minecraft language.

Performance & Stability

• Improved calculations and caching for very large generation ranges.
• Improved task timers and ETA calculations.
• Improved task-state persistence and restoration.
• Improved generation-history lifecycle handling.
• Hardened Start / Pause / Resume / Cancel / Complete task transitions.
• Improved client/server synchronization and stale-state protection.

Forge Integration

• Native Minecraft 1.21.1 Forge support.
• Forge-specific networking, configuration, lifecycle, and Chunky integration.
• Production runtime launches and verifies the actual distributable Forge JAR.
• Improved Forge client, OP client, and dedicated-server launch handling.
• Added Forge release-JAR completeness verification.

Requirements

• Minecraft 1.21.1
• Java 21
• Forge 52.1.16 or newer
• Chunky 1.4.23 or newer for Forge / Minecraft 1.21.1

Chunky is not bundled with Chunky GUI and must be installed separately.

Do not use the NeoForge or Fabric builds of Chunky GUI on Forge.

Known Issues

• When the Minecraft window is made very small or the GUI scale results in a narrow interface, the generation-center input fields may become vertically misaligned.

  • This is a visual layout issue only and does not affect input or world generation.

• If Minecraft is terminated abnormally while a generation task is active, the task may incorrectly appear as Completed in generation history.

  • This does not affect the generated world.
  • The incorrect history record can simply be deleted from the history screen.

Chunky GUI 1.2.0 - Forge

Minecraft 1.21.1 / Forge

這是 Chunky GUI 首次正式發布 Forge 版本。

Chunky GUI 提供遊戲內圖形化介面，用來管理 Chunky 的世界預生成任務。

此檔案為 Chunky GUI 1.2.0 的 Forge 版本。 NeoForge 與 Fabric 版本會另外提供。

功能

世界生成管理

• 直接透過遊戲內 GUI 管理 Chunky 世界預生成。
• 支援：
  • 主世界
  • 地獄
  • 終界
  • 自訂維度
• 設定生成中心座標。
• 可直接使用玩家目前位置作為生成中心。
• 設定目標生成半徑與 Shape。
• 支援 Start / Pause / Resume / Cancel。

多維度任務管理

• 使用可展開的 per-dimension 任務卡。
• 每個正在執行或可恢復的維度都有獨立任務狀態與進度。
• 任務卡可顯示：
  • 維度與世界資訊
  • 任務狀態
  • 生成中心
  • 半徑與 Shape
  • 已生成 / 目標 Chunk
  • 生成進度
  • 生成速度
  • 已執行時間
  • ETA
  • 生成範圍預覽
  • 磁碟空間估算
• 其他維度仍在生成時，可以同時設定下一個維度的生成參數。

生成範圍預覽

• 開始任務前可預覽目標生成範圍。
• 支援大型生成半徑與偏移中心。
• 顯示預估 Chunk 數量、生成時間與磁碟空間需求。

任務恢復

• 離開單人世界後可恢復未完成任務。
• Dedicated Server 重啟後可恢復任務。
• 改善 Nether、End 與自訂維度的任務恢復。
• 不同世界存檔的 Chunky 任務狀態彼此隔離。
• 強化 task identity 與 stale state 防護。

歷史紀錄

• 查看已完成與已取消的生成任務。
• 顯示執行時間、生成速度與任務詳細資訊。
• 支援刪除單筆歷史紀錄。
• 歷史紀錄刪除由 Server 驗證權限後執行。

Multiplayer 與權限

• 單人世界房主不需要開啟作弊即可管理 Chunky GUI。
• Dedicated Server 管理操作需要 permission level 2 或以上。
• 非 OP 玩家可以開啟 GUI 並查看狀態，但無法控制生成任務。
• 任務管理與歷史紀錄刪除均由 Server 驗證。

本地化

• English
• 繁體中文

Server 傳送的任務與歷史資料會依照各 Client 的 Minecraft 語言顯示。

效能與穩定性

• 改善超大型生成範圍的計算與快取。
• 改善任務計時與 ETA 計算。
• 改善任務狀態保存與恢復。
• 改善生成歷史紀錄生命週期。
• 強化 Start / Pause / Resume / Cancel / Complete 任務狀態轉換。
• 改善 Client / Server 同步與 stale state 防護。

Forge 整合

• 正式支援 Minecraft 1.21.1 Forge。
• 新增 Forge 專用 networking、configuration、lifecycle 與 Chunky integration。
• Production runtime 直接使用實際可發布的 Forge JAR 驗證。
• 改善 Forge Client、OP Client 與 Dedicated Server 啟動流程。
• 新增 Forge release JAR 完整性驗證。

需求

• Minecraft 1.21.1
• Java 21
• Forge 52.1.16 或更新版本
• Forge / Minecraft 1.21.1 對應的 Chunky 1.4.23 或更新版本

Chunky 不包含在 Chunky GUI 內，需要另外安裝。

請勿在 Forge 環境使用 NeoForge 或 Fabric 版本的 Chunky GUI。

已知問題

• Minecraft 視窗縮得較小，或 GUI Scale 造成介面寬度過窄時，生成中心座標輸入框可能會出現上下沒有完全對齊的情況。

  • 這只是 UI 排版問題，不影響座標輸入或世界生成。

• 如果生成任務執行途中 Minecraft 異常中止，該任務可能會在歷史紀錄中被錯誤標記為 Completed。

  • 不會影響已生成的世界內容。
  • 直接在歷史紀錄介面刪除這筆錯誤紀錄即可。