MapStage README

The project's README from github.com/hopechen067/MapStage. As one markdown file: README.md.

MapStage

English | 中文

Open-source MapStage tuner: map and globe projection, satellite, hypsometric relief, 3D terrain, region isolate, and JSON presets.

Live demo

→ https://hopechen067.github.io/MapStage/
Interactive tuner (EOX satellite + Mapterhorn DEM need internet. No install.)

What's new

Showcases

Current tuner: national map, 3D terrain, globe, isolate.

Tuner national map view
Tuner · national view (map)
Tuner 3D terrain
Tuner · 3D terrain
Tuner globe projection
Tuner · globe
Tuner isolate China terrain island
Tuner · isolate
Item Value
Skill folder mapstage
Runtime MapStage
Default basemap EOX Sentinel-2 cloudless (public demo WMTS; check provider terms)
Terrain / hillshade Mapterhorn DEM (runtime fetch; Terrarium encoding)
Water OpenFreeMap / OpenMapTiles vector water
Look CSS color grade, map/globe, isolate island, HanCity3D settlements
License MIT for code/docs; showcase media & third-party terms in LICENSE-EXCEPTIONS.md / NOTICE.md
Hosted demo Live demo — Pages publishes mapstage/tuner to the site root

Quick pull (install)

git clone pulls the whole repository, not a standalone skill.
You get README, showcases, the tuner, and the mapstage/ skill folder. Agents do not auto-discover that folder from a clone. Copy mapstage/ into your skills directory (step 2) if you want the agent skill.

1) Clone the repo

git clone https://github.com/hopechen067/MapStage.git
cd MapStage

Update later:

cd MapStage
git pull

2) Install as an agent skill

Skill folder (browse, not a second clone): mapstage/

One command — installs only that folder:

npx skills add hopechen067/MapStage --skill mapstage -g

GitHub CLI 2.90+:

gh skill install hopechen067/MapStage mapstage --scope user

Then reload skills. On Windows, add --copy to the npx command if symlink creation fails.

Or after a full clone, copy mapstage/ into your agent's skills directory.

3) Paste this to your agent

请使用 MapStage skill。
在线调参:https://hopechen067.github.io/MapStage/
仓库:https://github.com/hopechen067/MapStage
我会在 demo 里调好风格后导出 JSON,请按 SKILL.md / references 应用到地图场景(jumpTo + idle,encoding terrarium)。

Style workflow: open the live demo → tune → Copy JSON → paste to your agent.

Quick start (local tuner)

The live demo already runs on GitHub Pages. You do not start a server on your computer to use it.

Only if you want to edit files or preview offline do you start the tuner locally. Run the command on your machine; when it is up, open the local URL printed in the terminal (do not use file://).

cd mapstage/tuner

# Option A — Python 3
python -m http.server

# Option B — Node
npx --yes serve

Optional check (Node on PATH):

cd mapstage/tuner
node verify.mjs

Features

Configure map tiles

  1. Read NOTICE.md.
  2. Defaults: tuner/map-tiles.config.js (EOX + Mapterhorn).
  3. Personal endpoints: map-tiles.config.local.js (gitignored). See map-tiles.config.example.js.

EOX public tiles are typically non-commercial with attribution (~10 m). This project does not grant rights to any commercial map vendor.

Tiles are not bundled

Satellite and DEM tiles are fetched at runtime from configured URLs only.

Attribution & compliance

Install as an agent skill

The GitHub repo is the full project. The skill is only mapstage/.

  1. Install with npx skills add hopechen067/MapStage --skill mapstage -g, or gh skill install hopechen067/MapStage mapstage --scope user, or copy mapstage/ into your agent's skills directory.
  2. Reload agent skills so SKILL.md is discovered.
  3. Ask the agent to open the tuner, apply an exported JSON preset (version 3), or wire the same look into a MapStage scene.

Layout

.
├── LICENSE
├── LICENSE-EXCEPTIONS.md      # showcase / third-party / user geodata (not MIT)
├── NOTICE.md
├── DATA-PROVENANCE.md
├── SECURITY.md
├── README.md / README.zh-CN.md
├── showcases/                 # README images & sample frames
└── mapstage/
    ├── SKILL.md
    ├── agents/openai.yaml
    ├── references/
    ├── schemas/
    └── tuner/                 # published to GitHub Pages site root

Contributing / security

Next reads

MapStage (hopechen067/MapStage)

Searching Database…

Что это такое?MapStage — open-source живой тюнер для карт и глобусов: вы настраиваете спутниковые снимки, гипсометрический рельеф, 3D-рельеф и эффекты изоляции региона, затем экспортируете вид как JSON-пресет. Он также поставляется как устанавливаемый «agent skill», чтобы ИИ-кодинг-агенты могли управлять тем же тюнером.
Это веб-приложение для браузера или то, что устанавливается как agent skill?И то, и другое — есть живое демо на GitHub Pages, которым можно пользоваться напрямую без установки, а в репозитории также есть папка «mapstage/», которую можно отдельно установить как навык для ИИ-кодинг-агентов.
Как начать работать с тюнером?Просто откройте живое демо и используйте «Copy JSON» для экспорта пресета — установка не нужна. Для редактирования или офлайн-запуска склонируйте репозиторий, выполните команду локального тюнера и откройте локальный URL, выведенный в терминале (не file://).
Нужен ли интернет, чтобы видеть спутниковые снимки и рельеф?Да — базовая спутниковая подложка EOX Sentinel-2 и рельеф/отмывка Mapterhorn DEM подгружаются во время работы с внешних серверов и не входят в комплект проекта.
Можно ли использовать спутниковые тайлы по умолчанию в коммерческих целях?По умолчанию нет — тайлы EOX обычно некоммерческие с обязательным указанием авторства, и проект не даёт прав ни на одного коммерческого поставщика карт; можно подставить собственный лицензированный URL тайлов через локальный конфиг, игнорируемый git.
Можно ли использовать свои картографические тайлы вместо спутниковых снимков по умолчанию?Да — создайте map-tiles.config.local.js (в gitignore), указывающий на любой URL тайлов, право использовать которые у вас есть; он переопределит базовую подложку EOX Sentinel-2 cloudless по умолчанию.
Что делает «region isolate»?Это опциональный режим, который выделяет выбранный регион из окружающей карты, превращая его в отдельный остров 3D-рельефа.
Что за функция «city tiers»?HanCity3D отрисовывает поселения по уровням — столица, крупные, средние, малые, pass, station и ordos, — позволяя управлять тем, какие города и маркеры появляются при зуме.
Можно ли сохранить и переиспользовать вид, созданный в тюнере?Да — кнопка «Copy JSON» экспортирует версионированный пресет, включающий положение камеры и переключатели ресурсов, который можно вставить обратно в тюнер или передать агенту.
Size
35 MB
Stars
478
Updated
CommitSep 13
Age
2mo
Commits · 90 Days