xianxia-AI-town部署指南:如何快速把修仙AI小镇发布为在线可玩的静态站点
xianxia-AI-town部署指南:如何快速把修仙AI小镇发布为在线可玩的静态站点
xianxia-AI-town-AI-(修仙AI小镇)是一款大模型驱动 NPC 决策、NPC 与玩家平权的修仙模拟游戏。它由 index.html、纯 JavaScript 模块和 CSS 组成,没有构建步骤,因此可以免费部署到任意静态托管平台,几分钟内生成一个在线可玩的链接。本文带你从零完成本地预览与在线发布。
为什么可以一键发布为静态站点?
先看懂项目结构,你就明白为什么它适合静态部署:
| 目录/文件 | 作用 |
|---|---|
| index.html | 游戏入口,内含全部 UI 与主控制器 Game |
| js/engine/core.js | 物理与核心引擎(基于 Matter.js) |
| js/engine/renderer.js | Canvas 渲染与相机 |
| js/engine/state.js | 全局游戏状态 |
| js/systems/ | 战斗、修炼、建造、门派、天气等 12 个系统模块 |
| GAME_GUIDE.md | 游戏指南与攻略(可随站托管) |
关键点只有一个:index.html 通过 <script src> 按顺序加载 js/engine 和 js/systems 下的模块,模块加载顺序即依赖顺序(完整依赖关系可参考 DEPENDENCY_MATRIX.md)。所以发布时只需保证整个目录的相对路径不被破坏,不需要 npm install、不需要打包。
⚠️ 注意:
index.html第 7 行从 CDN 引入 Matter.js(matter.min.js)。因此玩家访问你的在线站点时,其浏览器需要能访问该 CDN,否则页面会白屏。
第一步:获取代码
克隆仓库到你的本地机器:
git clone https://gitcode.com/gh_mirrors/xi/xianxia-AI-town-AI-
cd xianxia-AI-town-AI-
克隆完成后,目录顶层就是上面表格中列出的文件,没有任何需要额外安装的东西。
第二步:本地启动静态服务器(推荐 2 种方式)
直接双击 index.html 用 file:// 协议打开也能运行,但更规范的方式是起一个本地 HTTP 服务,行为与线上环境一致。
方式一:Python 一键启动(最快)
只要有 Python 3,在项目根目录执行:
python3 -m http.server 8000
然后浏览器访问 http://localhost:8000,看到游戏画面即部署成功。
方式二:Node.js 的 npx 服务
如果你更习惯 Node 环境:
npx serve .
按提示打开本地地址即可。两种方式的本质相同:把项目根目录作为 Web 根目录向外提供静态文件。
验证清单
打开页面后建议检查以下几点,对应「世界信息」面板与各系统是否正常初始化:
- 左上角「角色状态」面板出现生命、灵力、体力、免疫四条状态条;
- 右上角「操作菜单」点击「建造 (B)」「修炼 (X)」能正常弹出面板;
- 按
E键可与 NPC 对话(验证 js/systems/dialog.js 加载成功); - 浏览器控制台(F12)无红色 404 报错,说明
js/engine与js/systems全部加载成功。
第三步:发布为在线静态站点
方案 A:GitHub Pages(免费)
- 在 GitHub 新建一个仓库,把整个项目(
index.html和js/目录)推入仓库根目录; - 进入仓库 Settings → Pages,Source 选择
main分支、根目录/; - 保存后约 1 分钟,
https://<用户名>.github.io/<仓库名>/即为可玩地址。
注意:千万不要把文件放到
docs/子目录之外的深层目录里再改 Pages 路径,保持「仓库根 = Web 根」是最简单的做法。
方案 B:Netlify / Cloudflare Pages(拖拽即可)
- 注册并登录 Netlify(或 Cloudflare Pages);
- 选择「Deploys」→ 用鼠标把整个项目文件夹拖进上传框;
- 几秒后自动分配一个
https://xxxx.netlify.app域名,立即可玩。
这类平台零配置:没有 build command、没有环境版本需要填写,因为项目本身就是一个纯静态站点。
方案 C:自有服务器 + Nginx
如果你有服务器,只需要把目录整体拷过去并托管静态文件:
server {
listen 80;
server_name game.example.com;
root /var/www/xianxia-ai-town; # 项目根目录
index index.html;
}
将 index.html 与 js/ 目录同步到 root 指向的路径后 reload Nginx 即可。
常见问题排查
| 现象 | 原因与解决办法 |
|---|---|
页面空白、控制台大量 ReferenceError |
js/engine/core.js、renderer.js、state.js 未随站点上传,检查目录结构是否完整 |
| 部分面板/系统无反应 | js/systems/ 下某个模块 404,核对 DEPENDENCY_MATRIX.md 确认模块齐全 |
页面完全打不开、Matter is not defined |
CDN 上的 Matter.js 加载失败(网络受限),检查 index.html 第 7 行的 script 标签是否能访问 |
| 刷新后路径 404 | 静态托管根目录设置错误,确保 Web 根目录就是项目的最外层文件夹 |
总结
- 零构建:
index.html+js/目录即全部发布物,任何静态托管都能跑; - 两条主线:本地用
python3 -m http.server 8000快速预览,线上拖拽到 Netlify/Cloudflare Pages 或推送 GitHub Pages 即可获得可分享链接; - 唯一注意点:保持
js/engine与js/systems的相对路径和加载顺序不变,并确保访问者网络可达 Matter.js CDN。
完成以上步骤后,你就能把这款大模型驱动的修仙AI小镇分享给任何人,让 NPC 与玩家在同一规则下共同生活。🎮