DungeonTemplateLibrary

用 C++ 快速生成多样地下城地图，省去手动设计关卡

DungeonTemplateLibrary 是一个用 C++ 实现的 dungeon 生成模板库，专注于地形和 roguelike 地图的随机生成。它解决了游戏开发中手动设计大量关卡耗时且重复的问题，提供了一套可复用的算法和模板，帮助开发者快速生成多样化的地下城、洞穴、房间等地图结构。核心能力包括多种生成算法（如 BSP、随机游走、细胞自动机等）、灵活的参数配置、以及输出格式的可定制性。该库以模板编程为主，性能高效，适合集成到游戏引擎或独立游戏项目中。

开源 free 设计创意

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1463

维护状态低维护

是否开源是

定价模式 free

项目数据

分类设计创意

开发团队AsPJT

所属国家

官网地址

GitHubhttps://github.com/AsPJT/DungeonTemplateLibrary

定价模式free

价格说明开源项目，基于BSL-1.0许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议BSL-1.0

主要语言C++

技术栈/模型3d-graphics,creative-coding,fractal,generative-art,godot,graphics-programming,procedural,procedural-generation,roguelike,simulator,terrain,ue4,ue5,unity,unity3d,unreal-engine,unreal-engine-4,virtual-reality,voxel,vr

GitHub 星标★ 1463

30天Star增速

HF 下载量

上线时间2018-12-14 00:00:00

最近更新2026-09-20 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：进阶约 10 分钟部署方式：库/依赖 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

支持 C++11/14/17 的编译器（README 标注 C++11/14/17）
安装 Git，用于克隆仓库
准备 CMake（README 的 Quick Start 标题为 CMake）
如需免编译体验，可使用 Windows 或 Android 设备运行官方 Image Viewer

安装与启动步骤

1克隆仓库

README 的 Quick Start 第一步，把 DTL 源码克隆到本地。注意仓库体积，可用 --depth 1 加速。
```
git clone https://github.com/AsPJT/DungeonTemplateLibrary.git
```
2进入项目目录

切换到刚克隆下来的目录，后续在仓库内查看头文件、示例与文档。
```
cd DungeonTemplateLibrary/
```
3下载官方 SDK

README 的 SDK Downloads 指向 Releases 页面，不想自行构建时可在此下载预编译 SDK。
4在线试用 Web Trial

README 提供 Web Trial 链接（在项目 Wiki 中），可在浏览器里直接预览生成效果，无需本地环境。
5下载图像查看器

README 提供 Windows(.exe) 与 Android(.apk) 版 Image Viewer，用于打开并查看生成的地图结果。
6查阅 API 参考

全部算法与参数说明在项目 Wiki 的 API reference 页面，集成到自己的 C++ 项目时以此为准。

如何确认成功

README 未给出构建后的验证命令；可下载 Image Viewer 打开生成结果，或通过 Web Trial 在线确认效果。

常见问题

Q：不想编译，能直接体验吗？

A：可以。README 提供了 Web Trial 在线试用链接，以及 Windows/Android 版 Image Viewer，无需本地编译即可查看生成的地图。

Q：支持哪些 C++ 标准？

A：README 标注版本 0.4.14 支持 C++11/14/17，编译器需兼容这三个标准之一。

Q：怎么拿到免编译的 SDK？

A：README 的 SDK Downloads 链接指向 GitHub Releases 页面，可在其中下载官方发布的 SDK 包。

Q：能在游戏引擎里用吗？

A：README 列出了 Unreal Engine 4 Viewer 的下载，说明可与 UE4 配合查看；其他引擎可按库方式集成。

注意事项

README 只给出了 git clone 与 cd 两条命令，Quick Start (CMake) 的完整构建命令在节选中被截断，实际构建方式请以仓库内说明为准。
本项目是 C++ 模板库，主要作为依赖集成进游戏项目，不是可直接运行的服务。
许可证为 BSL-1.0，商用前请确认授权条款。
当前版本为 0.4.14，功能与下载链接可能随版本变化。

核心亮点

内置多种生成算法（BSP、随机游走等），可灵活组合出不同风格的地图
纯模板头文件库，无需编译，直接包含即可使用，集成成本低
参数高度可调，支持自定义地形规则和输出格式，适应多种游戏类型

不足之处

文档相对简略，新手上手需要阅读源码示例
模板元编程对编译速度有一定影响，大型项目可能编译变慢

适用场景

开发 roguelike 游戏时快速生成随机关卡
在游戏引擎（如 Unity/Unreal）中集成 C++ 地图生成逻辑
用于程序化内容生成（PCG）的实验和学习

替代项目

TinyKeep、Dungeon Architect、RogueSharp

项目介绍

DungeonTemplateLibrary 是设计创意领域的开源项目，由 AsPJT 开发，2018 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,463）位列前 30%，在设计创意分类的 163 个项目里位列前 15%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-20。基于BSL-1.0许可证，完全免费，无付费版本。

它主要面向的使用场景是：开发roguelike游戏时快速生成随机关卡。同类可对比的替代方案包括 TinyKeep、Dungeon Architect、RogueSharp。

上一篇：PEmbroider

下一篇：liquid-logo