xianxia-AI-town部署指南:如何快速把修仙AI小镇发布为在线可玩的静态站点

原创2026-10-12 16:12:261,387 阅读

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(免费)

  1. 在 GitHub 新建一个仓库,把整个项目(index.html 和 js/ 目录)推入仓库根目录;
  2. 进入仓库 Settings → Pages,Source 选择 main 分支、根目录 /;
  3. 保存后约 1 分钟,https://<用户名>.github.io/<仓库名>/ 即为可玩地址。

注意:千万不要把文件放到 docs/ 子目录之外的深层目录里再改 Pages 路径,保持「仓库根 = Web 根」是最简单的做法。

方案 B:Netlify / Cloudflare Pages(拖拽即可)

  1. 注册并登录 Netlify(或 Cloudflare Pages);
  2. 选择「Deploys」→ 用鼠标把整个项目文件夹拖进上传框;
  3. 几秒后自动分配一个 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 与玩家在同一规则下共同生活。🎮

登录后查看全文
xianxia-AI-town-AI-