Worldshaper/docs/kb/systems/world-overview.md

1.6 KiB

World Overview

What It Owns

The World Overview is the large-scale chunk map used for navigation, chunk inspection, bookmark placement, and chunk-level operations that would be awkward from the tile canvas alone.

Core Behaviors

  • Navigate directly to a chunk.
  • Move chunk content.
  • Duplicate chunk tiles.
  • Flip and rotate chunk content.
  • Delete a chunk and clear its tiles, height data, and placed entities.
  • Paint or restore the chunk background tile.
  • Create POIs and bookmarks from chunk positions.

Important UI Surfaces

  • World Overview floating window
  • Chunk context menu
  • Pending chunk-action flow
  • Bookmark and POI display

Important Files

  • src/worldshaperStudio/worldOverviewWindowController.ts
  • src/worldshaperStudio/dom.ts
  • server.js

Known Behavior Notes

  • The chunk context menu is already a rich operations hub, so many requests in this area are extensions to an existing menu rather than requests for a brand-new system.
  • Pending move and duplicate actions are stateful; the overview can wait for a second chunk selection before executing.
  • The overview also exposes quick background-painting workflows at the chunk level.

Relationships

  • Depends on Chunk Storage And Streaming for chunk records and chunk dimensions.
  • Depends on Windows because the overview lives in its own floating tool window.
  • Often intersects with Layers and Tiling when users want higher-level terrain or chunk painting workflows.

Triage Hints

Requests about chunk move, duplicate, rotate, delete, POIs, overview navigation, and world-scale map management should begin here.