如何快速上手xianxia-AI-town:5步在本地跑通修仙模拟游戏,新手入门指南
如何快速上手xianxia-AI-town:5步在本地跑通修仙模拟游戏,新手入门指南
xianxia-AI-town 是一款大模型驱动的修仙AI小镇模拟游戏:NPC 拥有与玩家平权的智能决策能力,你可以通过阿里云 Qwen 大模型与小镇居民自由对话。下面用 5 步带你在本地快速跑通这款游戏,新手也能轻松上手。
一、项目是什么:AI 驱动的修仙模拟世界
在动手之前,先花 30 秒了解一下你将体验的这个世界:
- 物理引擎驱动:基于 Matter.js 构建的 3000×2000 俯视角世界,碰撞、移动都是真实物理交互,核心实现在 js/engine/core.js
- 11 大系统联动:建造、采集、战斗、门派、天气、对话、修炼、合成、社交、生存、灵力,全部代码位于 js/systems/
- AI 智能 NPC:NPC 不再是"木头桩子",接入 Qwen 大模型后可以自由对话、接受任务、交易炼丹
- 完整修仙路线:从练气一层一路修炼到元婴初期,共 10 个境界
完整玩法详见官方指南 GAME_GUIDE.md 与 游戏攻略指南.md。
二、第 1 步:获取项目源码
打开终端,执行 clone 命令把仓库拉到本地:
git clone https://gitcode.com/gh_mirrors/xi/xianxia-AI-town-AI-
完成后进入项目目录。项目结构非常清晰,纯前端零依赖安装,无需 npm install:
| 目录/文件 | 作用 |
|---|---|
| index.html | 游戏主入口,HTML + 全部 UI 界面 |
| js/engine/ | 游戏引擎层:物理核心 core.js、渲染 renderer.js、状态 state.js |
| js/systems/ | 11 个玩法系统模块(战斗、修炼、天气等) |
| GAME_GUIDE.md | 游戏指南与新手攻略 |
三、第 2 步:一键启动本地游戏
因为项目是纯静态前端页面,启动方式有两种:
方式 A:直接双击打开(最简单)
直接双击 index.html 用浏览器打开即可游玩。注意页面会加载 Matter.js 物理库,所以需要联网。
方式 B:本地静态服务器(推荐)
在项目根目录执行:
python3 -m http.server 8080
然后浏览器访问 http://localhost:8080,体验更稳定,控制台日志也更完整。
💡 打开后你会看到左上角角色状态面板(生命/灵力/体力/免疫)、右上角功能按钮和右下角小地图,界面说明可参考 游戏攻略指南.md。
四、第 3 步:熟悉核心操作键位
移动与交互是新手最需要先掌握的,完整键位表见 GAME_GUIDE.md:
| 按键 | 功能 | 新手提示 |
|---|---|---|
| WASD / 方向键 | 移动 | 俯视角自由行走 |
| E | 交互 | 采资源、与 NPC 对话的核心键 |
| 空格 | 攻击 | 支持连击,最高 +100% 伤害 |
| B | 建造 | 营火、小屋、聚灵阵等 |
| C / X / F | 合成 / 修炼 / 门派 | 三大面板快捷键 |
| G / R | 进食 / 烹饪 | 饥饿会掉血,记得吃饭 |
五、第 4 步:配置 AI 对话(可选但强烈推荐)
想让 NPC"活"过来,需要配置大模型 API Key:
- 到阿里云 DashScope 控制台开通 Qwen 服务,创建一个 API Key
- 游戏中靠近任意 NPC,按 E 键打开对话框
- 点击「API设置」→ 粘贴你的 API Key → 保存
配置逻辑见 js/systems/dialog.js,Key 会保存在浏览器 localStorage 中,「自由对话」选项将调用 qwen-turbo 模型实时生成回复。不配置也可以玩,只是 NPC 会使用预设对话。
六、第 5 步:开始你的第一场修仙之旅
按照下面的五步路线,10 分钟即可体验完整玩法:
- 采集资源:走到树木或灵草旁按 E,攒够木材和灵草
- 建造营地:按 B 建一个营火(木材x5),旁边就能烹饪熟肉
- 加入门派:按 F 选择门派,青云门均衡、药王谷炼丹、万剑宗战斗向
- 修炼突破:去灵脉/仙山福地等灵力高浓度区域,按 X 修炼,练气二层只需 100 点修为
- 社交探索:配置好 API 后与 NPC 自由对话,触发任务与剧情
七、新手常见问题速查
- 如何保存进度? 当前版本暂不支持存档,请保持浏览器页面开启
- NPC 为什么不理我? 需先配置 Qwen API Key 才能解锁 AI 自由对话
- 资源会刷新吗? 会,采集完毕后一定时间自动重生
- 如何快速变强? 在聚灵阵附近修炼 + 青云门修炼加成 + 雷暴天气(修炼 +200%)
祝修仙愉快,早日飞升!🌟
登录后查看全文