How rustamnsu/shcde-map-editor works
SHC DE Map Editor is a portable desktop editor for Stronghold Crusader: Definitive Edition maps and saves. Users create or open a map, edit cells and entities through map tools, inspect and validate the result, then save a map or export a save as a map. Its backend models map geometry and semantics, applies transactional edits, and preserves binary sections. The README documents additional mask, symmetry, selection, clipboard, and castle-area capabilities. Research modules analyze reference maps and saves; only sampled relationships are shown.
Main entry points: gui.py Desktop window · document.py Map document · cli.py Command line · preview.py Map preview
Components 23
Editor Interface
- Desktop window
editor/gui.py - Tool panels
editor/panels.py - Mask editor
editor/mask_editor.py - Command line
editor/cli.py
Map Editing
- Terrain, height, variation
editor/services.py - Building placement
editor/buildings.py - Vegetation placement
editor/trees.py - Map clipboard
editor/clipboard.py - Map rendering
editor/render.py - Map preview
editor/preview.py - Castle markers
editor/menu.py
Map Backend
- Map document
editor/document.py - Map geometry
editor/geometry.py - Map container I/O
maptool.py - Map semantics
semantics.py
User Data
- Mask library
editor/patterns.py - Editor settings
editor/settings.py - Recent maps
editor/recent.py - Editor state
editor/state.py
Map Research
- Reference map analysis
research/analyze_references.py - Save analysis
research/analyze_savegame.py - Reference findings
research/reference_findings.py
Other components
- Map editor user
Connections 38
- Map editor user → Desktop window: uses
README.md - Desktop window → Map document: edits
editor/gui.py - Desktop window → Tool panels: displays
editor/gui.py - Desktop window → Mask editor: opens
editor/gui.py - Desktop window → Editor settings: loads
editor/gui.py - Desktop window → Recent maps: tracks
editor/gui.py - Desktop window → Editor state: restores
editor/gui.py - Desktop window → Map clipboard: uses
editor/gui.py - Desktop window → Map rendering: renders
editor/gui.py - Desktop window → Terrain, height, variation: uses
editor/gui.py - Desktop window → Building placement: places
editor/gui.py - Desktop window → Vegetation placement: places
editor/gui.py - Desktop window → Map preview: previews
- Desktop window → Command line: offers
- Map document → Map container I/O: reads and writes
editor/document.py - Map document → Map geometry: uses
editor/document.py - Terrain, height, variation → Map document: patches
editor/services.py - Building placement → Map document: patches
editor/buildings.py - Building placement → Map semantics: uses layouts
editor/buildings.py - Vegetation placement → Map document: patches
editor/trees.py - Map clipboard → Map document: copies map data
editor/clipboard.py - Mask editor → Mask library: edits masks
editor/mask_editor.py - Desktop window → Mask library: loads masks
editor/gui.py - Tool panels → Mask library: selects masks
editor/panels.py - Map preview → Map rendering: renders map
editor/preview.py - Map preview → Terrain, height, variation: reads entities
editor/preview.py - Map preview → Castle markers: gets markers
editor/preview.py - Desktop window → Castle markers: uses
- Command line → Terrain, height, variation: uses services
editor/cli.py - Command line → Building placement: uses
editor/cli.py - Command line → Vegetation placement: uses
editor/cli.py - Reference map analysis → Map container I/O: reads maps
research/analyze_references.py - Reference map analysis → Map semantics: interprets
research/analyze_references.py - Save analysis → Map container I/O: reads saves
research/analyze_savegame.py - Save analysis → Map semantics: interprets
research/analyze_savegame.py - Reference findings → Reference map analysis: uses analysis
research/reference_findings.py - Reference findings → Map container I/O: reads maps
research/reference_findings.py - Reference findings → Map semantics: interprets
research/reference_findings.py