地牢与桌面：使用 GitHub Copilot CLI 构建程序生成的 Roguelike 游戏

分享：
[](https://x.com/share?text=Dungeons%20%26amp%3B%20Desktops%3A%20Building%20a%20procedurally%20generated%20roguelike%20with%20GitHub%20Copilot%20CLI&url=https%3A%2F%2Fgithub.blog%2Fai-and-ml%2Fgithub-copilot%2Fdungeons-desktops-building-a-procedurally-generated-roguelike-with-github-copilot-cli%2F)
[](https://www.facebook.com/sharer/sharer.php?t=Dungeons%20%26amp%3B%20Desktops%3A%20Building%20a%20procedurally%20generated%20roguelike%20with%20GitHub%20Copilot%20CLI&u=https%3A%2F%2Fgithub.blog%2Fai-and-ml%2Fgithub-copilot%2Fdungeons-desktops-building-a-procedurally-generated-roguelike-with-github-copilot-cli%2F)
[](https://www.linkedin.com/shareArticle?title=Dungeons%20%26amp%3B%20Desktops%3A%20Building%20a%20procedurally%20generated%20roguelike%20with%20GitHub%20Copilot%20CLI&url=https%3A%2F%2Fgithub.blog%2Fai-and-ml%2Fgithub-copilot%2Fdungeons-desktops-building-a-procedurally-generated-roguelike-with-github-copilot-cli%2F)

我被 GitHub Copilot CLI 挑战赛吸引住了，并做出了一个不太明智的决定：我把我的代码库变成了一个 Rogue 游戏的地牢。

这一切始于一个简单的提示：用 Go 语言构建一个 GitHub CLI 扩展，将当前仓库转换成一个可玩的 Rogue 游戏地牢，地牢由 BSP [省略] 生成。然后就是 /yolo。

结果就是 GitHub Dungeons，一个从你的代码库生成地牢的终端游戏。房间、走廊和敌人，全部由你的仓库构建并在终端中渲染。你可以用方向键导航，与错误战斗，寻找出口。每个仓库都会生成不同的地图。每次提交都会重塑布局。如果你的 HP 归零，你就重新开始。

💡 趣味事实：/yolo（“你只有一次生命”）是一个 Copilot CLI 命令（/allow-all 的别名）。很贴切，因为 Rogue 游戏的核心是永久死亡。你真的只有一次生命。

Rogue 游戏可以追溯到 1980 年代的游戏，如《Rogue》——基于终端的冒险游戏，每次运行都会生成一个新的地牢，死亡意味着重新开始。

这种程序生成、永久死亡和基于文本的界面（后来在“柏林解释”等概念中正式化）的结合使这一类型感觉出奇地现代，非常适合命令行。

GitHub Dungeons 遵循这一传统。它用 Go 语言编写，虽然我通常不使用 Go，但与 Copilot 合作意味着我可以专注于行为而不是语法。

什么是程序生成？

程序生成（或“procgen”，酷孩子这么叫）是一种通过算法而不是手动设计来创建内容的方法。在游戏中，这通常意味着关卡、地图、敌人或物品是在运行时根据一组规则加上一些随机性生成的。

所以你不是设计一个地牢，而是设计一个生成多个地牢的系统。

这就是 Rogue 游戏具有可重玩性的原因：

每次运行都不同
布局每次都会变化
某些东西
某些东西

在 GitHub Dungeons 中，这个系统与你的仓库绑定在一起。布局由你的最新提交种子生成，因此相同的代码会产生相同地牢，而每次更改都会重塑它。

那么，仓库是如何实际变成地牢的呢？

从高层次来看，GitHub Dungeon 的布局是使用二进制空间分割（BSP）生成的，种子是你仓库的最新提交 SHA（稍后详细讨论 BSP）。这意味着相同的代码库会产生一致的布局，同时随着代码的变化而演变。

实际上：

相同的提交总是生成相同的地图
不同的仓库会产生结构上不同的布局
随着代码的变化，地牢也随之演变

这是程序生成——但直接与你的代码库绑定。这就是想法。

有趣的部分实际上是构建它。

使用 Copilot CLI 构建

使用 GitHub Copilot CLI 意味着描述行为而不是从头开始编写所有内容。一个特别有用的命令是 /delegate。与其只是内联生成代码，/delegate 将任务交给在云端运行的 GitHub Copilot 编码代理。

我可以用简单的英语描述我想要的内容，启动它，然后去做其他事情，让它独立工作。完成后，它会打开一个包含结果的拉取请求。

例如，/delegate 让每个关卡逐渐变得更难，比如在第二关会有更多的敌人，但也会有更多的生命药水。

Copilot 异步生成了一个不错的初步版本，我从那里开始审查并调整 PR，直到平衡感觉合适。对于其他功能，如添加让玩家无敌的作弊码（为什么不呢），我也采用了同样的方法。

我还让 Copilot 生成了一个“地牢书记官”代理，这是一个小助手，用于添加文档和 ASCII 艺术图，以解释地牢是如何生成的，这非常符合终端 roguelike 游戏的风格。

使用 Copilot（特别是使用 /delegate）就像拥有一支 NPC 军队，可以随时做我想让他们做的事情。
Lee Reilly，地牢大师

采用这种方式（描述功能，委托给 Copilot，并审查生成的拉取请求）意味着我可以花更少的时间处理边缘情况和样板代码，而更多时间关注玩家体验，包括添加彩蛋供玩家发现。与 Copilot 迭代让我能够保持游戏设计思维，而不是不断切换到实现细节。因为 Copilot 处理了大部分构建和脚手架工作，我可以专注于设计机制、测试想法，并找出真正使游戏有趣的地方。

程序生成的关卡（使用 BSP）

每个地牢设计的核心是一种称为二叉空间分割 (BSP) 的技术，如果你想要在朋友和同事面前炫耀，可以在提到中间压缩时顺便提一下这个技术。它听起来很复杂，但其实概念非常简单：不断地将一个空间分成更小的部分，直到你得到一堆可以连接的房间。

为什么 BSP 对 roguelike 游戏如此有效

Roguelike 游戏需要的地图要：

结构化（不是完全随机的胡言乱语）
可重复玩（每次运行都不同）
易于导航（没有死胡同或不可能的布局）

BSP 正好满足这些需求。它给你：

干净的矩形房间
保证连通性
足够的随机性，感觉自然

以下是它的运作方式……

#### 1. 从一个大空旷的空间开始

一切从一个大矩形开始：你的整个地牢。

#### 2. 递归分割

我们将空间分成两个区域。

然后再次分割这些区域。

再继续分割。

每次分割可以是水平的或垂直的。

#### 3. 当空间太小时停止

我们一直分割，直到区域太小无法容纳一个房间。

这会创建许多“叶”区域，即最终的构建块。

#### 4. 将每个区域变成一个房间

每个叶区域变成一个房间，但不是完美对齐的。我们会稍微随机化大小和位置。

这种轻微的随机性避免了一切看起来过于网格化。

#### 5. 用走廊连接房间

现在我们通过回溯树并连接兄弟节点来连接房间。

图片 15: 显示房间 1 和 2 分离的截图。图片 16: 显示房间 1 和 2 连接的截图。每个连接都是 L 形的：

#### 6. 最终结果：有结构的混乱

将所有这些放在一起，你会得到类似这样的结果：

房间感觉是有意为之的
走廊使所有地方都可达
每次运行都不同（但可以通过种子复现）

为什么这种方法效果很好

我喜欢 BSP 的一点是，它感觉像是经过设计的，即使实际上并没有。

它避免了程序生成的两大问题：纯粹的随机性（杂乱无章）和刚性的网格（可预测且无聊）。相反，你得到了介于两者之间的东西……有时甚至非常美丽。

如何安装和玩游戏

如果你想看看自己的代码库作为地牢的样子，并且你已经安装了 GitHub Copilot CLI，你可以运行：

gh extension install leereilly/gh-dungeons

之后，运行 gh dungeons 将你的仓库转换成一个自定义地牢，准备好被征服。使用 WASD、箭头键或 Vim 键控制你的英雄。

你的目标是在五个关卡中找到隐藏的门并逃脱（或攻击！）敌人。我添加了一些有趣的特性，比如限制视野的战争迷雾、自动攻击、追踪击杀数和征服关卡等统计数据，还有更多需要你自己去发现的内容。

危险区域！

如果你喜欢冒险，可以尝试疯狂模式：你可以设置一个预提交钩子，除非你通关整个游戏，否则它会删除你保存的更改。

⚠️ 警告：除非你完全理解这将对你的仓库产生什么影响，否则不要这样做，你会丢失已保存的工作，甚至可能失去一些理智。

code

# 创建预提交钩子 
cat > .git/hooks/pre-commit << 'EOF' 
#!/bin/bash 
gh dungeons 
if [ $? -ne 0 ]; then 
    echo "你死了！你的更改已被存入虚无之中..." 
    git stash && git stash drop stash@{0} 
    exit 1 
fi 
EOF 
 
# 使其可执行 
chmod +x .git/hooks/pre-commit 
 
# 请注意，如果你启用此功能并未能通关地牢，你将丢失所有未提交的更改，冒险者。

（编辑注：请，请，千万不要这样做。我们不对任何丢失的工作负责。但李绝对要负责。）

带走这些

这最初只是一个临时实验，但它改变了我对 GitHub Copilot CLI 的看法。

我能够快速完成最小可行产品，迭代重要的部分，并让 Copilot 处理繁重的工作，例如 BSP 生成，甚至在 Yendor 的一个略显诡异的 YAML 文件中定义怪物和移动。

* *

作者

[Lee Reilly](https://github.blog/author/leereilly/)

@leereilly

GitHub 开发者关系高级项目经理。开源狂热者，AI 专家，黑客马拉松和游戏开发比赛组织者。我编写 && 管理项目，支持开发者社区，偶尔还会发布一些东西。

更多关于 [游戏](https://github.blog/tag/gaming/)

[Game Bytes · 2023年9月](https://github.blog/open-source/gaming/game-bytes/)

Game Bytes 是我们的月度系列，带你一窥 GitHub 上的游戏开发世界——包括游戏引擎更新、游戏开发比赛详情、开源游戏、模组、地图等。尽情游戏吧！

[Lee Reilly](https://github.blog/author/leereilly/ "Lee Reilly 的文章")

探索更多来自 GitHub

文档

掌握 GitHub 所需的一切，尽在一个地方。

前往文档

GitHub

在 GitHub 上构建下一个项目，这里是来自世界各地的任何人都可以构建任何东西的地方。

开始构建

客户故事

了解使用 GitHub 构建的公司和工程团队。

了解更多

GitHub 播客

收听 GitHub 播客，一档专注于 GitHub 开源开发者社区的话题、趋势、故事和文化的节目。

立即收听

我们也发送新闻通讯

在我们的双周刊新闻通讯中发现技巧、技术指南和最佳实践，专为开发者打造。

您的电子邮件地址

*您的电子邮件地址

[x] 是的，请允许 GitHub 及其关联公司使用我的信息进行个性化沟通、定向广告和活动效果评估。详情请参阅 GitHub 隐私声明。

全站链接

[](https://github.com/)

产品

平台

支持

公司

条款
隐私
管理 Cookie
不分享我的个人信息

地牢与桌面：使用 GitHub Copilot CLI 构建程序生成的 Roguelike 游戏

TL;DR · AI 摘要

核心要点

结构提纲

思维导图

金句 / Highlights

地牢与桌面：使用 GitHub Copilot CLI 构建过程生成的 Roguelike 游戏 - GitHub 博客

分类

地牢与桌面：使用 GitHub Copilot CLI 构建过程生成的 Rogue 游戏