Home

WebGL 幻想地图生成器

WebGL 幻想地图生成器是一款从头实现的 WebGL2 幻想世界地图工具。它参考 Fantasy Map Generator 的生成流程、数据结构和地图表达，但正式应用、编辑器、存档与 API 均属于本项目自己的实现。

图：主界面显示地图画布，以及控制面板、适配视图、测量和工具栏收起入口。

可以用它做什么

• 从种子、地图规模、画布尺寸、地形模板和气候参数生成一张完整世界地图。
• 用高度、温度、降水、生物群系、文化、宗教、外交、政体、国家、省份、地区和人口等专题观察同一份地图数据。
• 管理地形、水体、河流、湖泊、洋流、国家、省份、城市、文化、宗教、道路、经济、外交、军事、地区、标记、标签、备注和测量对象。
• 通过选择、定位、高亮、预检、确认、撤销和重做完成可追踪的编辑；对重新生成对象使用锁定保护。
• 保存完整地图，在浏览器中保留临时存档，或导出图片、高度灰度图、GeoJSON、备注和测量数据。
• 通过浏览器 API、无头运行时和当前标签页受控桥进行分析与自动化，同时保留确认、版本检查和事务边界。

建议阅读顺序

1. 安装与快速开始：启动项目并完成第一次生成、查看和保存。
2. 界面与基础操作：认识地图画布、工具栏、浮动面板、对象详情和编辑历史。
3. 地图生成与项目设置：理解地图名称、种子、规模、地形模板和高级气候设置。
4. 专题图层与视觉样式：切换专题、图层、主题、标签样式和显示单位。
5. 功能与领域总览：按自然、人文、网络经济和标注对象找到具体管理面板。

按领域直达

• 地形、水体与水文：高度、海岸、水体、河流、湖泊和洋流。
• 气候、生态与人口：气候统计、生物群系、适居度与人口事务。
• 政治、社会与聚落：国家、省份、城市、政体、文化和宗教。
• 路线、经济、外交与军事：交通、市场、交易、国家关系与军团。
• 地区、标注与测量：地区、资源与标记、标签、备注、测量和名称库。

需要继续深入时，可阅读：地图数据与区域分析、编辑器与安全修改、存档与导入导出、API与自动化、旧图兼容和故障排查。

文档状态

Wiki 的可追踪源稿位于主仓库 docs/wiki/，当前对应 API 1.0.0 和地图文档 v2。远端页面由仓库内 publish:wiki 流程从这些源稿重复发布，不在网页端维护第二份独立正文。项目活动任务与完成状态只以主仓库 docs/current-plan.md 为准。