administrator/Worldshaper
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Expand request review tooling and KB

Browse source
This commit is contained in:
Andraxion 2026-06-27 01:12:35 -04:00
parent ab1dfbf029
commit cae21b61b7
16 changed files with 1258 additions and 241 deletions
Download patch file Download diff file Expand all files Collapse all files

61
docs/kb/systems/world-overview.md
View file

@ -1,45 +1,44 @@
# World Overview
## What It Does
## What It Owns
World Overview is a separate window that displays a coarse map of all known chunks, supports bookmark navigation, and exposes chunk operations such as move, duplicate, rotate, flip, delete, and background adjustments.
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.
## Key Files
## 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`
## Endpoints It Uses
## Known Behavior Notes
- `GET /api/world/:worldId/overview`
- `GET /api/world/:worldId/bookmarks`
- bookmark writes flow through the world save path
- 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.
## Important Data And Rules
## Relationships
- overview currently requests the full set of world chunks from the server
- it draws its own chunk preview surfaces
- it merges server chunks with cached client chunks to reflect unsaved local state
- chunk context menus expose world-level operations
- 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.
## Invariants And Constraints
## Triage Hints
- overview is only available in world mode
- overview actions should not silently discard unsaved chunk edits
- chunk transform actions must preserve chunk addressing rules
- the full overview payload can become a performance hotspot on larger worlds
## Common Request Themes
- chunk operations
- world navigation
- bookmark workflows
- overview performance
- better high-level visualization
## Triage Questions
- Is the issue specific to the overview window, or all world editing?
- Does it affect overview drawing only, or also chunk save/load behavior?
- Is the request about overview scale, navigation, or chunk manipulation?
Requests about chunk move, duplicate, rotate, delete, POIs, overview navigation, and world-scale map management should begin here.