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

44 lines
1.6 KiB
Markdown

# 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.