WebGL 幻想地图生成器适合世界构建、TRPG 主持、架空历史创作，也适合单纯喜欢地图的人。项目借鉴 Fantasy Map Generator 生成和呈现世界的思路与视觉风格，应用本身从头独立开发。打开页面即可生成一幅完整地图，之后还可以继续查看、推演和修改其中的世界。
在线体验 · 中文 Wiki · 开发故事 · 快速开始 · 文档导览
| 自然地貌 | 国家视角 |
|---|---|
 |
 |
新地图先确定自然环境。陆地与海洋构成轮廓，气候、水文和地貌再影响河流与生物群系的分布。生成时不必预先规定每个细节。完成后，专题视图可以帮助了解这些要素之间的关系。
随后加入人文内容。聚落多出现在适居之地，道路把它们连接起来。国家和省份划出行政范围，文化与宗教形成各自的分布，经济、贸易、外交和军事则呈现各方如何往来与冲突。这些内容会互相牵动，查看或调整时可以放在一起比较。
完整介绍见功能与领域总览。
生成完成后，可以在地图和管理界面之间切换，查看专题信息，选中并定位地点或对象，再按需要调整局部内容。编辑操作有明确的作用范围。常用修改会进入撤销与重做历史；可能牵动其它内容的操作会先列出影响和确认条件，明确锁定的对象也会得到保护。
需要暂停工作或保留一个版本时，可以保存完整地图，日后接着编辑；也可以根据用途导出图片、地理数据或其它结果。旧地图有版本化迁移和兼容路径，但历史文件不保证全部无损转换。重要存档应保留原件，迁移后另存新版。编辑原则和格式细节分别见编辑器与安全修改、存档与导入导出和旧图兼容。
项目也支持用脚本或 AI 工具处理地图，并提供了几种受控入口。页面内的 window.webglGeneratorApi 可读取地图、查找对象、进行分析和调用受控编辑。处理本地存档时，无头只读入口无需打开浏览器，适合批量查询和区域分析；确需修改文件时，独立的无头写入入口只开放经过约束的动作，并默认写入新文件，保留原存档。
AI 操作当前标签页前，须由用户在页面中明确开启受控桥。该桥默认只读，授权状态始终可见。高影响修改仍需经过预检、显式确认、版本检查和事务回滚，受控桥不提供任意脚本执行，也不能绕过地图自身的编辑规则。
README 只说明各入口的用途。精确方法、输入格式和安全边界见 API 与自动化；让 AI 接手地图的步骤见 AI 接手入口。
从 SVG 性能基线、WebGL2 原型到独立生成器、旧图兼容和受控 AI API，项目的开发方法、阶段历程与主要困难整理在《我用 AI 从零开发了一款 WebGL 幻想地图生成器》中。文章也记录了真实浏览器验收、海岸拓扑、画布性能以及桌面打包试验背后的取舍。
本地开发需要 Node.js ^20.19.0 或 >=22.12.0、pnpm 10，以及支持 WebGL2 的现代浏览器。
pnpm install
pnpm run dev开发服务默认运行在 http://127.0.0.1:5410。需要生产构建时，运行：
pnpm run build完整步骤见安装与快速开始。不想在本地安装，也可以直接打开在线版本。
| 要做的事 | 相关文档 |
|---|---|
| 本地安装并生成第一张地图 | 安装与快速开始 |
| 了解自然、人文和地图表达 | 功能与领域总览 |
| 选择、修改和保护地图对象 | 编辑器与安全修改 |
| 保存地图或选择导出格式 | 存档与导入导出 |
| 使用脚本、无头流程或当前标签页桥 | API 与自动化 |
| 打开旧地图并了解迁移边界 | 旧图兼容 |
| 让 AI 分析或安全修改地图 | AI 接手入口 |
| 查看或维护独立实验室 / 原型 | 独立实验室与原型说明 |
| 查看当前唯一有效的任务范围 | 权威任务清单 |
| 追溯重要决定和验收结果 | 开发日志 |
以上链接均指向仓库内维护的文档源稿；面向普通用户的版本也已发布到项目 GitHub Wiki。仓库内 docs/wiki/ 继续作为可追踪、可审计和可重复发布的唯一源稿。
正式应用已经过了早期占位原型阶段，目前仍在持续开发，尚未作为稳定版本发布。功能、界面和存档约定仍可能调整。当前开发范围只以权威任务清单为准，README 和专题文档中的想法不会自动成为待办。
仓库中的 source/Fantasy-Map-Generator 只用于参照原项目的行为与表现。本项目独立于原项目，不属于其修改版或官方继任版本，参考源码保持原样。
项目作者为 mosuzi。当前应用的代码 100% 由 Codex + GPT 实现，文档也由 Codex + GPT 编写。
感谢 Max Haniyeu（Azgaar）和参与维护 Fantasy Map Generator 的社区。本项目的许多生成思路和视觉参考来自他们的工作。原项目的版权与许可证以其仓库声明为准。
本项目采用 MIT License。